Démarrer avec DuploJS
DuploJS est un écosystème modulaire pour construire des projets TypeScript robustes, prévisibles et faciles à faire évoluer.
Cette page sert de point d’entrée rapide. Elle n’a pas vocation à remplacer les documentations complètes, mais à t’aider à savoir par où commencer selon ce que tu veux construire.
Le chemin le plus rapide
Pour démarrer un nouveau backend avec DuploJS, le plus simple est d’utiliser le boilerplate officiel.
👉 Démarrer avec le backend boilerplate
Le boilerplate fournit une base de projet déjà organisée, afin d’éviter de repartir de zéro à chaque fois. Il permet de se concentrer directement sur la logique métier, les routes, les contrats et la structure applicative.
En pratique, c’est le meilleur choix si tu veux :
- lancer rapidement une API ;
- partir d’une structure déjà pensée pour DuploJS ;
- éviter de refaire toute la configuration projet à la main ;
- découvrir l’écosystème dans un contexte concret.
Par quoi commencer ?
Je veux créer un backend
Commence par le boilerplate.
C’est le point d’entrée recommandé pour créer une application backend complète avec DuploJS. Il sert de base de travail pour structurer ton projet rapidement.
Je veux construire des APIs typées
Va vers la documentation HTTP.
Le package HTTP permet de construire des serveurs et clients HTTP avec une approche pensée pour TypeScript. C’est ici que tu trouveras les concepts liés aux routes, aux contrats, aux entrées, aux sorties et à la composition côté API.
Je veux utiliser les primitives TypeScript de l’écosystème
Commence par Utils.
Utils regroupe des primitives et helpers fortement typés. C’est utile pour écrire du code plus prévisible, composer des fonctions, manipuler des structures typées et réutiliser des briques communes dans différents projets.
Je veux créer des formulaires Vue typés
Regarde DuploJS Form.
Form est pensé pour créer des formulaires Vue structurés, typés et réutilisables. C’est utile quand tu veux organiser tes champs, tes règles de validation et ton flow de formulaire sans perdre la cohérence TypeScript.
Je veux organiser mes tests end-to-end
Regarde le package Playwright.
Ce package aide à structurer les tests end-to-end autour de concepts comme les sites, les pages et les composants. Il est utile lorsque tu veux éviter que tes tests Playwright deviennent difficiles à maintenir.
Je veux explorer tout l’écosystème
Tu peux parcourir l’organisation GitHub.
Tu y trouveras les packages, les boilerplates, les outils et les différents projets liés à DuploJS.
Résumé rapide
| Besoin | À utiliser |
|---|---|
| Démarrer un backend rapidement | Backend boilerplate |
| Construire des APIs typées | HTTP |
| Utiliser des helpers TypeScript robustes | Utils |
| Créer des formulaires Vue typés | Form |
| Structurer des tests E2E | Playwright |
| Voir tous les packages | GitHub DuploJS |
Exemple de parcours recommandé
Si tu découvres DuploJS, tu peux suivre ce chemin :
- Ouvre le backend boilerplate.
- Lance le projet localement en suivant son README.
- Observe la structure du projet.
- Consulte la documentation HTTP pour comprendre la création des routes.
- Ajoute progressivement les packages dont tu as besoin.
Tu n’es pas obligé d’utiliser tout l’écosystème d’un coup. DuploJS est modulaire : tu peux commencer avec une seule brique, puis intégrer le reste progressivement.
À retenir
Le boilerplate est le meilleur point de départ pour créer un nouveau projet.
Les documentations des packages sont là pour approfondir chaque partie de l’écosystème lorsque tu en as besoin.
Commence petit, utilise ce dont tu as besoin, puis compose progressivement les briques DuploJS selon ton projet.