Quick Setup

Get your first Tailark item installed in a few minutes. This page has two paths — pick the one that matches what you want to install.

In a hurry? Generate a tailored setup prompt for your AI agent — pick your license, kit, UI base, and project type, then paste it into Cursor, Claude, or any other AI agent.

Before you start

Both paths assume you have:

  • A Next.js app using the App Router
  • shadcn/ui initialized (npx shadcn@latest init)

Pick a style preset that matches your UI base — base-* for Base UI, radix-* for Radix UI. Point each registry URL to the matching path:

  • tailark.com/r/{name} for Base UI (default — the base segment is omitted)
  • tailark.com/r/radix/{name} for Radix UI

Use the base switcher on tailark.com when browsing — copy install commands from the preview so the namespace and item name are exact.

Free setup

Install Mist, Dusk, or Veil blocks from the public OSS registry. No account or API key required.

1. Add the OSS registry

Use @tailark-oss with the URL that matches your UI base:

Base UI (default):

json

Radix UI:

json

2. Install a block

Browse Blocks, set the base switcher to match your registry URL, and copy the CLI command from the preview toolbar:

bash

3. Add theme tokens (recommended)

Copy the theme for your kit from Theme — Veil, Mist, Dusk, or Quartz.

Pro setup

Install gated Quartz content with an API key. Blocks and illustrations work on Base UI or Radix UI — point the @tailark URL to match your UI base.

Requires an Essentials, Complete, or Team plan.

1. Generate an API key

Open the Dashboard and click Create API Key. Copy the key when shown.

2. Add the API key

bash

Add this to .env.local at your project root.

3. Configure components.json

Merge into your existing components.json. Add app, types, and content aliases if you plan to install pages.

Base UI example:

json

Radix UI example:

json

If you are using a monorepo, read Monorepo first.

4. Add theme

Copy the Quartz theme into your global stylesheet.

For dark mode, see Theme.

5. Install your first item

bash

Copy the exact name from any Quartz block preview. Set the site base switcher to match your registry URL.

Important security notes

  • Never commit your API key to version control

  • Keep .env.local in .gitignore

  • Manage keys from the Dashboard

Test your setup

Confirm the CLI can reach your registries:

bash
bash
bash

On tailark.com, your session grants browser preview access. The CLI uses your API key. Open in v0 does not support namespaced registries — the site rewrites @tailark / @tailark-oss deps to absolute URLs (and mints a short-lived token for gated Quartz items).

Next steps