node-api-boilerplate

Pourquoi ça existe

Chaque projet Node commence par les mêmes trois jours de travail indifférencié : auth, validation, gestion d’erreurs, tests. Ce dépôt est ma réponse personnelle — le squelette que je déploie avant d’écrire la moindre ligne de logique métier.

Ce qui est inclus

• TypeScript en mode strict, du tsconfig à la dernière route
• Auth JWT avec rotation des refresh tokens, prête à l’emploi
• Une enveloppe d’erreur cohérente pour que les clients n’aient jamais à parser des exceptions
• Validation Zod à chaque frontière
• Une suite Vitest qui couvre les chemins critiques, pas les décoratifs

Démarrage rapide

Clonez, définissez deux variables d’environnement, et npm run dev vous donne une API documentée avec un flux d’authentification fonctionnel en moins d’une minute.

Philosophie

Un bon boilerplate gagne sa place en étant ennuyeux. Il n’y a aucune abstraction astucieuse ici — le code se lit comme la doc du framework lui-même, pour que la première chose que vous fassiez soit décrire votre domaine, pas décoder le mien.