Skip to content

SPEC.md

Latest commit

 

History

History
71 lines (57 loc) · 2.26 KB

SPEC.md

File metadata and controls

71 lines (57 loc) · 2.26 KB

Language Learning App - Specification Document

1. Project Overview

Project Name: LinguaLearn Project Type: Flutter Mobile Application Core Functionality: An interactive language learning app with daily lessons, flashcards, quizzes, and progress tracking for vocabulary and grammar mastery.

2. Technology Stack & Choices

  • Framework: Flutter 3.10+
  • Language: Dart 3.10+
  • State Management: flutter_bloc (BLoC pattern)
  • Local Storage: sqflite (SQLite database)
  • Audio Playback: audioplayers (for pronunciations)
  • Architecture: Clean Architecture (Data / Domain / Presentation layers)

Key Dependencies

  • flutter_bloc: ^8.1.3
  • sqflite: ^2.3.0
  • path_provider: ^2.1.1
  • equatable: ^2.0.5
  • audioplayers: ^5.2.1

3. Feature List

Core Features

  1. Language Selection - Choose target language (Spanish, French, German, Japanese)
  2. Daily Lessons - Structured lessons with words, phrases, and sentences
  3. Flashcards - Swipeable cards with word, translation, pronunciation
  4. Quizzes - Multiple choice and fill-in-the-blank assessments
  5. Categories - Vocabulary, Grammar, Phrases, Numbers
  6. Progress Tracking - Track completed lessons and quiz scores
  7. Audio Pronunciations - Native speaker audio for words/phrases

Data Features

  1. Local Storage - All learning data stored locally in SQLite
  2. Sample Data - Pre-loaded learning content for each language

4. UI/UX Design Direction

Visual Style

  • Material Design 3
  • Modern, clean, educational aesthetic
  • Soft color palette suitable for learning

Color Scheme

  • Primary: Deep Purple (#6750A4)
  • Secondary: Teal (#03DAC6)
  • Background: Off-white (#FFFBFE)
  • Surface: White (#FFFFFF)
  • Error: Red (#B3261E)

Layout Approach

  • Bottom navigation bar with 4 tabs:
    1. Home (Dashboard with daily lesson)
    2. Lessons (Browse all lessons)
    3. Flashcards (Practice mode)
    4. Quiz (Test knowledge)
  • Drawer for: Settings, Categories, Progress

Typography

  • Headlines: Bold, large for emphasis
  • Body: Clean, readable for learning content
  • Learning cards: Clear distinction between word and translation

Interaction Patterns

  • Swipe gestures for flashcards
  • Tap to reveal answers
  • Progress indicators for lessons
  • Score display after quizzes