← All projects

@grimoirix/design

The shared look every Grimoirix tool is built from: tokens, components and the dark/light switch.

Design systemusable

The problem

Every Grimoirix product needs the same look — colours, type, components, the dark/light switch — without rebuilding it per product and without the products drifting apart.

What it does today

Tokens, base styles, the `gx-` component classes, a dark/light theme switch (about 1 KB, no dependencies) and a few shared React components, published as `@grimoirix/design` on the forge’s own npm registry. In use, unchanged, by this site and the other products.

Roadmap, in short

Grows as the products built on it need more shared pieces. A change lands here first, not copied into each product separately.

Self-host it

Not a service to host: `npm install @grimoirix/design` from the forge’s npm registry (public, no token needed), import the CSS and `theme.ts`/`components.tsx` as needed.

Facts

Repository