No description
|
Some checks are pending
CI / quality (push) Waiting to run
- scripts/sync-roadmap.mjs : copie ROADMAP frontend (source de verite) vers backend (copie generee). - Garde sens-unique : identite de chemins resolus + refus si cible dans le repo source + casse win32. - Validation source (existe, non vide, header attendu) ; diff + confirmation y/N ; flag --check (dry-run). - Banniere auto-generee en tete de la copie backend (NE PAS EDITER A LA MAIN), ignoree au diff (idempotent). - Pas de commit auto : rappelle la marche a suivre manuelle. - alias npm sync:roadmap. |
||
|---|---|---|
| .cursor/skills/frontend-design | ||
| .github | ||
| design-reference | ||
| docs | ||
| public | ||
| scripts | ||
| src | ||
| .env.example | ||
| .gitignore | ||
| .prettierrc | ||
| components.json | ||
| eslint.config.js | ||
| index.html | ||
| package-lock.json | ||
| package.json | ||
| README.md | ||
| tsconfig.app.json | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
Expria Frontend
Frontend SaaS pour la préparation au TCF Canada. SPA React + Vite, déploiement Cloudflare Pages.
Stack
React 19 · Vite 8 · TypeScript 6 · Tailwind 4 · React Router 7 · TanStack Query 5 · Supabase Auth · Vitest.
Détails et versions : docs/adr/006-stack-versions-2026.md.
Prérequis
- Node.js 22 LTS
- npm 10+
Installation
npm install
cp .env.example .env
# Remplir .env avec tes valeurs Supabase + URL backend
Commandes
| Commande | Rôle |
|---|---|
npm run dev |
Lance le serveur de dev Vite (HMR) |
npm run build |
Build de production |
npm run typecheck |
tsc --noEmit |
npm run lint |
ESLint |
npm run test |
Vitest (run unique) |
npm run test:watch |
Vitest (watch mode) |
npm run format |
Formate tout via Prettier |
npm run format:check |
Vérifie le formatage sans écrire |
Variables d'environnement
Voir .env.example. Le démarrage échoue avec un message clair si une variable requise manque (validation Zod dans src/shared/config/env.ts).
Structure du code
Voir docs/ARCHITECTURE.md §3.
Architecture FSD : app/ (entry) · entities/ (métier) · features/ (UI) · shared/ (code réutilisable).
Documentation
| Document | Contenu |
|---|---|
docs/ARCHITECTURE.md |
Architecture complète, flux, codes d'erreur |
docs/DEVELOPMENT_PRINCIPLES.md |
Règles de dev, conventions, workflow |
docs/ONBOARDING.md |
Guide dev (démarrage, outils) |
docs/SECURITY.md |
Patterns sécurité + trous identifiés |
docs/adr/ |
Architecture Decision Records |
CI
GitHub Actions : lint, format:check, typecheck, test, npm audit --audit-level=high. Voir .github/workflows/ci.yml.
Licence
Propriétaire — Expria.