Muse Design System

Component Experiment

Tokens and components reconstructed from the Muse writing analytics dashboard. Everything here resolves through @muse/css/tokens.css — no component contains a literal design value.

Live

Component gallery

Every component in every state — including hover, focus, disabled, loading, empty and error. Has a light/dark toggle.

Open →

Live · React

@muse/react primitives

Phase 1 components with demos, prop tables and copyable code. Behaviour from Base UI, paint from @muse/css.

Open →

Reference

Documentation

foundations.md — color, type, space, motion
patterns.md — states, a11y, chart rules
decisions.md — what changed and why
conflicts.md — every value that moved
tokens.json — machine-readable

Markdown serves as plain text — read them in the editor for formatting.

Consuming the library

import '@muse/css'
<body class="muse-app">

Override tokens after the import — never edit component files. Switch themes by stamping the root: <html data-theme="light">.