Python Mentor Studio

A professional, responsive Python AI Tutor web app built with React + Vite.
It uses frontend-only localStorage auth and personalized progress tracking for each student profile.

Overview

Python Mentor Studio is designed for beginners, intermediate learners, and pro students.
Users first see a public feature dashboard, then must sign in/sign up to access the full student dashboard and learning tools.

Core Features

• Sign in / sign up (frontend-only localStorage authentication)
• Auth-gated experience (features locked until user signs in)
• Public dashboard before login with platform overview
• Auto-redirect to private student dashboard after sign-in
• Personalized student dashboard (user-specific data)
• AI Tutor Workspace (interactive mentor Q&A simulation)
• Theory Hub with structured topic explanations
• Quiz Lab with immediate feedback and scoring
• Smart Study Planner with customizable timeline and goals
• Resource Explorer with filtering/search
• Dynamic personalized progress report:
  • Mentor sessions
  • Quiz attempts and score ratio
  • Theory modules completed
  • Study streak
• Study notes saved per user profile
• Dark/Light theme toggle with persistence

Dynamic Progress Reporting

Yes, the project includes dynamic progress reporting per signed-in student.

• Initial baseline is shown so the dashboard is not empty.
• Then it updates based on real activity:
  • Asking mentor questions
  • Submitting quizzes
  • Completing theory modules
  • Daily activity streak
• Progress is stored by user in localStorage.

Tech Stack

• React 18
• Vite
• CSS (custom design system, responsive layout)
• localStorage (auth, progress, notes, theme persistence)

Project Structure

• src/App.jsx — full app logic, auth flow, dashboard, feature modules
• src/App.css — complete styling, responsive + dark/light theme
• src/index.css — global reset/base styles
• src/main.jsx — app bootstrap
• index.html — Vite entry document

Getting Started

Prerequisites

• Node.js 18+ (recommended)
• npm

Install Dependencies

bash npm install

npm run dev

Open the local URL shown in terminal (usually http://localhost:5173).

#Scripts npm run dev — start development server npm run build — create production build npm run preview — preview production build locally npm run lint — run ESLint checks Data Persistence (localStorage) The app stores data in browser localStorage, including:

user accounts active session user progress user notes theme preference To reset everything, clear browser localStorage for the app origin.

Important Note This authentication system is frontend-only and intended for learning/demo use. It is not secure enough for production authentication without a backend.

UX Flow User lands on public dashboard (feature preview). User signs in/signs up. User is redirected to private dashboard. User uses tutor features and progress updates dynamically. Data persists across refresh for that profile.

Future Upgrade Suggestions Backend auth (JWT/session) with secure password hashing Cloud database for multi-device sync Real LLM API integration for tutor responses Admin analytics and teacher/student roles