Installation

jalco ui components are distributed as a shadcn-compatible registry. You install them directly into your project — no package to add, no version to track.

With shadcn CLI

The fastest way to get started. The CLI handles source files, npm dependencies, and registry dependencies in one command.

Prerequisites

Make sure your project includes these.

Add the registry

npx shadcn@latest registry add @jalco

This adds the jalco registry to your components.json:

{
  "registries": {
    "@jalco": "https://ui.justinlevine.me/r/{name}.json"
  }
}

Install a component

Pick any component and add it to your project.

npx shadcn@latest add @jalco/github-stars-button

This will:

Download the component source into your project
Install any required npm dependencies
Add any shadcn registry dependencies (like button, card, etc.)

Use the component

Import and render it in your app.

import { GitHubStarsButton } from "@/components/github-stars-button"

Manual setup

If you prefer to skip the registry add command, add the registry entry to your components.json directly:

{
  "registries": {
    "@jalco": {
      "url": "https://ui.justinlevine.me/r"
    }
  }
}

Then install components with the CLI as usual:

npx shadcn@latest add @jalco/github-stars-button

Without shadcn

Don't use shadcn? No problem. Every component page includes the full source code — copy it directly into your project and install any listed dependencies manually. The components are plain React + Tailwind CSS with no framework lock-in.

MCP integration

Initialize the shadcn MCP server to give your AI editor full context of the jalco ui library:

npx shadcn@latest mcp init