chore: initial commit

README.md

@@ -0,0 +1,37 @@
+# flashcards
+
+Application web PWA (Next.js 16 + React + TypeScript + Tailwind CSS 4 + Serwist).
+
+## Prérequis
+
+- Node.js >= 20.19.0 (ou >= 22.12.0)
+- pnpm >= 9
+
+## Installation
+
+```bash
+pnpm install
+```
+
+## Commandes
+
+| Commande             | Description                                                   |
+| -------------------- | ------------------------------------------------------------- |
+| `pnpm dev`           | Serveur de développement (Turbopack)                          |
+| `pnpm build`         | Build de production + service worker (Serwist)                |
+| `pnpm start`         | Prévisualisation du build en local                            |
+| `pnpm test`          | Tests unitaires (Vitest)                                      |
+| `pnpm test:watch`    | Tests en mode watch                                           |
+| `pnpm test:coverage` | Tests + rapport de couverture (coverage/)                     |
+| `pnpm lint`          | Lint ESLint                                                   |
+| `pnpm format`        | Formatage Prettier                                            |
+| `pnpm typecheck`     | Vérification TypeScript                                       |
+| `pnpm check`         | Chaîne qualité : lint → format → typecheck → tests → coverage |
+
+## Environnement
+
+Copiez `.env.example` vers `.env` pour définir les variables (préfixe `NEXT_PUBLIC_`).
+
+## Licence
+
+MIT — voir [LICENSE](LICENSE).