Runtime implementation repository for the Core product-family design system.
- Product semantics, UX rules, token meaning and canonical design decisions live in
CoreLinkPlatform/product-planning/design/system. - This repository owns the runtime package, Storybook, tests, consumer intake and component lifecycle evidence.
The design system is intentionally maintained as one package:
@corelinkplatform/design-system
Install from GitHub Packages, then import the stable runtime:
import { Button, Card, PageHeader } from '@corelinkplatform/design-system';
import '@corelinkplatform/design-system/styles.css';The root entry currently includes the runtime stylesheet for compatibility. The explicit CSS export is recommended so consumers document the dependency. Experimental motion styles are opt-in:
import '@corelinkplatform/design-system/experimental/styles.css';Published artifacts contain compiled ESM, TypeScript declarations and runtime CSS under dist/.
src/
├── components
├── tokens
├── icons
├── themes
├── experimental
└── index.ts
- One package until independent release boundaries are justified.
- Shared semantic tokens instead of product-specific styling.
- Consumer jobs and evidence drive component scope.
- Product compositions stay in products until a reusable contract is proven.
- RTL/LTR, accessibility, themes and reduced motion are release quality.
- Maturity lifecycle and promotion gates
- Current component maturity matrix
- Consumer evidence
- Decision log
- Contribution guide
Requires Node.js 22 or newer and pnpm 10.
pnpm install --frozen-lockfile
pnpm tokens:check
pnpm lint
pnpm test
pnpm package:check
pnpm storybook:buildpackage:check builds the distributable artifact, verifies every public export target and inspects the package tarball before publication.
Alpha foundation. Runtime implementation follows the canonical Product Planning specification and the evidence-backed maturity process in this repository.