Introduction

Lorre Blocks is a design token + component registry: Radix-style token/theme architecture, shadcn-style distribution. The CLI copies component source into your project — you own and edit every line.

Quickstart

1. 1. Initialize your project (Tailwind v4 required)

   Writes components.json, installs base dependencies, adds the cn() helper and injects your theme's tokens into the global CSS.

   npx lorre-blocks init --theme basic

2. 2. Add components

   Dependencies between components resolve automatically — date-picker pulls in calendar, popover and button on its own.

   npx lorre-blocks add button card date-picker

3. 3. Change your mind about the look

   Themes are token values, not component forks. This swaps the whole look and touches zero component files.

   npx lorre-blocks theme apply dreamy

Where next

• Theming — the three themes and the OKLCH token architecture behind them.
• CLI reference — every command, including the --json contract agents build on.
• Components — live previews, source and install snippets for every registry item.