# Daroms Speed App

> Framework mobile Expo + Tamagui + Supabase piloté par Claude : le cœur fournit le répétitif, l'app n'écrit que son spécifique, pour sortir une app par jour.

Version du cœur : 0.5.2. Pile : Expo SDK 58 (Expo Router, React Native 0.88, New Architecture), Tamagui v3, Supabase, EAS, Bun. Documentation en français.

À savoir avant de lire ou d’écrire du code daroms :

- Paquet npm : `@daromsart/daroms-speed-app` (CLI `daroms`, Bun requis). Créer une app : `npx @daromsart/daroms-speed-app new mon-app`.
- Une app contient le cœur dans `core/` (sous-module git ou copie) ; on ne modifie jamais `core/` depuis une app.
- Générer avant d’écrire : `bun daroms g screen|table`, `bun daroms module add`. Claude ne remplit que le spécifique.
- Tamagui v3 n’est pas Tamagui v2 : valeurs plates sans `$` (`p="gutter"`, `bg="card press:background-press"`), plus de `hoverStyle`/`pressStyle`.
- UI : uniquement `@daroms/ui` (catalogue : `core/packages/ui/CATALOG.md`) ; Supabase uniquement dans `src/features/<x>/api.ts` ; textes via `t()` en FR et EN.
- Chaque page existe en HTML et en Markdown (même adresse, suffixe `.md`). Tout le contenu en un fichier : https://daromsartof.github.io/daroms-speedapp/llms-full.txt

## Démarrer

Ce qu’est le framework, installation, tutoriel complet et arborescence d’une app.

- [Introduction](https://daromsartof.github.io/daroms-speedapp/demarrer/introduction.md): Ce qu'est Daroms Speed App, à qui il s'adresse, ses principes et ce qu'il fournit, en une page.
- [Installation](https://daromsartof.github.io/daroms-speedapp/demarrer/installation.md): Prérequis, installation du cœur, commande daroms globale et création d'une première app lancée sur téléphone.
- [Tutoriel : ton app en un jour](https://daromsartof.github.io/daroms-speedapp/demarrer/tutoriel.md): Une journée complète, de l'idée à l'app installée sur téléphone puis soumise aux stores, avec les skills Claude et les commandes daroms.
- [Structure d'une app](https://daromsartof.github.io/daroms-speedapp/demarrer/structure-app.md): Arborescence d'une app créée par daroms new, rôle de chaque fichier et ce qui est généré ou écrit à la main.

## Guides

Une tâche précise par page, commandes exactes et vérification.

- [Ajouter un écran](https://daromsartof.github.io/daroms-speedapp/guides/ajouter-un-ecran.md): Créer un écran complet avec daroms g screen (route mince, feature, i18n, test, manifest), le remplir avec @daroms/ui et le vérifier.
- [Ajouter une table](https://daromsartof.github.io/daroms-speedapp/guides/ajouter-une-table.md): Créer une table Supabase avec RLS, schéma zod et hooks TanStack Query en une commande, ou une table locale sur l'appareil avec les mêmes hooks.
- [Ajouter un module](https://daromsartof.github.io/daroms-speedapp/guides/ajouter-un-module.md): Activer un module du cœur (auth, onboarding, settings, payments, push, analytics, ai-chat, camera, maps), le configurer et faire les étapes hors code.
- [Formulaires](https://daromsartof.github.io/daroms-speedapp/guides/formulaires.md): Construire un formulaire avec FormField, react-hook-form et zod, avec messages d'erreur traduits et envoi par une mutation TanStack Query.
- [Textes et langues](https://daromsartof.github.io/daroms-speedapp/guides/textes-et-langues.md): Afficher tout texte avec t('cle'), garder les mêmes clés en FR et EN, utiliser les textes du cœur et des modules, ajouter une langue.
- [Changer la marque](https://daromsartof.github.io/daroms-speedapp/guides/changer-la-marque.md): Changer l'identité visuelle d'une app en modifiant les 5 valeurs de brand.ts, puis régénérer icône, splash et favicon.
- [Vérifier](https://daromsartof.github.io/daroms-speedapp/guides/verifier.md): Contrôler une app daroms avant de rendre - doctor, contrôle visuel daroms shot, tests jest-expo, flows Maestro, et le skill /daroms-check.
- [Publier](https://daromsartof.github.io/daroms-speedapp/guides/publier.md): Builds EAS preview et production, soumission TestFlight et piste interne Google Play, mises à jour OTA, et la checklist de conformité.
- [Mettre à jour le cœur](https://daromsartof.github.io/daroms-speedapp/guides/mettre-a-jour-le-coeur.md): Passer une app à une nouvelle version du cœur daroms (sous-module core/), resynchroniser la couche IA et vérifier.
- [Développer le cœur](https://daromsartof.github.io/daroms-speedapp/guides/developper-le-coeur.md): Travailler dans le dépôt daroms-speed-app - vérifications, essai dans une vraie app, nouveau composant, icône, module, règle ou skill, publication d'une version.
- [Dépanner](https://daromsartof.github.io/daroms-speedapp/guides/depanner.md): Symptômes fréquents (QR, écran blanc, module natif, types, RLS, cache Metro, hooks, Maestro) avec leur cause probable et l'action à mener.

## Référence

CLI, manifest, marque, composants, tokens, paquets, modules, variantes, règles, skills et hooks.

- [CLI daroms](https://daromsartof.github.io/daroms-speedapp/reference/cli.md): Toutes les commandes de la CLI daroms (new, dev, doctor, g, icons, module, shot, test, e2e, assets, inspire, db, build, submit, update, cost, sync-ai, catalog, release-core) avec leurs options.
- [Manifest](https://daromsartof.github.io/daroms-speedapp/reference/manifest.md): Tous les champs de app.manifest.ts (validé par zod), leurs types et valeurs par défaut, et comment ils pilotent la configuration Expo et l'app.
- [Marque (brand.ts)](https://daromsartof.github.io/daroms-speedapp/reference/marque.md): Les 5 valeurs de brand.ts et ce que @daroms/theme en calcule - palettes OKLCH, neutres, thèmes clair et sombre, sous-thèmes, rayons, espacements, graisses et ressorts selon le ton.
- [Composants @daroms/ui](https://daromsartof.github.io/daroms-speedapp/reference/composants.md): Catalogue des composants @daroms/ui : props clés et exemple d'usage, tokens Tamagui v3 et icônes Lucide disponibles.
- [Tokens et thèmes](https://daromsartof.github.io/daroms-speedapp/reference/tokens.md): Les tokens Tamagui v3 utilisables dans une app daroms - espaces, rayons, couleurs de thème, sous-thèmes, conditions, typographie, icônes et animations, avec la syntaxe v3.
- [Paquets @daroms/*](https://daromsartof.github.io/daroms-speedapp/reference/paquets.md): API publique des paquets du cœur - @daroms/ui, @daroms/theme, @daroms/data, @daroms/lib, @daroms/i18n, @daroms/app, @daroms/config - avec leurs points d'entrée et exemples.
- [Chat IA (ai-chat)](https://daromsartof.github.io/daroms-speedapp/reference/modules/ai-chat.md): Module ai-chat : Assistant Claude en streaming : edge function (clé API côté serveur), historique Supabase, onglet Chat.
- [Analytique (analytics)](https://daromsartof.github.io/daroms-speedapp/reference/modules/analytics.md): Module analytics : Événements et écrans vus, envoyés par lots dans Supabase (table analytics_events, écriture seule).
- [Authentification (auth)](https://daromsartof.github.io/daroms-speedapp/reference/modules/auth.md): Module auth : Connexion e-mail, Apple et Google (Supabase Auth), profil, suppression de compte.
- [Photos (camera)](https://daromsartof.github.io/daroms-speedapp/reference/modules/camera.md): Module camera : Photo prise ou choisie (expo-image-picker), envoyée dans Supabase Storage (dossier par utilisateur), composant PhotoPicker.
- [Cartes (maps)](https://daromsartof.github.io/daroms-speedapp/reference/modules/maps.md): Module maps : Carte avec marqueurs (react-native-maps, repli web), position de l'utilisateur (expo-location), ouverture dans Plans/Maps.
- [Onboarding (onboarding)](https://daromsartof.github.io/daroms-speedapp/reference/modules/onboarding.md): Module onboarding : Pages d'accueil au premier lancement (icône, titre, texte), affichées une fois.
- [Paiements (payments)](https://daromsartof.github.io/daroms-speedapp/reference/modules/payments.md): Module payments : Abonnements RevenueCat : paywall, statut Pro, restauration (paywall souple ou bloquant).
- [Notifications push (push)](https://daromsartof.github.io/daroms-speedapp/reference/modules/push.md): Module push : Notifications Expo : permission, jeton par utilisateur (Supabase), liens profonds, fonction d'envoi.
- [Réglages (settings)](https://daromsartof.github.io/daroms-speedapp/reference/modules/settings.md): Module settings : Onglet Réglages : apparence, langue, haptique, compte, abonnement, notifications, à propos.
- [Variantes d'app](https://daromsartof.github.io/daroms-speedapp/reference/variantes.md): Les 6 variantes de départ de daroms new (blank, list-detail, tracker, ai-chat, social, shop) avec leurs modules, tables et écrans.
- [Règles du framework](https://daromsartof.github.io/daroms-speedapp/reference/regles.md): 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).
- [Skills et agents](https://daromsartof.github.io/daroms-speedapp/reference/skills.md): Les commandes Claude daroms-* (skills), les sous-agents designer, reviewer et store, et les skills tiers figés.
- [Hooks de la couche IA](https://daromsartof.github.io/daroms-speedapp/reference/hooks.md): Les 6 hooks Claude Code du framework - synchronisation, routeur de contexte, vérification des règles, typecheck, protection de .env, statistiques de session - avec leur événement et leur effet.

## Explications

Pourquoi le framework est construit ainsi : architecture, couche IA, sécurité des données, Tamagui v3.

- [Architecture](https://daromsartof.github.io/daroms-speedapp/explications/architecture.md): Un cœur versionné en sous-module, des paquets TypeScript liés, une configuration pilotée par le manifest, des modules activables et des générateurs déterministes.
- [La couche IA](https://daromsartof.github.io/daroms-speedapp/explications/couche-ia.md): Comment Claude produit du code conforme en consommant peu de tokens : ce qui est chargé et quand, les hooks, l'apprentissage d'une app à l'autre, les préfixes daroms- et app-.
- [Données et sécurité](https://daromsartof.github.io/daroms-speedapp/explications/donnees-et-securite.md): Le modèle de données daroms - Supabase avec RLS sur chaque table, accès confiné à api.ts, validation zod, secrets côté serveur - et les recettes pour la lecture publique, le partage, Storage et realtime.
- [Tamagui v3 dans daroms](https://daromsartof.github.io/daroms-speedapp/explications/tamagui-v3.md): Les différences de Tamagui v3 que les modèles connaissent mal : valeurs plates sans $, conditions dans la valeur, clés en kebab-case, sous-thèmes, contrôles nommés, icônes, ordre des providers.

## Agents IA

Comment un agent consomme cette documentation et travaille dans une app daroms.

- [Utiliser avec un agent](https://daromsartof.github.io/daroms-speedapp/agents/utiliser-avec-un-agent.md): Comment un agent IA consomme cette documentation (llms.txt, llms-full.txt, pages en Markdown) et comment il travaille dans une app daroms avec Claude Code.

## English

Pages traduites en anglais (accueil et Démarrer) ; les autres pages restent en français.

- [Daroms Speed App](https://daromsartof.github.io/daroms-speedapp/en.md): An Expo + Tamagui + Supabase mobile framework built for Claude Code. The core ships the repetitive parts; your app only writes what is specific to it, so you can ship an app a day.
- [Introduction](https://daromsartof.github.io/daroms-speedapp/en/demarrer/introduction.md): What Daroms Speed App is, who it is for, its principles and what it provides, on one page.
- [Installation](https://daromsartof.github.io/daroms-speedapp/en/demarrer/installation.md): Requirements, the global daroms command and creating a first app running on your phone.
- [Tutorial: your app in a day](https://daromsartof.github.io/daroms-speedapp/en/demarrer/tutoriel.md): A full day, from the idea to the app installed on a phone and submitted to the stores, with Claude skills and daroms commands.

## Optional

- [Documentation complète](https://daromsartof.github.io/daroms-speedapp/llms-full.txt): toutes les pages ci-dessus en un seul fichier Markdown
- [Dépôt du cœur](https://github.com/daromsartof/daroms-speedapp): sources (packages, modules, CLI, couche IA)
- [Changelog](https://github.com/daromsartof/daroms-speedapp/blob/main/CHANGELOG.md): nouveautés et ruptures par version