@alligatorsgroup/bayou

Bayou, le design system du groupe Alligators, distribué en release immuable.

« Un business. Un système. Un centre. »

Installer une version exacte

npm install --save-exact @alligatorsgroup/[email protected]

Jamais latest, jamais ^, jamais 1.x : une release ne se propage qu'avec un bump explicite du repo consommateur.

Profil A — application avec build

import "@alligatorsgroup/bayou/styles.css";
import { checkAdherence, checkCopy } from "@alligatorsgroup/bayou/adherence";

Profil B — chemins publics historiques (/brand/styles.css)

{
  "scripts": {
    "bayou:prepare": "bayou-export --to public/brand",
    "predev": "npm run bayou:prepare",
    "precheck": "npm run bayou:prepare",
    "prebuild": "npm run bayou:prepare"
  }
}

Le dossier généré s'ignore dans Git : il n'est pas une deuxième source éditable. bayou-export --check vérifie un export existant sans rien écrire.

Profil C — surface sans build

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@alligatorsgroup/[email protected]/styles.css" />

Une URL à version exacte est immuable et peut être cachée un an. Une URL mutable (@latest, @1) est interdite en production.

Ce que le package contient

• styles.css — le point d'entrée (n'agrège que les @import de tokens) ;
• tokens/*.css — palette, typographie, espacements, rayons, élévation, motion, alias sémantiques, matières, base ; tokens/fonts.css charge les trois webfonts depuis Google Fonts : c'est la seule dépendance réseau au runtime. Sous CSP, autorise fonts.googleapis.com et fonts.gstatic.com ;
• assets/* — l'Œil, Clovis, les quatre glyphes alchimiques, les logos ;
• adherence — checkAdherence() / checkCopy(), les règles exécutables de la même release que les tokens ;
• contract.json — tokens, matières, assets, règles et checksums publiés ;
• version.json — { name, version } pour l'afficher dans un écran produit ;
• bin/bayou-export.mjs — le CLI d'export.

Ce que le package ne contient pas : pages de démonstration, templates, slides, UI kits, composants React, doctrine. Ceux-là passent par le MCP Bayou (https://alligatorsgroup.com/api/mcp) et le site.

Doctrine

Le package est le canal technique. Le MCP reste le canal doctrinal : lis bayou_overview avant de produire, et fais tourner bayou_check_adherence / bayou_check_copy avant de livrer.

🜃 Alligators Group — Un business. Un système. Un centre.