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.

Structure du monorepo : les apps à gauche, les packages partagés à droite, reliés par workspace:* apps/ packages/ home Le portail et le blog frontends React/Vite 18mots / automata / conges-maxing saassify / tilemap-editor voxel-studio api NestJS portal lit le champ portal des apps briques partagées theme / editor-kit voxel-format / voxel-render configs typescript-config / jest-config workspace:* pnpm-workspace.yaml avec un catalog : une seule version par dépendance pour tout le monde
Les apps consomment les packages partagés, et le catalog garde les versions alignées.

Le portail

Cette vitrine est un site Astro statique, qui liste automatiquement les projets et les articles à partir de deux sources :

  1. Les projets. Au build, apps/* est passé en revue et on retient tous les dossiers dont le package.json a un champ portal, qui est un objet dans lequel je stocke la métadonnée des projets.

  2. 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 :

  1. turbo run build --filter=!api build home et 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.
  2. Un script copie ensuite le dist/ de chaque projet dans apps/home/dist/<nom>/, puis génère un _redirects pour netlify, pour que les URL internes des SPA retombent sur leur index.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:site et publie apps/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 api et ses dépendances (pnpm install --filter api...).
Déploiement : un push sur main déclenche le build du site sur Netlify et l'image Docker de l'API sur Railway git push sur main Netlify Railway turbo run build --filter=!api home + frontends assemble-site.mjs copie chaque dist/ et génère _redirects apps/home/dist / /18mots/ /saassify/ … /api/* → home → un dossier par projet → proxy vers Railway image Docker pnpm install --filter api... api NestJS sur le port 3000 Postgres la base de données navigateur
Un seul push, deux déploiements : le site statique d'un côté, l'API et sa base de l'autre.

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.