Guides

Guides for shipping premium UI

Practical, opinionated walkthroughs for building with Nova.

Every guide is written to be finished in one sitting. Pick a topic, follow the code, and end with something you can ship.

Learning paths

View all paths →

All guides

14 of 14
Foundations•Beginner•3 min

Installing Nova in a fresh app

Wire Nova into Vite, Next, Remix, or Astro in under three minutes — including Tailwind v4 setup and the theme provider.

Read guide
Foundations•Beginner•6 min

Ship your first component

Compose a Card + Button + Badge, learn the polymorphic `asChild` pattern, and understand where variants live.

Read guide
Theming•Intermediate•9 min

Theming with OKLCH tokens

Rebrand the entire library by editing a handful of CSS variables — plus the perceptual reasoning behind OKLCH.

Read guide
Theming•Intermediate•7 min

Building a delightful dark mode

Cross-fade transitions, system detection, per-surface elevation, and the pitfalls of naïve inversion.

Read guide
Motion•Intermediate•8 min

Nova's motion language

When to use `snap`, `soft`, and `glide` springs — and how signature effects (Halo Hover, Press Sink) compose.

Read guide
Accessibility•Intermediate•5 min

Respecting reduced motion

A pragmatic checklist: what to animate, what to disable, and how to still feel alive when motion is off.

Read guide
Accessibility•Intermediate•6 min

Keyboard-first interfaces

Focus rings, roving tabindex, escape hatches, and the exact shortcuts users expect from every primitive.

Read guide
Accessibility•Advanced•10 min

Running an accessibility audit

How Nova ships WCAG AA by default — and how to run `axe`, keyboard, and screen-reader passes on your own compositions.

Read guide
Performance•Advanced•8 min

Keeping your bundle small

Tree-shaking with `sideEffects: false`, avoiding barrel-file traps, and measuring per-component cost.

Read guide
Composition•Intermediate•7 min

Composition over configuration

Prefer slotting Nova primitives together over adding one more prop — with worked examples for Cards and Menus.

Read guide
Composition•Intermediate•12 min

Assembling a dashboard shell

Sidebar, topbar, command palette, and a scroll-locked content area — the anatomy every SaaS app repeats.

Read guide
Composition•Advanced•9 min

Designing a great ⌘K experience

Scoring, recents, keyboard flow, and the tiny details that make a palette feel Raycast-fast.

Read guide
Tooling•Beginner•5 min

The Nova CLI workflow

`init`, `add`, `diff`, `doctor` — how to use the CLI to keep components healthy across releases.

Read guide
AI•Advanced•11 min

Designing for AI surfaces

Streaming halos, thinking states, citations, and the ergonomics of a copilot that lives inside your app.

Read guide

Have a guide idea?

Open a request and we'll consider it for the next docs pass.

Suggest a guide