An interactive Android educational app designed to teach Mendelian Inheritance concepts through structured lessons, engaging quizzes, and progress tracking. Built with Kotlin and Jetpack Compose, and powered by Firebase for cloud-based authentication and progress storage.

• Kotlin & Jetpack Compose
• Firebase Authentication
• Firebase Firestore
• Android Studio
• Material 3

# Clone the repository
git clone https://github.com/YOUR_USERNAME/Gen-MIND.git
# Open the project in Android Studio
# File → Open → Select the Gen-MIND folder
# Add your google-services.json from Firebase Console
# Place it in the /app directory
# Build and run on an emulator or physical device
# Build → Make Project → Run

Ensure you have Android Studio installed, a Firebase project set up with Authentication and Firestore enabled, and your google-services.json placed in the /app directory.

• User Authentication — Secure sign-up and login via Firebase Authentication with real email addresses and password reset support.
• 10 Structured Lessons — Progressive lesson system covering Genes, Chromosomes, DNA, Genetics, Gregor Mendel, Punnett Squares, Key Terms, Homozygous vs. Heterozygous, Examples, and Summary.
• Interactive Quizzes — Three distinct quiz types embedded in the lesson flow:
  • Crossword Puzzle (Lesson 4) — Fill-in vocabulary reinforcement
  • Punnett Square (Lesson 9) — Interactive genetic combination exercises
  • Assessment Quiz (Lesson 10) — 10-item multiple choice evaluation with scoring
• Pretest — Entry assessment with scoring to gauge prior knowledge before lessons begin.
• Cloud Progress Tracking — Lesson and quiz completion synced to Firebase Firestore, persisting across devices and app reinstalls.
• Achievements System — Visual progress bars tracking completed lessons (out of 10) and completed quizzes (out of 3).
• Tasks Screen — Overview of lesson completion progress.
• Guest Mode — Explore the app without an account (progress resets on close).
• COMPLETE! Badge — Homepage displays a completion badge when all 10 lessons are finished.

The app follows a single-activity architecture using Jetpack Compose for UI and Firebase for backend services:

• Authentication: Firebase Auth handles real email/password login, sign-up, and password reset via email links.
• Progress Storage: Firestore stores each user's current_lesson, completed_lessons, completed_quizzes, and first_login flag under a document keyed by their email.
• Lesson Progression: Lessons unlock sequentially. Lessons with quizzes (4, 9, 10) show a confirmation dialog before launching the quiz screen.
• Quiz Validation:
  • Crossword enforces exact character matching per cell.
  • Punnett Square uses case-sensitive validation (B ≠ b).
  • Assessment Quiz tallies correct answers and displays a final score.
• Navigation: Screen routing is managed in MainActivity.kt using a when block on a currentScreen state variable.

app/src/main/
├── assets/ # Images and 3D icons used in lessons
│ ├── trophy_3d.png # Trophy icon for Achievements screen
│ ├── task_3d.png # Task icon for Tasks screen
│ └── [lesson images].png # Lesson-specific illustrations
├── java/com/example/gen_mind/
│ ├── MainActivity.kt # Main entry point and screen router
│ ├── WelcomeScreen.kt # Landing screen with login/sign-up/guest options
│ ├── LoginScreen.kt # Email login with forgot password support
│ ├── SignUpScreen.kt # New user registration
│ ├── SuccessScreen.kt # First-time welcome screen
│ ├── PretestScreen.kt # Entry quiz with scoring (5 questions)
│ ├── HomepageScreen.kt # Lesson map with progress and icons
│ ├── LessonScreen.kt # All 10 lesson content screens
│ ├── CrosswordScreen.kt # Crossword puzzle quiz for Lesson 4
│ ├── PunnettSquareScreen.kt # Punnett Square quiz for Lesson 9
│ ├── AssessmentQuizScreen.kt # 10-item MCQ quiz for Lesson 10
│ ├── TasksScreen.kt # Lesson completion tracker
│ ├── AchievementsScreen.kt # Progress bars for lessons and quizzes
│ └── CredentialsManager.kt # Firebase Auth and Firestore logic
├── res/
│ └── [standard Android resources]
└── google-services.json # Firebase config (not included in repo)

Welcome Screen Login Screen Sign Up Screen Homepage Map Screen

Lesson Screen Tasks Screen Achievements Screen

Crossword Puzzle (Lesson 4)

Punnett Square (Lesson 9)

• Question 1 (BB ×ばつ bb): All cells = Bb
• Question 2 (Bb ×ばつ bb): BB, Bb, Bb, bb

Assessment Quiz (Lesson 10) B, A, C, B, D, C, A, C, A, D

Wayne — github.com/wayne2604