Skip to content

Reference

CLI

The neoncite CLI installs inspectable source into your application. Components, Blocks, and dark themes share the same registry transport; there is no hidden runtime renderer.

Current coordinated release: 0.2.0

init

Bootstrap Neoncite in the current project: create neoncite.json, install shared utility dependencies, scaffold cn(), and wire the Neoncite Tailwind v4 theme into the detected global stylesheet.

$bash
npx neoncite@latest init

init -y

Run initialization non-interactively with the default @/components and @/lib/utils destinations.

$bash
npx neoncite@latest init -y

add <item...>

Install UI components, registry Blocks, or dark theme items. Neoncite resolves registry dependencies recursively, installs npm dependencies, preserves nested Block paths, and rewrites internal imports to local relative paths.

$bash
npx neoncite add button combobox terminal
npx neoncite add telemetry-dashboard
npx neoncite add theme-ocean

add --all

Install every registry:ui component. Blocks and themes remain explicit installs so --all never writes an unexpected page/template or changes your chosen theme.

$bash
npx neoncite add --all -y

list

List every available registry item and its type (registry:ui, registry:block, or registry:theme).

$bash
npx neoncite list

diff <item>

Compare a locally installed registry item against upstream after applying the same path/import rewriting used during installation.

$bash
npx neoncite diff server-card

--version

Print the installed Neoncite CLI version.

$bash
npx neoncite --version

Inspect before you trust

Registry installs write source into your repository. You can inspect any item at/r/<item>.json before installing it, and use diff later to see local drift.