/ Blog

Updates & Thinking

Technical writing, design decisions, and release notes from the Sigil UI team. How tokens, presets, and compositional rules produce consistent interfaces at any scale.

Launch

Introducing Sigil UI

The token-driven design system that replaces scattered Tailwind overrides with a single source of truth. One file, 519 tokens, 46 presets.

Design

Why Presets Beat Themes

Traditional libraries give you components. Sigil gives you components plus a complete visual identity you can swap in one command.

Architecture

The Alignment Rail System

How margins, gutters, and content widths compose into a structural grid that adapts from mobile to ultrawide.

Guide

Migrating from shadcn/ui

A step-by-step guide to moving from shadcn/ui to Sigil. Keep your components, gain token control.

AI

Building with Agents

How AI agents use sigil.tokens.md as a contract. One file, deterministic visual output, no drift.

Design

The OKLCH Color System

Why we chose OKLCH for all 35 color tokens. Perceptual uniformity, P3 gamut, and predictable dark mode.

Deep Dive

Anatomy of a Preset

What goes into a preset's 519 tokens across 33 categories. From colors to motion to code block syntax highlighting.

Architecture

The Playbook Pattern

Ten compositional rules that make any page 'just work'. Gap-pixel grids, mono labels, border stacks, and density DNA.

Stay in the loop.

New presets, components, and design thinking — delivered when we ship, not on a schedule.

Studiodefault
Presets
primary
secondary
background
surface
text
border
accent
success
warning
error
info
display
body
mono
heading wt
600
heading trk
-0.025em
base size
16px
page margin
24px
section pad
64px
card pad
24px
grid gap
24px
stack gap
12px
global
8px
button
8px
card
12px
input
6px
border w
1px
style
card border
card shadow
btn shadow
glow
spring
Type
Duration
0.20
Bounce
1.00
easing
cubic-bezier(0.16, 1, 0.3, 1)
fast
150ms
normal
200ms
slow
300ms
hover scale
1.02
press scale
0.98
hover lift
-1px
stagger
50ms
weight
transform
hover
active scale
0.98
min-width
0px
letter sp
0.000em
icon gap
8px
shadow
hover
border
shadow
padding
24px
title size
1px
title wt
desc size
0.875px
aspect
outline
height
36px
focus ring
2px
focus ring
h1 size
2.25px
h2 size
1.875px
h3 size
1.5px
h4 size
1.25px
weight
tracking
-0.020em
leading
1.20
pattern
pattern α
0.03
noise
gradient
grad angle
180°
height
50px
blur
12px
border
padding
24px
item gap
24px
min-height
600px
padding Y
80px
content-max
680px
layout
title size
56px
desc size
18px
padding Y
64px
max-width
600px
layout
title size
36px
padding Y
48px
columns
4
gap
36px
content-max
1200px
rail-gap
24px
grid-cell
50px
cross-stroke
1.5px
navbar-h
50px
bento-gap
16px
grid lines
dots
cell borders
cell bg
Gutter
Margin
content
hero
navbar
rail visible
enabled