Tutoriel : ton app en un jour

Objectif : partir d’une idée le matin et installer l’app sur un téléphone le soir, en laissant Claude faire le répétitif. Les durées sont celles de l’app pilote (Lecture, un suivi de lecture).

En une commande

/daroms-day <idée> enchaîne toutes les étapes ci-dessous et s’arrête pour ta validation entre chacune. Ce tutoriel détaille ce qu’il fait, pour pouvoir lancer une étape seule.

Prérequis (une fois)

• Node >= 22.18, Bun >= 1.3, Python 3, Git ; Android Studio (émulateur) ou Xcode (simulateur) facultatifs.
• Comptes : Expo (EAS), Supabase ; Apple Developer et Google Play pour publier.
• La CLI : rien à installer, npx @daromsart/daroms-speed-app la télécharge depuis npm ; ou npm install -g @daromsart/daroms-speed-app pour avoir daroms partout.

Détail : Installation.

Matin : cadrer et créer (1 h)

1. Ouvrir Claude Code dans le dossier des projets et lancer /daroms-day Une app pour suivre ses habitudes de lecture.
2. Cadrage (/daroms-idea) : Claude écrit app.spec.md (cible, boucle principale, 3 à 6 écrans, tables, modules, monétisation, nom, ton, variante). Relire et valider : c’est la source unique des étapes suivantes.
3. Création (/daroms-new) : une commande crée l’app complète :

   npx @daromsart/daroms-speed-app new lecture --name "Lecture" --variant tracker --primary "#0F766E" --accent "#F59E0B" --tone minimal

   Template, sous-module core/, brand.ts, app.manifest.ts, modules de la variante, icônes générées, dépendances, couche IA (.claude/), commit initial.
4. cd lecture && cp .env.example .env (URL et clé publique Supabase), puis bun daroms dev : scanner le QR avec Expo Go.

Midi : inspiration, marque, design, données (2 h)

5. Inspiration (/daroms-inspire) : Claude cherche des maquettes et des apps publiées sur Dribbble, Pinterest, Behance, Mobbin et Screens Design, regarde les aperçus (bun daroms inspire <url>), propose 2 ou 3 directions et écrit celle que tu choisis dans app.spec.md > Inspiration. Il s’en inspire sans rien copier.
6. Marque (/daroms-brand) : 5 valeurs dans brand.ts, icône SVG dans assets/source/icon.svg, puis bun daroms assets. Vérifier /_dev/kitchen-sink en clair et en sombre. Voir Changer la marque.
7. Design (/daroms-design) : wireframes texte par écran dans app.spec.md, uniquement avec les composants du catalogue.
8. Données (/daroms-data) : bun daroms g table books --fields "title:text, author:text?, pages:int=0" crée la migration avec RLS, le schéma zod, les hooks useBooks, useCreateBook… puis bun daroms db push. Voir Ajouter une table.

Après-midi : écrans et modules (3 h)

9. Écrans (/daroms-screen books --tab --icon BookOpen) : route mince, feature, 4 états, textes FR/EN, test ; Claude remplit avec @daroms/ui et vérifie avec bun daroms shot /books. Voir Ajouter un écran.
10. Modules (/daroms-module payments) : paywall RevenueCat, statut Pro, restauration ; idem push, ai-chat, analytics, camera (photos vers Supabase Storage), maps (carte, position). Voir Ajouter un module.
11. Vérification (/daroms-check) puis finition (/daroms-polish) : revue visuelle par l’agent daroms-designer. Voir Vérifier.

Soir : publier (1 h)

12. Fiche store (/daroms-store) : titres, mots-clés, descriptions FR/EN, captures, politique de confidentialité.
13. Build (/daroms-build preview) : installation interne par QR ; puis production et /daroms-submit (TestFlight, piste interne). Voir Publier.
14. Bilan : /daroms-learn (zones de contexte), puis bun daroms cost écrit app.cost.md : tokens et prix de l’app par étape, par modèle et par session, au tarif de l’API Anthropic. C’est la référence à faire baisser à l’app suivante. Enfin /daroms-commit.

Et ensuite

• Une correction JavaScript sans changement natif : bun daroms update production --message "...".
• Une nouvelle version du cœur : Mettre à jour le cœur.