create-ekd-react
v1.0.4
Published
CLI pour créer des projets React modernes avec une configuration optimisée
Maintainers
Readme
ekd-react-vite - Créateur de Projets React Modernes
create-ekd-react est un outil d'aide au développement (CLI) conçu pour automatiser et standardiser la création de projets React, en offrant une configuration moderne et optimisée dès le départ.
Contexte et Besoin (Le "Pourquoi")
Ce projet a été créé pour résoudre plusieurs problèmes récurrents lors du démarrage d'un nouveau projet web :
- Perte de temps au démarrage : Les développeurs passent un temps considérable à installer et configurer les mêmes outils pour chaque nouveau projet : TypeScript, un routeur (React Router), un outil de style (Tailwind CSS), une librairie de composants (Shadcn/ui), un gestionnaire de state (Zustand), etc. Ce processus est fastidieux et source d'erreurs.
- Manque de standardisation : Il est difficile de maintenir une configuration cohérente entre les différents projets, que ce soit au sein d'une équipe ou pour un développeur travaillant seul.
- Complexité de la configuration : L'intégration de certains outils peut être complexe. Faire fonctionner harmonieusement Tailwind CSS, Prettier et ESLint, par exemple, demande une expertise spécifique.
L'objectif de create-ekd-react est donc d'agir comme un assistant personnel qui pose les bonnes questions et génère une base de code prête à l'emploi, intégrant les meilleures pratiques et les outils les plus populaires de l'écosystème React.
Analyse du Projet (Le "Comment")
Architecture Générale
Le projet est un générateur de code (scaffolding tool) basé sur Node.js et écrit en TypeScript. Son fonctionnement repose sur deux piliers :
- Un CLI interactif : Il utilise la librairie
inquirerpour poser une série de questions à l'utilisateur afin de personnaliser le projet à générer. L'usage dechalkpermet de rendre l'interface plus agréable et lisible. - Un système de templates : Le projet contient un dossier
templatesqui stocke des morceaux de code et des fichiers de configuration pré-établis. En fonction des réponses de l'utilisateur, le script assemble ces "briques" pour construire l'architecture du nouveau projet.
Fonctionnalités Clés
- Choix du socle technique : L'utilisateur peut choisir entre Vite (léger et rapide, recommandé) et Next.js (plus complet, orienté full-stack).
- Support de TypeScript : Intégration automatique de TypeScript pour un code plus robuste.
- Gestionnaire de paquets : Détecte et laisse le choix entre
npm,yarn,pnpmetbun. - Intégration d'outils "à la carte" :
- Styling : Tailwind CSS.
- Composants : Shadcn/ui (qui dépend de Tailwind).
- Routing : React Router.
- Gestion de formulaires : React Hook Form avec Zod pour la validation.
- Gestion de données asynchrones : TanStack Query (React Query).
- Gestion d'état global : Zustand.
- Icônes : Lucide ou Heroicons.
- Qualité de code : Configuration automatique d'ESLint et Prettier pour garantir un code propre et formaté.
Processus de création
- Pose les questions à l'utilisateur.
- Affiche un récapitulatif pour confirmation.
- Crée le dossier du projet.
- Lance les commandes de base (
npm create vite@latest,npx create-next-app, etc.). - Copie les fichiers depuis le dossier
templatespour ajouter les fonctionnalités choisies. - Met à jour le
package.jsonavec les bonnes dépendances. - Lance l'installation des dépendances (
npm install,yarn, etc.). - Affiche les instructions finales pour lancer le projet.
