What This Is

@olwiba/cn is a custom shadcn component registry.
It contains beautifully designed, copy-paste ready primitive components built on React 19 and Tailwind CSS v4.

Primitives are the individual lego pieces for building on the web.

If you're interested in composite components, these are prebuilt, opinionated combinations of primitives that solve specific UI problems. They're coming soon in @olwiba/ui.

The project introduces the idea of a mode prop, this lets you dial in the visual personality without touching variants or structure.
Pair that with seven built-in color themes and you get a design system that can conform to your project.

It ships two ways:

1. As an installable package
2. As a shadcn registry you can copy directly into your project

Installation

bun add @olwiba/cn

Peer dependencies: react, react-dom, tailwindcss, lucide-react

import "@olwiba/cn/styles";
import { Button, Card, UIVariantProvider } from "@olwiba/cn";

export function Example() {
  return (
    <UIVariantProvider mode="smooth">
      <Card className="p-6">
        <Button>Continue</Button>
      </Card>
    </UIVariantProvider>
  );
}

Available CSS entrypoints: @olwiba/cn/styles, @olwiba/cn/theme, @olwiba/cn/preset

Registry

Prefer owning the source? Add the registry to your components.json and copy components directly into your project.

{
  "registries": {
    "@olwibacn": "https://cn.olwiba.com/r/{name}.json"
  }
}

shadcn add @olwibacn/button

What's Included

Themes Choose your brand color Modes Default (blocky/sharp), Smooth, Playful Icons Bring your own icon library! Components The things you can see and interact with Mechanics The behaviours that bring your project to life

Tech Stack

• React 19
• TypeScript
• Tailwind CSS v4
• Radix UI
• shadcn/ui
• Lucide React
• CVA

Ecosystem

• Coming soon!

Contributing

Bug reports, pull requests & feature requests are welcome. Open an issue first for anything beyond a small fix.