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
FoundationsBeginner3 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
FoundationsBeginner6 min

Ship your first component

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

Read guide
ThemingIntermediate9 min

Theming with OKLCH tokens

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

Read guide
ThemingIntermediate7 min

Building a delightful dark mode

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

Read guide
MotionIntermediate8 min

Nova's motion language

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

Read guide
AccessibilityIntermediate5 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
AccessibilityIntermediate6 min

Keyboard-first interfaces

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

Read guide
AccessibilityAdvanced10 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
PerformanceAdvanced8 min

Keeping your bundle small

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

Read guide
CompositionIntermediate7 min

Composition over configuration

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

Read guide
CompositionIntermediate12 min

Assembling a dashboard shell

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

Read guide
CompositionAdvanced9 min

Designing a great ⌘K experience

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

Read guide
ToolingBeginner5 min

The Nova CLI workflow

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

Read guide
AIAdvanced11 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