Beta modeInstall commands on this page use lvcn@beta, which installs from the beta registry and may change before the stable release.What’s in beta

CLI

Use the lvcn CLI to initialize projects and add components.

The lvcn CLI is the command-line tool for Expo projects.

init

Use init to create a new project or configure an existing one.

npx lvcn-ui@latest init

Create a new project by name:

npx lvcn-ui@latest init -n my-app

Options

Usage: lvcn-ui init [options]

initialize your project and install dependencies

Options:
  -c, --cwd <cwd>                      working directory (default: current)
  -n, --name <name>                     name for a new project
  -y, --yes                             skip confirmation prompts
  -f, --force                           force overwrite of existing files
  -p, --package-manager <manager>       npm | yarn | pnpm | bun
  -h, --help                            display help

init will:

  1. Scaffold a NativeWind or Uniwind Expo template (new projects)
  2. Write lvcn.json with style, style engine, and base color
  3. Set up CSS variables and lib/utils
  4. Install required dependencies

add

Use add to install components from the registry into your project.

npx lvcn-ui@latest add button

Add multiple components:

npx lvcn-ui@latest add button card input label text

Interactive mode (pick from the full list):

npx lvcn-ui@latest add

Options

Usage: lvcn-ui add [options] [components...]

add components to your project

Arguments:
  components                            component names to add

Options:
  -y, --yes                             skip confirmation prompt
  -o, --overwrite                       overwrite existing files
  -c, --cwd <cwd>                       working directory
  -p, --package-manager <manager>       npm | yarn | pnpm | bun
  -h, --help                            display help

Components are resolved from the registry at https://lvcn.vercel.app/r (override with LVCN_REGISTRY_URL).

Available components

accordion, alert, alert-dialog, aspect-ratio, avatar, badge, button,
card, checkbox, collapsible, context-menu, dialog, dropdown-menu,
hover-card, icon, input, label, menubar, native-only-animated-view,
popover, progress, radio-group, select, separator, skeleton, switch,
tabs, text, textarea, toggle, toggle-group, tooltip

Browse docs for each component under Components.