À propos du projet

Cobogó est une grammaire visuelle brésilienne permettant de partager des relations de conception entre produits sans effacer l'identité de chacun. L'objectif est de permettre aux projets de réutiliser des décisions qui méritent de survivre — hiérarchie, état, rythme, lecture, focus et action — tandis que la typographie, la couleur, la proportion et la finition restent locales lorsqu'elles portent la voix du produit. Cobogó n'est pas un thème et ne nécessite pas que différents projets ressemblent à la même famille. La stack utilise Panda CSS comme moteur du système de design et Astro comme hôte de référence pour les sites statiques. Cobogó fonctionne comme un preset Panda opinionné avec des tokens et des recipes. L'installation se fait via npm à partir du dépôt GitHub, accompagnée de @pandacss/dev. La configuration implique de créer un fichier panda.config.ts important le preset Cobogó, de définir les couches CSS (reset, base, tokens, recipes, utilities) et d'utiliser les recipes exportées dans les composants Astro. Dans le SSG d'Astro, Panda extrait les styles lors du build, sans nécessiter d'application React dans le navigateur. Le preset fournit actuellement des tokens de couleur, de typographie, d'espace, de tailles, de points de rupture, de rayons et d'ombres, ainsi que les recipes suivantes : button, card, badge, input, alert, article, table et navLink. Le dépôt lui-même sert de démonstration : la page src/pages/index.astro utilise le preset Cobogó pour expliquer et montrer la grammaire visuelle. Le principe d'évolution du projet est de croître lorsqu'un projet réel rencontre une décision qui mérite d'être partagée ou lorsqu'une hypothèse de conception mérite d'être testée, en maintenant le système petit, prévisible et utile sans transformer la personnalité locale en norme globale.