vtt.bzh — Monorepo
Site statique du calendrier des randonnées VTT de Bretagne.
Structure du monorepo
www-vtt-bzh/
├── www/ # Site Jekyll (Jekyll 4, CSS natif BEM, Vanilla JS)
├── packages/
│ ├── type/ # Types utilitaires partagés (Result, Maybe, error)
│ ├── repository/ # Abstraction Supabase
│ └── calendar/ # Types CalendarEvent + script generate-events → artefact privé
├── supabase/
│ ├── migrations/ # Migrations SQL (RLS, schéma)
│ └── functions/ # Edge Functions (soumission contrôlée, notif modération)
├── scripts/ # Scripts utilitaires Node (backup, ad-hoc)
├── configs/
│ └── tsconfig/ # tsconfig.json de base partagé (node)
├── .github/workflows/ # CI GitHub Actions (contrôles, build et déploiement)
├── eslint.config.mjs # Config ESLint racine (flat config)
├── .stylelintrc.json # Config Stylelint racine
├── .prettierrc.js # Config Prettier racine
└── package.json # Scripts racine, devDependencies partagées
Packages
| Package | Description |
|---|
www | Site Jekyll — layouts Liquid, CSS BEM, JS ES modules |
type | Types utilitaires TypeScript : Result<T,E>, Maybe<T>, helpers d'erreur |
repository | Abstraction Supabase : createClient, updateOrCreate |
calendar | Types CalendarEvent + script generate-events → artefact de build privé depuis Supabase |
tsconfig | Configs TypeScript de base partagées |
Prérequis
- Node.js 24.x
- pnpm 10.x (
corepack enable)
- Ruby (
rbenv ou .ruby-version) — pour le site Jekyll
Démarrage rapide
git clone https://github.com/jn-prod/www-vtt-bzh.git
cd www-vtt-bzh
corepack enable
pnpm install
Scripts racine
| Commande | Description |
|---|
pnpm dev | Lance le dev de tous les packages (Jekyll serve) |
pnpm build | Build packages → événements + dernière édition de La Sortie → Jekyll |
pnpm build:preview | Build complet + serveur HTTP local sur www/_site/ |
pnpm build:e2e | Build Jekyll isolé avec 41 événements fictifs pour les E2E |
pnpm build:www | Build Jekyll uniquement |
pnpm build:packages | Compile tous les packages TypeScript |
pnpm build:la-sortie | Extrait la dernière édition du flux RSS pour Jekyll |
pnpm newsletter:new | Génère un brouillon Markdown pour La Sortie depuis Supabase |
pnpm test | Tests de tous les packages |
pnpm test:e2e | Parcours Playwright et contrôles Axe |
pnpm validate:html | Validation du HTML généré |
pnpm validate:site | Liens, assets et invariants métier du site généré |
pnpm check:privacy | Denylist et données personnelles (secret PRIVACY_DENYLIST en CI) |
pnpm minify:site | Minification conservative du HTML généré |
pnpm check | Chaîne locale complète, hors installation |
pnpm lint | ESLint + Stylelint + Prettier (vérification) |
pnpm lint:fix | ESLint + Stylelint + Prettier (auto-fix) |
pnpm lint:eslint | ESLint uniquement |
pnpm lint:stylelint | Stylelint uniquement |
pnpm lint:prettier | Prettier uniquement |
CI/CD
Le workflow de publication conserve la production précédente dès qu'un contrôle échoue.
Les parcours Playwright et contrôles Axe tournent sur chaque pull request et avant chaque déploiement,
et se lancent en local avec pnpm test:e2e (ou pnpm check). Ils ne lisent pas Supabase : la commande construit
www/_site-e2e/ avec 41 événements fictifs, puis restaure l’artefact réel.
github-pages.yml — Déploiement (push main ou manuel)
- Installation verrouillée des dépendances Node et Ruby
- Lint et tests unitaires
- Build : Supabase → normalisation → artefact non versionné → Jekyll
- Validation HTML, liens, assets et invariants métier
- Déploiement GitHub Pages (
peaceiris/actions-gh-pages, CNAME www.vtt.bzh)
Les organisateurs soumettent une randonnée via /calendrier/ajouter.html. L'Edge Function submit-event valide le payload, fixe les champs système et applique la limitation de débit avant l'insertion Supabase. La publication statique est reconstruite quotidiennement et après chaque push sur main.
Matière de newsletter locale
Lancer pnpm --silent newsletter:new -- --start=YYYY-MM-DD --end=YYYY-MM-DD depuis un environnement qui possède les variables Supabase. La commande écrit la matière dans le dossier Jekyll www/_drafts/ de vtt.bzh, ou dans NEWSLETTER_DRAFTS_DIR si cette variable est définie. Elle est regroupée par week-end et résume les volumes, départements et ajouts récents : sélectionner et contextualiser ensuite cette matière dans l'édition mensuelle de La Sortie, publiée de façon canonique sur nicolasjouanno.com/la-sortie/. L'archive, l'édito et l'appel aux retours vivent sur ce site ; vtt.bzh conserve le calendrier, les données et l'entrée d'acquisition.
Après relecture, l'envoi reste manuel dans Kit. La cible doit réunir les consentements issus des formulaires VTT.bzh visiteurs (9677378) et La Sortie sur nicolasjouanno.com (9378910) ; le tag historique agenda-mensuel ne doit pas servir seul de cible. Ne modifier ni abonnements ni consentements depuis ce dépôt.
Carte de la dernière édition
Le build lit le premier élément du flux public https://www.nicolasjouanno.com/la-sortie/feed.xml
et génère l’artefact ignoré www/_data/newsletters/latest.json. Jekyll l’intègre ensuite
statiquement dans le bloc d’inscription de la home : aucun contenu n’est chargé dans le navigateur.
Si le flux est indisponible ou invalide, le script produit une carte générique vers l’archive et ne
bloque pas la publication du calendrier. Les tests utilisent une fixture locale, jamais le réseau.
Secrets GitHub Actions requis
| Secret | Environment | Description |
|---|
SUPABASE_URL | github-pages | URL du projet Supabase |
SUPABASE_PUBLISHABLE_KEY | github-pages | Clé publique utilisée en lecture |
SUPABASE_TABLE | github-pages | Nom de la table des événements |
Tooling
- Gestionnaire de packages : pnpm 10 (workspaces)
- Linter JS/TS : ESLint 10 (flat config) +
typescript-eslint v8
- Linter CSS : Stylelint 17 +
stylelint-config-standard
- Formatter : Prettier 3
- Git hooks : Husky (confidentialité au push, programmation du push)
- TypeScript : ts-node (packages uniquement — pas de bundler côté site)
Documentation
