BuildSpace design system / v2.0
A system for
building better.
Warm canvas. Clear rules. Considered components. The foundations of BuildSpace, ready for people and the agents they build with.
React + Tailwind CSS + shadcn/ui. Yours to build with.
01 / The library
Find your next building block.
Start small or start with a whole pattern. Every preview links to an install command and a plain-markdown guide.
Components
The everyday pieces. Buttons, forms, feedback, and brand primitives.
Blocks
Composed patterns. Settings, data tables, navigation, and AI chat.
Charts
Six chart types, usage meters, and one consistent data language.
Loading
Brand loaders and chart skeletons. Motion only while something waits.
A working specimen / Illustrative
Quiet UI.
Real interaction.
A single mint field frames a paper surface. Try the controls: these are the same components you install.
02 / Foundations
Less decoration. More intention.
Canvas and ink carry the page. Color has a job. Type does the talking. Click a color to copy its value; download the full token set for your tools.
Neutrals / The foundation
About 90% of the page.
Field / Choose one
Mint is the default. Never four fields on one screen.
Shape / Inside drawings only
Not card fills or text colors.
Four voices. One hierarchy.
Clear by design.
Bricolage Grotesque leads. Instrument Sans explains. DM Serif Display adds one italic phrase, in the same ink. JetBrains Mono annotates.
Read the type rules- Display / Bricolage Grotesque800 · −4.5% · 0.98
- Aa Bb 0123
- Body / Instrument Sans400–600 · 1.5
- Built around the way you work.
- Accent / DM Serif Display400 · Italic only
- A little character.
- Label / JetBrains Mono10.5px · +8% · Uppercase
- FIG. 02 — TYPE SPECIMEN
03 / The drawing language
Simple forms. Distinct identity.
Six CSS modules, a 1px ink outline, and a drawing grid. Use glyphs for identity and Lucide at 1.5px for actions. Keep the grid inside the figure.
arch01
block02
quarter03
circle04
pill05
steps06
No 3D, stickers, tilt, or decorative shadows. Structure is the expression.
Use the Glyph10px
Controls
Inputs, selects, and textareas.
16px
Product cards
Cards, menus, and dialogs.
24px
Field bands
One calm color moment.
04 / Motion
Waiting, with an identity.
The block mark builds, the elevation is drafted, and charts hold their shape while data arrives. CSS-only, hidden for the first 200ms, and still under reduced motion.
05 / Brand assets
One name. A shared signature.
Lowercase Bricolage, a violet dot, and room to breathe. Write BuildSpace in copy. The violet brand signature follows the current buildspace.tech assets.
Choose Light for light backgrounds and Night for dark. Do not redraw, stretch, recolor, or add shadows.
06 / Build with it
From reference to running UI.
Start with a Tailwind v4 project initialized with shadcn/ui. Register the namespace, load the fonts, install the theme, then add only what you need.
1. Register the namespace
Merge into your existing components.json. This resolves the dependencies of blocks and components.
{
"registries": {
"@buildspace": "https://ui.buildspace.studio/r/{name}.json"
}
}2. Load the four fonts
The theme sets font families, not font downloads. Use next/font in Next.js, or place this at the top of your CSS, before other rules.
3. Install the theme
Restyles stock shadcn components in place. Includes semantic colors, accent families, type roles, and Night mode.
4. Add what you need
Install individual items. Source files stay in your project; no private packages or backend wiring.
Already using Ink & Paper? v2 replaces its theme. Commit your changes first, review CSS overrides, and replace old 3D imagery. Other apps are not migrated automatically.
Read migration notes →07 / For agents
Same system.
No guesswork.
A human-readable showcase and a machine-readable contract. Send your agent the rules, not a screenshot to interpret.
/design.mdVersioned YAML tokens and complete design guidance.The index/llms.txtEvery installable component and its dependencies.The tokens/tokens.jsonExact light, Night, and Tailwind theme values.The recipe/r/glyph.mdPer-item install guide. Replace glyph with any item name.