Skip to content

p172913/MathsGeeks_project

Repository files navigation

✨ MathsGeeks: Gemini-Inspired AI Math Tutor

MathsGeeks is a premium, AI-powered platform designed to provide students with a personalized, state-of-the-art math learning experience. Inspired by the Gemini aesthetic, the platform offers real-time problem solving, step-by-step guidance, and interactive concept visualization.

🚀 Key Features

  • Gemini-Inspired UI: A clean, modern chat interface with glassmorphism, smooth animations, and a persistence sidebar.
  • AI Math Solver: Advanced backend logic to solve complex mathematical problems with step-by-step explanations.
  • Interactive Diagrams: Automatic generation of math diagrams using Mermaid.js (Web) and WebView (Mobile).
  • Cross-Platform Parity: Seamless experience across Web (React JS) and Mobile (React Native) platforms.
  • Session Persistence: Persistent chat history stored in an H2 database via a Spring Boot backend.
  • Secure Authentication: Firebase-integrated authentication for both platforms.

📁 Project Structure

  • /frontendcodes/react-js-app: The web-based AI tutor interface.
  • /frontendcodes/react-native-project: The mobile Android/iOS tutor application.
  • /backendcodes/springbootapp: The Spring Boot 3.3.0 backend implementing AI solver logic and persistence.

🛠️ Tech Stack

  • Front-end (Web): React JS, Mermaid.js, Axios, CSS3 (Rich Aesthetics).
  • Front-end (Mobile): React Native (Expo), WebView, Native Vector Icons.
  • Back-end: Spring Boot 3.3.0, Spring Data JPA, Spring Security, Firebase Admin SDK v9.3.0.
  • Database: H2 (In-memory/Persistent).

🚦 Getting Started

Backend

  1. Navigate to /backendcodes/springbootapp.
  2. Ensure you have Java 17+ and Maven installed.
  3. Run: ./mvnw clean install
  4. Run: ./mvnw spring-boot:run

Web Front-end

  1. Navigate to /frontendcodes/react-js-app.
  2. Run: npm install
  3. Run: npm start

Mobile Front-end

  1. Navigate to /frontendcodes/react-native-project.
  2. Run: npm install
  3. Run: npx expo start (Note: For Android Emulators, ensure the backend is running on localhost:8080 as mapped to 10.0.2.2)

Developed with ❤️ for Math Geeks everywhere.

About

Learning Maths made easy.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors