# Learn Catalan

A complete, zero-backend static course for English speakers. It uses pure HTML, CSS, and vanilla JavaScript and can be hosted free on GitHub Pages.

## What is included

- Full A0–C1 level path and 31 grammar chapters
- 5,000 corpus-informed vocabulary entries
- Flashcard decks covering every rank from 1–5,000
- A Catalan example sentence and English translation on every vocabulary card
- The Key of Six Voices: 24 manga-style reading episodes from A0 to C1
- Browser audio, Anki copying, and local spaced-repetition progress

## Deploy on GitHub Pages

1. Create a public GitHub repository.
2. Upload the contents of this folder to the repository root.
3. Open **Settings → Pages**.
4. Under **Build and deployment**, choose **Deploy from a branch**.
5. Select `main` and `/ (root)`, then save.

No build command, package manager, database, account, or API key is required.

## Content and data

The course content is original educational material. The frequency order is informed by the Catalan OpenSubtitles list from FrequencyWords (CC BY-SA 4.0). Vocabulary translations and grammatical metadata are adapted and cross-checked from DACCO (LGPL-2.1). See `ATTRIBUTION.md`.

## Validate before publishing

Run `python3 scripts/validate_site.py`. The included GitHub Actions workflow runs the same validation automatically on every push and pull request.

## License

Original site code is MIT licensed. Original lesson and story text is CC BY-SA 4.0. Third-party lexical data retains its source license; see the attribution file.