[feat] Modular Brandbook Versioning & Automation for KU6K

[cto-new]

Summary

This PR introduces a comprehensive modular brandbook architecture for the KU6K design system, implementing independent semantic versioning for each module and automated change tracking and version bumping workflow.

Details

• Introduced modular structure for brandbook modules: color-tokens, color-tokens-dark (dark mode), typography, iconography, logos-wordmarks, brand-voice, and design-guidelines.
• Implemented per-module package.json with semantic versioning, changelogs, and module documentation standards.
• Global brandbook versioning via ku6k-brandbook package for milestone releases.
• Automated GitHub Actions workflow for module-level and global version bumps, changelog updates, and git tagging.
• Added scripts for version consistency checks and automated version bumps with impact assessment.
• Added comprehensive documentation: versioning-strategy, module guidelines, migration guides, and summary table.
• Standardized CSS custom properties (--ku6k- prefix) for all tokens, including dark mode as a separate module.
• Updated main package.json with brandbook management scripts and improved metadata.
• Updated all modules with initial CHANGELOG.md files, passing lint and type checks.

Why

• Establish clear and scalable version control for each design system module.
• Enable parallel, non-breaking evolution of system foundations (color, type, icons, etc.).
• Ensure robust, automated release flows and changelog transparency via CI and local scripts.
• Document best practices, migration, and compatibility to support sustainable growth of the KU6K design system.

Testing

• Ran brandbook:version-check to validate all module versions, changelogs, and tags (all checks passing).
• Passed Biome linting, formatting, and TypeScript type checks.
• Performed pnpm run build and full Next.js build (all modules and app compile correctly).
• Ran dry-run version bump script for CI validation.

Breaking Changes

• None

---

See included documentation (brandbook/docs/) for full strategy, migration guidelines, and usage examples. All changes comply with KU6K Essential UI system standards, and future module updates will follow the established process.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
icons	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Aug 5, 2025 11:39am