Skip to content

0xbeam/leonardo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎨 leonardo β€” universal design system

Taste-driven, agentic-first design tokens. One source of truth for color, typography, spacing, and motion β€” pushed into every app with a single command.

CSS Custom Properties Node.js Tailwind 4 Zero Deps

Features

Feature Description
Single source of truth All tokens live in tokens/*.json, compiled to CSS custom properties
Multi-app push --push injects tokens between LEONARDO-START / LEONARDO-END markers in every connected app
Dry-run diffs --diff previews exactly what would change before writing
Tailwind v4 output Generates both leonardo.css and leonardo-tw4.css
App-specific extensions Override tokens per-app via extensions/
Zero dependencies Just Node.js β€” no build tools, no bundler

Quick Start

node build.js           # build dist/ from tokens
node build.js --push    # build + inject into all connected apps
node build.js --diff    # dry run β€” see what would change

Token Overview

Token File Details
Color tokens/color.json Forest green accent #2A7A5B, warm neutrals, semantic palette
Typography tokens/typography.json Cormorant Garamond (display), DM Sans (body), DM Mono (labels)
Spacing tokens/spacing.json Consistent spatial scale
Motion tokens/motion.json Easing curves & duration tokens

Connected Apps

App Framework CSS Target
Fermi Ops Vite + TW4 src/index.css
Feedback Hub Vite + TW4 src/index.css
Brane Vite + TW4 src/index.css
Leonardo Notes Next.js + TW4 src/app/globals.css
MiroFish Vite + TW4 src/index.css

Configure targets in apps.json.

Structure

tokens/           JSON token definitions
extensions/       app-specific overrides
dist/             compiled CSS (leonardo.css, leonardo-tw4.css)
apps.json         connected app registry
build.js          compiler + injector

Design Philosophy

Editorial minimal. Quiet confidence. Information-dense without feeling crowded.

Axis Choice
Palette Warm neutrals + single forest green accent #2A7A5B
Type Serif headlines (Cormorant Garamond), sans body (DM Sans), mono labels (DM Mono)
Decoration None β€” no gradients, no illustrations, no blobs. Texture from typographic contrast + subtle noise
Mood Calm, precise, trustworthy β€” like a well-typeset journal
References Linear (density), Notion (editorial calm), Stripe (typographic precision)

Stack

Node.js Β· CSS Custom Properties Β· Tailwind v4 Β· JSON tokens

License

MIT

About

🎨 Universal design system β€” taste-driven, agentic-first. Tokens for color, typography, spacing, motion.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors