Math Master X

A modern, interactive math learning application designed to help users master multiplication tables, squares, and cubes. Built as a high-performance hybrid mobile application using React (Vite) and Android (Kotlin).

FULLY VIBE CODED WITH v0 and gemini !

🚀 Features

• Multiplication Master: Practice specific multiplication tables with customizable ranges.
• Powers & Roots: Dedicated modes for practicing Squares and Cubes.
• Interactive Quizzes: Real-time feedback and progress tracking during practice sessions.
• Modern UI: Clean, responsive design with full Dark Mode support.
• Hybrid Performance: Web-based interface integrated into a native Android container for the best of both worlds.

🛠 Tech Stack

Frontend (Web)

• Framework: React 19 (TypeScript)
• Build Tool: Vite 6
• Styling: Tailwind CSS 4
• Components: Radix UI / Shadcn UI
• Icons: Lucide React

Mobile (Android)

• Language: Kotlin
• UI Framework: Jetpack Compose
• Engine: Android WebView (with Hardware Acceleration)

📁 Project Structure

mathx/
├── react-app/          # React frontend source code
│   ├── src/            # Components, hooks, and business logic
│   └── public/         # Static assets
└── android-app/        # Native Android wrapper
    └── app/
        └── src/
            ├── main/java/    # Kotlin source (MainActivity, WebView setup)
            └── main/assets/  # Where the built React app is hosted

🛠 Getting Started

Prerequisites

• Node.js (v18+)
• Android Studio (Ladybug or newer)
• JDK 17

Web Development

1. Navigate to the react-app directory:

   cd react-app

2. Install dependencies:

   yarn install

3. Start the development server:

   yarn dev

Building for Android

1. Build the React app as a single-file asset:

   cd react-app
   yarn build:single

2. Copy the resulting dist/index.html to the Android assets:

   cp dist/index.html ../android-app/app/src/main/assets/

3. Open the android-app folder in Android Studio.
4. Sync Gradle and run the app on an emulator or physical device.

📱 App Modes

• Multiplication: Choose a base number (e.g., 7) and a range (e.g., 1 to 20) to practice that specific table.
• Squares: Practice squares from any range (e.g., 11² to 30²).
• Cubes: Master cubes for any range (e.g., 1³ to 15³).