Installation

Start from a fresh project, initialize shadcn/ui, then install TT-UI components from the registry.

1) Create a project with your framework

Choose your framework starter, then continue with shadcn init.

bash

npx create-next-app@latest my-app --typescript --tailwind --app

2) Run shadcn init (with options)

Initialize shadcn in your app. Use the guided flow first, then use flags when you want repeatable setup.

bash

npx shadcn@latest init

bash

npx shadcn@latest init --help

bash

npx shadcn@latest init --yes --base-color neutral --css-variables --rsc --src-dir --path app

3) Monorepo setup

Run shadcn commands in the app package (not at monorepo root), or pass --cwd.

bash

npx shadcn@latest init --cwd apps/web

bash

npx shadcn@latest add @tt-ui/registry/file-tree --cwd apps/web

4) Add TT-UI components from the registry

Namespaced registry

bash

npx shadcn@latest add @tt-ui/file-viewer

Direct URL

bash

npx shadcn@latest add "https://ui.tibbstech.co.uk/r/file-viewer.json"

5) Configure namespaced registries

Your components.json should include the TT-UI namespace:

json

{
  "registries": {
    "@tt-ui": "https://ui.tibbstech.co.uk/r/{name}.json"
  }
}

Once configured, install by namespace and keep your commands concise.