Skip to content

README.fr-FR.md

Latest commit

 

History

History
104 lines (63 loc) · 4.59 KB

README.fr-FR.md

File metadata and controls

104 lines (63 loc) · 4.59 KB
Raw

StartER 🚀

L'environnement pour le prototypage rapide à l'ère de l'IA

GitHub tag License Issues - start-express-react GitHub Stars

Use this template Read the manual

Apprenez le développement fullstack. Créez des prototypes avec l'IA. Gardez le contrôle.

🧠 Starter, le framework idéal pour l'IA

La plupart des frameworks sont trop complexes pour l'IA. Ils dissimulent la logique derrière des abstractions complexes et opaques, ce qui peut entraîner des dysfonctionnements et des erreurs de conception chez les agents.

Nous avons conçu StartER pour nous démarquer. Il s'agit d'une plateforme "sans magie" conçue pour la co-création humain-IA. En conservant un code lisible et explicite, nous fournissons aux agents IA un modèle mental optimal. StartER devient ainsi le terrain de jeu idéal pour le prototypage et l'apprentissage rapides.

📚 Exemple de structure de projet Express + React simple et lisible

Ce projet présente une méthode simple et lisible pour structurer une application fullstack avec :

  • Backend Express
  • Frontend React
  • Contrats partagés pour l'API

Si vous recherchez un "starter Express + React" ou un "boilerplate Node React", ce dépôt est un exemple pratique.

⚡ Démarrage Rapide

# 1. Cloner le projet (ou utiliser le bouton "Use this template")
git clone https://github.com/rocambille/start-express-react.git mon-projet
cd mon-projet

# 2. Installer les dépendances et initialiser la base de données
npm install
cp .env.sample .env
npm run database:sync

# 3. Lancer l'application
npm run dev

L'application est disponible sur http://localhost:5173

✨ Pourquoi le prototypage avec StartER est plus rapide

🧬 Clonage de modèles plutôt qu'hallucination

Ne laissez pas l'IA "deviner" votre architecture. Utilisez make:clone pour répliquer la logique fonctionnelle.

npm run make:clone -- src/express/modules/item src/express/modules/task item task

Cela garantit la cohérence en clonant vos modèles de code réels. Votre agent IA reste ainsi concentré et précis.

🧪 Vérification basée sur un contrat

Vous définissez le comportement de l'API dans tests/contracts.ts : une source de vérité centrale et déclarative.

  • Pour vous : une documentation claire et évolutive.

  • Pour l'IA : un "contrat" strict qu'elle doit respecter lors de la génération des endpoints.

  • Pour l'application : vérification instantanée que l'IA n'a omis aucun scénario.

🔍 Simplicité sans magie

  • SQLite synchrone : accès direct aux données que l'IA peut lire et écrire sans confusion avec async/await.

  • Conversion explicite : typage des données aux emplacements clés. Ceci évite les bugs silencieux souvent introduits par l'IA.

  • Stack transparente : Express 5 + React 19. Aucune boîte noire. Vous comprenez chaque ligne.

💻 Stack technique

  • Backend : Node.js, Express 5, Zod (validation)
  • Frontend : React 19, React Router, Vite, Pico CSS
  • Database : SQLite (zero-config, API synchrone)
  • Tooling : TypeScript, Biome, Vitest, Docker

📖 Documentation

StartER est un projet pédagogique. Si cette architecture vous aide à prototyper plus rapidement avec l'IA, laissez-nous une ⭐ sur GitHub !

👉 Consultez le wiki et le modèle mental de l'IA

📄 Licence

Distribué sous licence MIT. Vous êtes libre de l'utiliser, de le modifier et de le redistribuer à des fins éducatives ou professionnelles.