Introduction

What Optimistic is, why it exists, and what's inside.

v1.0.0·Updated Jul 10, 2026 · 23:00
Welcome

Optimistic is a dark-first, token-driven design system for building interfaces that feel fast and honest. It is headless and plug-and-play: one set of tokens and components that ships to React, Angular and plain HTML, documented so both people and AI can extend it. This page is the short version. When you are ready to build, head to How to Use.

Why it is called Optimistic

The name comes from the optimistic update, the engineering pattern where an interface shows the result of an action the instant you take it, then quietly reconciles with the server. It carries three meanings from the Latin optimus: the optimist's belief, the optimistic-update method, and the optimum result. One line: assume the best outcome, then ship it. The whole system is built in that temperament, and the philosophy tells the long story.

What is inside
Tokens as the source of truth

Every colour, size, space and type style is a token. A generator turns them into CSS variables, so one change moves the whole system at once. Nothing is hard-coded.

Eight foundations

Colour, typography, spacing, grid, elevation, border radius and breakpoints. The short vocabulary every component is built from.

A component library

Documented pieces with a live demo, an engineering contract, and copy-ready code. You own the source, shadcn-style, not a locked package.

Dark-first and monochrome

A near-black field with one warm accent (#FF7A00). Structure comes from hairlines and spacing, so a single warm element can carry the attention.

Multi-framework

The same tokens feed React, Angular and plain HTML, so the look stays identical wherever it ships.

Built to be read by AI

Named for its role, structured and documented so an assistant can extend it without guesswork. It is made to be worked on with Claude.

Where to start
01Read the philosophy. The name is the method. See why an interface should render the result first and reconcile after. Open ↗
02Follow How to Use. System requirements, install steps, and how to consume every foundation with var(--token). Open ↗
03Explore the foundations. Start with the Color System, then Typography and Spacing. Each page is a short, practical reference. Open ↗
04Compose with components. Buttons, inputs, navigation and more, each with a live demo and copy-ready code. Open ↗