# Règles du framework > Toutes les règles de code daroms : résumé, fichiers concernés, détail, et ce qui les vérifie (ESLint, hooks, générateurs, agents). Les règles vivent dans `_ai/rules/` (chargées selon les fichiers touchés, frontmatter `paths:`) et `_ai/rules-ondemand/` (lues quand le sujet arrive). Le noyau `_ai/CLAUDE.core.md` les résume et reste toujours chargé. :::note[Page générée] Générée depuis `_ai/rules/*.md`, `_ai/rules-ondemand/*.md` à chaque build du site : modifier la source, pas cette page. ::: ## Qui vérifie quoi | Règle | Vérifiée par | |---|---| | Routes minces (`app/**` = réexports) | ESLint, hook `daroms-check-rules` | | Couleurs : tokens seulement | ESLint, hook, typage Tamagui (`somewhat-strict`) | | Pas de nombre magique de style, `StyleSheet`, style inline | ESLint, hook | | Supabase seulement dans `features/x/api.ts` | ESLint, hook | | `any` interdit | ESLint, hook | | Textes via `t()`, sans emoji ni tiret long, clés FR = EN | ESLint, hook, `daroms doctor` | | Pas de librairie UI ni d'icônes tierces | ESLint, hook | | Imports absolus `@/`, `~/` | ESLint | | Fichiers <= 200 lignes | ESLint, hook | | RLS sur chaque table, pas de `service_role` dans l'app | générateur `g table`, agent `daroms-reviewer` | | 4 états par écran | générateur `g screen`, `QueryView` / `List`, agent `daroms-reviewer` | | `.env` jamais lu | permissions `deny`, hook `daroms-deny-env` | ## Index | Règle | Résumé | Chargée pour | |---|---|---| | [daroms-ai-files](#daroms-ai-files) | Les fichiers daroms-* de .claude/ sont écrasés à chaque synchro ; ce qui est propre à l'app porte le préfixe app-. | `.claude/**`, `CLAUDE.md`, `app.spec.md` | | [daroms-data](#daroms-data) | Supabase seulement dans features/x/api.ts via db() ; entrées et sorties validées zod ; hooks TanStack Query. | `src/features/**/api.ts`, `src/features/**/schema.ts`, `src/features/**/hooks.ts` | | [daroms-database](#daroms-database) | Structure uniquement par migration SQL ; RLS sur chaque table ; jamais de clé service_role côté app. | `supabase/**` | | [daroms-i18n](#daroms-i18n) | Tout texte affiché passe par t('cle') ; clés identiques dans chaque langue ; ni emoji, ni tiret long. | `locales/**`, `src/**/*.tsx` | | [daroms-naming](#daroms-naming) | PascalCase composants, useX hooks, kebab-case routes et dossiers, fichiers ≤ 200 lignes, imports absolus @/ et ~/. | `src/**`, `app/**` | | [daroms-performance](#daroms-performance) | FlashList pour toute liste, expo-image, items mémoïsés, animations Reanimated ou transition Tamagui. | `src/**/*.tsx` | | [daroms-routes](#daroms-routes) | app/** ne contient que des réexportations d'écrans ; aucune logique, aucun JSX. | `app/**/*.tsx` | | [daroms-screens](#daroms-screens) | Chaque écran gère 4 états (chargement, vide, erreur + réessayer, données) et reste sous 200 lignes. | `src/features/**/*Screen.tsx`, `src/features/**/components/**` | | [daroms-state](#daroms-state) | Serveur = TanStack Query ; local persistant = @daroms/lib/storage ; global UI = Zustand, un store par feature, rare. | `src/**/*.ts`, `src/**/*.tsx` | | [daroms-styles](#daroms-styles) | Composants @daroms/ui et tokens Tamagui v3 uniquement ; ni hex, ni nombre magique, ni StyleSheet, ni style inline. | `src/**/*.tsx`, `app/**/*.tsx` | | [daroms-tests](#daroms-tests) | Tests unitaires jest-expo à côté du code ; flows Maestro dans e2e/ ; pas de réseau dans les tests. | `**/*.test.ts`, `**/*.test.tsx`, `e2e/**` | | [daroms-animations](#daroms-animations) | transition Tamagui pour les états simples ; Reanimated 4 pour le geste et le continu. | à la demande | | [daroms-core-dev](#daroms-core-dev) | Travailler dans le dépôt daroms-speed-app (et non dans core/ d'une app), tester, publier une version. | à la demande | | [daroms-eas](#daroms-eas) | Profils development, preview, production ; canaux OTA ; version runtime = version de l'app. | à la demande | | [daroms-store-compliance](#daroms-store-compliance) | Points de refus fréquents à vérifier avant chaque soumission. | à la demande | | [daroms-supabase-advanced](#daroms-supabase-advanced) | Tables partagées, lecture publique, storage, realtime, fonctions SQL et edge functions. | à la demande | ## daroms-ai-files > Les fichiers daroms-* de .claude/ sont écrasés à chaque synchro ; ce qui est propre à l'app porte le préfixe app-. Chargement : quand Claude lit ou écrit `.claude/**`, `CLAUDE.md`, `app.spec.md`. - Règle propre à l'app : `.claude/rules/app-.md` (frontmatter `paths:`, une ligne `> résumé`). - Skill propre à l'app : `/daroms-skill-new` ; zones apprises : `.claude/context/app-zones.json` (`/daroms-learn`). - `CLAUDE.md` de l'app reste court : importe le noyau et le digest, ajoute seulement les spécificités. - `app.spec.md` est la source de vérité produit : le mettre à jour quand une décision change. ## daroms-data > Supabase seulement dans features/x/api.ts via db() ; entrées et sorties validées zod ; hooks TanStack Query. Chargement : quand Claude lit ou écrit `src/features/**/api.ts`, `src/features/**/schema.ts`, `src/features/**/hooks.ts`. - Générer : `bun daroms g table --fields "titre:text, fait:bool=false, echeance:timestamptz?"` -> migration RLS, `schema.ts`, `api.ts`, types. - Données sur l'appareil seulement : `--local` -> `localTable('t', Schema)` (`list`, `get`, `insert`, `update`, `remove`), mêmes hooks ; jamais de `storage.getJSON` à la main pour une collection. - Lecture : `useQuery({ queryKey: keys.list(), queryFn: async () => parseOrThrow(Schema.array(), unwrap(await db().from('t').select('*'))) })`. - Écriture : `useMutation` + `Input.parse(values)` + `invalidateQueries({ queryKey: keys.all })`. Optimiste seulement si l'UX l'exige. - Erreurs : `unwrap()` et `toAppError()` (`@daroms/data`) ; l'UI affiche `ErrorState error={q.error}` (message traduit). - Clés : `queryKeys('feature')` -> `all`, `list(params)`, `detail(id)`. - Utilisateur courant : `useUser()` ; ne jamais filtrer par user_id côté client à la place de la RLS. - `hooks.ts` combine requêtes et état local de l'écran (`useXScreen`) ; l'écran ne parle qu'à ce hook. - Types : `src/types/db.ts` (généré : `bun daroms db types`) ; ne pas l'éditer. ## daroms-database > Structure uniquement par migration SQL ; RLS sur chaque table ; jamais de clé service_role côté app. Chargement : quand Claude lit ou écrit `supabase/**`. - Nouvelle table : `bun daroms g table` (préféré) ou `bun daroms db new ` puis SQL à la main. - Chaque table : `enable row level security` + politiques `select/insert/update/delete` `to authenticated` avec `(select auth.uid()) = user_id`. - Index sur toute colonne de filtre (`user_id`, clés étrangères). `updated_at` via `public.daroms_set_updated_at()`. - Ne jamais modifier une migration déjà poussée : en créer une nouvelle. - Appliquer : `bun daroms db push` (puis types régénérés). Edge functions : `supabase/functions//index.ts` (Deno). - Secrets serveur : `bunx supabase secrets set NOM=...` ; jamais dans `.env` de l'app (seules les clés publiques `EXPO_PUBLIC_*`). - Détails avancés (tables partagées, storage, realtime) : `.claude/rules-ondemand/daroms-supabase-advanced.md`. ## daroms-i18n > Tout texte affiché passe par t('cle') ; clés identiques dans chaque langue ; ni emoji, ni tiret long. Chargement : quand Claude lit ou écrit `locales/**`, `src/**/*.tsx`. - `const t = useT()` (`@daroms/i18n`) ; clés typées depuis `locales/fr.json` (namespace app). - Organisation : `.` (`todos.emptyTitle`), onglets `tabs.`. Pluriels : `_one` / `_other`. - Ajouter chaque clé en FR et EN dans le même changement (`bun daroms doctor` vérifie la parité). - Textes courts, ton du cahier (`app.spec.md`). Interpolation : `t('x.count', { count })`. - Textes du cœur (Réessayer, Annuler...) : déjà fournis par les composants ; messages zod = clés `daroms:validation.*`. ## daroms-naming > PascalCase composants, useX hooks, kebab-case routes et dossiers, fichiers ≤ 200 lignes, imports absolus @/ et ~/. Chargement : quand Claude lit ou écrit `src/**`, `app/**`. - Feature : `src/features//` avec `Screen.tsx`, `hooks.ts`, `api.ts`, `schema.ts`, `components/`. - Hooks : `use` ; composants : `.tsx` exportant `` ; tests à côté : `.test.tsx`. - Imports : `@/` pour `src/`, `~/` pour la racine (`~/brand`, `~/locales/fr.json`) ; jamais `../`. - Fonctionnalité optionnelle réutilisable : module du cœur (`/daroms-module`), pas dans l'app. ## daroms-performance > FlashList pour toute liste, expo-image, items mémoïsés, animations Reanimated ou transition Tamagui. Chargement : quand Claude lit ou écrit `src/**/*.tsx`. - Liste : `List` (FlashList v2) ; `renderItem` stable (`useCallback`) ; item extrait et `memo`. Jamais `map` sur plus de ~20 éléments dans un ScrollView. - Images : `Image` de `@daroms/ui` (cache, placeholder blurhash, `ratio`). - Animations : prop `transition` + valeurs `enter:`/`exit:` ; cas avancés Reanimated (voir rules-ondemand/daroms-animations.md). - React Compiler actif : pas de `useMemo`/`useCallback` défensifs partout, seulement pour les props de listes. ## daroms-routes > app/** ne contient que des réexportations d'écrans ; aucune logique, aucun JSX. Chargement : quand Claude lit ou écrit `app/**/*.tsx`. - Une route = une ligne : `export { default } from '@/features//Screen'`. - Layouts : `export { default } from '@/features/root/RootLayout'` ; écrans de module : `export { XScreen as default } from '@daroms/module-x'`. - Créer une route : `bun daroms g screen [--tab --icon Nom]` (route + feature + i18n + test + manifest). - Onglets : déclarés dans `app.manifest.ts > tabs` (nom, icône Lucide, clé de titre), pas dans le layout. - Paramètres : `app/todo/[id].tsx` -> l'écran lit `useLocalSearchParams<{ id: string }>()`. - Navigation : `useRouter()` ; liens typés (`router.push('/todo/42')`). ## daroms-screens > Chaque écran gère 4 états (chargement, vide, erreur + réessayer, données) et reste sous 200 lignes. Chargement : quand Claude lit ou écrit `src/features/**/*Screen.tsx`, `src/features/**/components/**`. - Squelette : `} onRefresh refreshing>` puis contenu. - 4 états : `QueryView query={q} empty={{...}}` (ou `List data loading error onRetry empty`) ; jamais d'état oublié. - Formulaire : `useForm({ resolver: zodResolver(schema) })` + `FormField control name label` ; soumission `onPress={() => void form.handleSubmit(onValid)()}` ; bouton `loading={mutation.isPending}`. - Pied fixe (action principale) : `Screen footer={