<<<<<<< HEAD

📱 ShikshAR — Flutter App

AR-powered learning platform for students worldwide. Point your phone at any textbook and watch concepts come alive in 3D.

---

🏗️ Project Structure

lib/
├── main.dart                          # App entry point
├── core/
│   ├── theme/
│   │   ├── app_colors.dart            # Complete color system (dark + light)
│   │   └── app_theme.dart             # Material 3 theme (Sora + DM Sans fonts)
│   ├── constants/
│   │   └── app_constants.dart         # Subjects, agents, languages, AR models data
│   ├── models/
│   │   └── app_provider.dart          # Global state (theme, language, user)
│   └── router/
│       └── app_router.dart            # GoRouter configuration
│
├── shared/
│   └── widgets/
│       ├── main_scaffold.dart         # Bottom nav bar shell
│       └── common_widgets.dart        # GradientButton, AppCard, ProgressBar, etc.
│
└── features/
    ├── onboarding/
    │   └── screens/
    │       └── onboarding_screen.dart # 3-slide onboarding + user setup sheet
    ├── home/
    │   └── screens/
    │       └── home_screen.dart       # Dashboard: streak, scan CTA, subjects, agents
    ├── scanner/
    │   ├── screens/
    │   │   └── scanner_screen.dart    # AR camera UI with real-time agent console
    │   └── widgets/
    │       ├── scan_frame_painter.dart     # Custom scan frame animation
    │       ├── agent_console_widget.dart   # Live agent log display
    │       └── ar_result_sheet.dart        # Bottom sheet after scan
    ├── chat/
    │   └── screens/
    │       └── chat_screen.dart       # AI tutor chat with voice + multilingual
    ├── explore/
    │   └── screens/
    │       └── explore_screen.dart    # Subject browser with search + filter
    ├── progress/
    │   └── screens/
    │       └── progress_screen.dart   # Mastery charts, spaced repetition, history
    ├── settings/
    │   └── screens/
    │       └── settings_screen.dart   # Profile, theme, language, notifications
    └── subjects/
        └── screens/
            └── subject_detail_screen.dart  # Per-subject deep dive + AR scan CTA

---

🎨 Design System

Colors

Token	Dark	Light	Use
Primary	#6366F1	Same	Indigo — CTAs, active states
Secondary	#10D9A0	Same	Teal-green — success, AR active
Accent	#FF6B6B	Same	Coral — warnings, due items
Background	#0B0D17	#F5F6FA	Page background
Surface	#131520	#FFFFFF	Card background
Border	#2A2D3E	#E8EAF2	Dividers, card borders

Typography

• Display: Sora (800, 700, 600 weights) — headings, stats
• Body: DM Sans (400, 500) — descriptions, chat, labels

Components

• GradientButton — press-scale animation, gradient shadow
• AppCard — tap-ripple, theme-aware border
• GradientCard — subject banners, CTAs
• AnimatedProgressBar — smooth width animation
• TagChip — subject/status labels
• ShimmerBox — loading skeleton
• SectionHeader — title + optional action link

---

🚀 Screens

1. Onboarding (/onboarding)

• 3 animated slides with scale + fade entrance
• Feature chips per slide
• Bottom sheet for name + grade setup
• Persisted via SharedPreferences

2. Home (/home)

• Time-aware greeting
• 🔥 Streak banner
• Quick scan CTA card
• Featured AR models horizontal scroll
• All subjects 2-column grid
• AI agents horizontal scroll

3. Scanner (/scanner)

• Full-screen dark camera view
• Animated scan frame with corner brackets + scan line
• Press big button → 5 agents fire sequentially with real delays
• Live agent console (monospace log)
• AR result bottom sheet with quick questions
• Reset & scan another flow

4. Chat (/chat)

• Message bubbles with markdown bold support
• Animated typing indicator (3-dot bounce)
• Voice input with visual feedback
• Language switcher (16 languages)
• Quick topic chips
• Context-aware — launched from scanner pre-fills question

5. Explore (/explore)

• Live search across subjects + topics
• Grade filter chips
• Tab: Subjects grid (gradient cards)
• Tab: Topics list per subject

6. Progress (/progress)

• Summary stats: sessions, mastery %, streak
• Tab: Mastery — radial overall % + per-subject bars + exam readiness
• Tab: Review Queue — SM-2 spaced repetition grouped by urgency
• Tab: History — scrollable session log

7. Settings (/settings)

• Profile card with avatar + stats
• Daily scan counter + progress bar
• Theme toggle (dark/light with animation)
• Language picker (full sheet with 16 options)
• Grade level, notifications, offline mode
• Sign out

8. Subject Detail (/subject/:id)

• Hero header with subject gradient + emoji
• Quick scan CTA for that subject
• All topics list with AR viewer icon

---

📦 Key Packages

go_router: ^13.2.0          # Navigation
flutter_animate: ^4.5.0     # Declarative animations
google_fonts: ^6.1.0        # Sora + DM Sans
provider: ^6.1.2            # State management
shared_preferences: ^2.2.2  # Local persistence
camera: ^0.10.5+9           # Real camera (for production AR)
model_viewer_plus: ^1.8.0   # GLTF/GLB 3D models
speech_to_text: ^6.6.0      # Voice input
flutter_tts: ^4.0.2         # Text-to-speech
fl_chart: ^0.68.0           # Charts
percent_indicator: ^4.2.3   # Circular progress
http: ^1.2.0                # Gemini API calls

---

🏁 Getting Started

# 1. Get dependencies
flutter pub get

# 2. Run
<invoke name="bash_tool">
<parameter name="command">cd /home/claude && zip -r shiksh_ar_flutter.zip shiksh_ar/ -x "*.DS_Store" && echo "Zipped successfully" && ls -lh shiksh_ar_flutter.zip</parameter>
<parameter name="description">Package the Flutter project into a zip</parameter>
=======
# shikshAR
>>>>>>> 22b96f058cffec8716df62892fdc73b401361444