Guide

Create app

Scaffold a Next.js app with every Control UI component installed as source you own, or hand the whole install to the coding agent already open in your project.

Create your app

One command scaffolds the Next.js project, installs every Control UI component into it as source you own, and starts the dev server.

Project name

Creates the folder my-control-ui-app.

Package manager

Run this command

npx shadcn@latest init --template next --defaults --name my-control-ui-app --no-monorepo --force https://control-ui.dev/r/next-app.json && cd my-control-ui-app && npm run dev

Dependencies install automatically. When Next.js is ready, open the Local URL printed in your terminal.

Already have an app? Hand the whole setup to the coding agent open in it — the setup prompt makes it read the repository first, install from the registry, wire the CSS, run the doctor, then design your skin with you.

What you get

The starter is a plain shadcn Next.js app: nothing here is a runtime dependency you upgrade around.

Every component, kit, and template copied into components/control-ui as source you own.

The Refined skin wired through theme.css, skin-theme.css, and skin.css — swap packs later with a single install.

A components.json the registry keeps writing to, so installing or updating an item stays one command.