Une place pour chaque chose ...
Quand j’ai écris mes premières ligne de code il y a plus de 15 ans, je ne connaissais même pas git, j’avais juste un dossier par projet (dans le meilleur des cas 🫣). Au fil des années et de mes changements de machine, j’ai fini par perdre des jours, voir des semaines de travail.
Finalement quand j’ai découvert le web, j’ai commencé à nourrir l’idée d’un portail ou d’un portfolio pour rassembler tout ce que je faisais. Malgré tout, j’ai mis du temps à me lancer, et en toute transparence, Claude à mis un peu d’huile dans les rouages, ce qui a donné mon monorepo, et ce site qui en est la vitrine : une page d’accueil qui liste mes projets automatiquement, et peut-être bientôt plus d’articles comme celui-ci.
Ce qu’il y a dans le repo
C’est un monorepo pnpm (pratique pour les workspaces et le catalog pour synchroniser les versions des dépendances et faciliter les mises à jour) et piloté par Turborepo.
J’ai d’un côté apps/, avec un dossier par projet : mes fronts, une API partagée (api), et home, le site sur lequel vous êtes. Et de l’autre, packages/, pour le code partagé : le thème Mantine (theme), des petites briques pour les projects d’éditeurs de cartes 2D et 3D et les configs TypeScript et Jest.
Le portail
Cette vitrine est un site Astro statique, qui liste automatiquement les projets et les articles à partir de deux sources :
-
Les projets. Au build,
apps/*est passé en revue et on retient tous les dossiers dont lepackage.jsona un champportal, qui est un objet dans lequel je stocke la métadonnée des projets. -
Les articles. Ce sont les fichiers Markdown de
src/content/blog/, déclarés comme collection Astro (titre, description, dates). Celui-ci en fait partie.
Tout lancer d’un coup
En dev
La première fois, il faut installer les dépendances et brancher le hook Biome sur les commits :
pnpm install
pnpm setup:hooks # à faire une fois : branche le hook Biome sur les commits
pnpm dev
pnpm dev appelle turbo run dev, qui lance en parallèle le script dev de chaque projet, qui tourne sur un port dédié et avec en bonus côté frontend, un proxy Vite qui renvoie /api vers localhost:3000.
Si je ne veux qu’un seul projet (avec ses dépendances), c’est facile avec --filter :
pnpm --filter saassify dev
pnpm --filter api dev
Et en prod
Chaque frontend est builé avec une base Vite à /<nom>/, ce qui permet de le ranger dans un sous-dossier du site sans casser les chemins des assets :
pnpm build:site
La commande se fait en deux temps :
turbo run build --filter=!apibuildhomeet tous les frontends, dans l’ordre des dépendances (dependsOn: ["^build"]). Ce qui n’a pas bougé vient du cache et je gagne du temps.- Un script copie ensuite le
dist/de chaque projet dansapps/home/dist/<nom>/, puis génère un_redirectspour netlify, pour que les URL internes des SPA retombent sur leurindex.html.
On obtient apps/home/dist, un seul site statique qui contient tous les projets. Pour le parcourir en local, n’importe quel serveur statique fait l’affaire (npx serve apps/home/dist).
Mise en ligne
- Netlify pour le front. A chaque push sur main, netlify run
pnpm build:siteet publieapps/home/dist. - Railway pour le back et la base de données. Même principe à, chaque push sur main, une image Docker est construite, elle juste pour mon app
apiet ses dépendances (pnpm install --filter api...).
Au final, ajouter ou modifier un projet, c’est toujours la même recette et en deux minutes c’est en prod pour 5$ par mois.