Add README with project overview and architecture summary
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
32
README.md
Normal file
32
README.md
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
# Conjuga
|
||||||
|
|
||||||
|
A Spanish verb conjugation learning app for iOS. Practice all 20 tenses with spaced repetition, handwriting recognition, and vocabulary courses.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Conjugation Practice** — Flashcards, typing, multiple choice, handwriting, sentence building, and full table modes
|
||||||
|
- **Spaced Repetition** — SM-2 algorithm tracks what you know and surfaces what you don't
|
||||||
|
- **1,750 Verbs** — From basic to expert, with irregular form highlighting
|
||||||
|
- **20 Tenses** — Every indicative, subjunctive, conditional, and imperative tense
|
||||||
|
- **Grammar Guide** — 20 tense guides with conjugation tables + 20 grammar topic notes (Ser vs Estar, Por vs Para, etc.)
|
||||||
|
- **Vocabulary Courses** — Weekly decks with example sentences
|
||||||
|
- **Progress Tracking** — Streaks, daily goals, accuracy stats, and achievement badges
|
||||||
|
- **CloudKit Sync** — Review progress syncs across devices
|
||||||
|
- **Widgets** — Daily progress, word of the day, and weekly stats
|
||||||
|
- **Text-to-Speech** — Hear any verb pronounced in Spanish
|
||||||
|
|
||||||
|
## Architecture
|
||||||
|
|
||||||
|
- **SwiftUI** + **SwiftData** with a dual-store configuration:
|
||||||
|
- **Local store** — Reference data (verbs, forms, guides) seeded from JSON on first launch
|
||||||
|
- **Cloud store** — User data (review cards, progress, streaks) synced via CloudKit
|
||||||
|
- **SharedModels** package shared between the app and widget extension
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- iOS 18+
|
||||||
|
- Xcode 16+
|
||||||
|
|
||||||
|
## Building
|
||||||
|
|
||||||
|
Open `Conjuga/Conjuga.xcodeproj` in Xcode and run on a simulator or device. Data seeds automatically on first launch.
|
||||||
Reference in New Issue
Block a user