📚 Memorize - Smart English Vocabulary Learning & Review App

Memorize is a mobile-first web application designed for learning English vocabulary. Powered by the Spaced Repetition System (SRS) algorithm, it offers multiple interactive quiz modes and gamification features to make vocabulary retention effective, engaging, and fun.

---

✨ Key Features

• 🎴 Diverse Practice Modes:
  • Flashcards: Interactive card flipping with audio pronunciation and self-assessment ratings.
  • Multiple Choice: Speed quiz testing word definitions.
  • Fill in the Blank: Contextual sentence completion exercises.
  • Type Word: Spelling and recall challenges by typing target words.
• 🧠 Spaced Repetition System (SRS): Smart algorithm that schedules word reviews based on your memory retention level.
• ➕ Custom Vocabulary: Easily add and study your own custom word lists.
• 🎮 Gamification & Progress Tracking:
  • Experience Points (XP), Levels, and Daily Streaks.
  • Daily Goals tracking.
• 📊 Detailed Analytics: Comprehensive view of quiz history, accuracy rates, and learning statistics.
• 🌙 Modern UI & Dark Mode: Mobile-first responsive UI with smooth Framer Motion animations, Dark/Light theme switching, and sound effects.

---

🛠️ Tech Stack

• Framework: Next.js 14 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• Animations: Framer Motion
• Icons: Lucide React
• Effects: canvas-confetti (Celebration effects on quiz completion)

---

🚀 Getting Started

Prerequisites

• Node.js: v18.x or higher
• npm, yarn, pnpm, or bun

1. Clone the repository

git clone https://github.com/hapham96/Memorize.git
cd Memorize

2. Install dependencies

npm install

3. Run Development Server

npm run dev

Open your browser and navigate to: http://localhost:3000

4. Build for Production

# Build production bundle
npm run build

# Start production server
npm run start

---

📂 Project Structure

Memorize/
├── src/
│   ├── app/                # Next.js App Router (Layouts, Pages, Global CSS)
│   ├── components/         # UI Components
│   │   ├── auth/           # Onboarding & Auth screens
│   │   ├── dashboard/      # Main Dashboard & Add Word modal
│   │   ├── layout/         # Header, BottomNav, MobileContainer
│   │   ├── profile/        # User Profile & Settings modal
│   │   ├── quiz/           # Quiz screens (Flashcard, Multiple Choice, etc.)
│   │   ├── review/         # SRS Review Dashboard
│   │   └── stats/          # Statistics & Progress dashboards
│   ├── data/               # Local fallback datasets (related words, definitions)
│   ├── lib/                # Utilities (SRS, Audio FX, LocalStorage persistence)
│   └── types/              # TypeScript Type Definitions
├── public/                 # Static Assets (Images, Audio)
├── package.json
└── README.md

---

📝 License

This project is open-source and available for educational and personal use.