Get started

Installation

Neoncite ships components as source files into your repo via a CLI, giving you ownership of the installed component code while keeping the design tokens and local aliases predictable.

1. Initialize

Creates neoncite.json, installs the shared utility dependencies, scaffolds cn() when missing, and wires the Neoncite Tailwind v4 theme into the detected global stylesheet. Use -y for non-interactive defaults.

$terminal

npx neoncite@latest init -y

2. Add a component

Resolves registry dependencies, installs required npm packages, rewrites internal imports to your configured aliases, and writes component source under @/components/neoncite with the default configuration.

$bash

npx neoncite@latest add button

3. Use it

<>App.tsx

import { Button } from "@/components/neoncite/button"

export default function App() {
  return <Button variant="primary">Ship it</Button>
}

Requirements

• React 18 or 19
• Tailwind CSS v4
• A TypeScript alias where the default @/ resolves to src/, or equivalent custom aliases configured during init