granularity

🌐 Live showcase: https://efureev.github.io/granularity/  · 

Monorepo for the @feugene/granularity design system — a Vue 3 package with components, styles, and a UnoCSS preset that supports granular subpath exports.

Contents

• packages/granularity — the published @feugene/granularity package.
• packages/granularity-* — companion packages: charts, chrono, dashboard, test-kit.
• apps/showcase — live component showcase, deployed to GitHub Pages.
• apps/playground* — sandboxes for integration scenarios (not published, not covered by CI).

Which component do I reach for? docs/COMPONENT-MAP.md answers that across every package at once: forks that ask the distinguishing question first, then an alphabetical index of all 85 components.

Requirements

• Node.js >= 22
• Yarn 1.22.x (Classic, see packageManager in the root package.json)

Quick start

yarn install
yarn build:granularity     # build the package
yarn test:granularity      # run package tests
yarn dev:showcase          # run the showcase locally

Release

• Packages are published to npm and GitHub Packages by GitHub Actions. The core releases on v* tags; every companion has its own tag and its own cycle — granularity-charts-v*, granularity-chrono-v*, granularity-dashboard-v*, granularity-test-kit-v*, unplugin-granularity-v*.
• There is no changelog at the repository root: each package keeps its own, next to its package.json. Start with packages/granularity/CHANGELOG.md.
• See CONTRIBUTING.md for the workflow.

License

Apache License 2.0 © Evgeniy Fureev