Getting Started

MynaUI is distributed through the shadcn CLI. Start with a working shadcn/ui project, then install only the components you need.

Requirements

• React, TypeScript, and Tailwind CSS v4
• A shadcn/ui project with components.json configured
• A global CSS file that includes your shadcn theme tokens

1. Set up shadcn/ui

Run the shadcn initializer and follow the prompts for your framework, CSS file, aliases, and component style:

npx shadcn@latest init

You can also use shadcn/create if you want to choose your preset visually.

2. Add the MynaUI registry

Add the MynaUI namespace to your components.json so the shadcn CLI can resolve components by name:

{
  "registries": {
    "@mynaui": "https://mynaui.com/r/{name}.json"
  }
}

3. Install a MynaUI component

Pick a component, copy the install command, and run it in your project. For example:

npx shadcn@latest add @mynaui/button1

You can also install any component directly from its registry URL:

npx shadcn@latest add \
  https://mynaui.com/registry/button/button1.json

The CLI installs the component source, its shadcn dependencies, and any required package dependencies into your app.

4. Add icons when needed

Components that use MynaUI icons can install the icon registry entry:

npx shadcn@latest add \
  https://mynaui.com/icons/shadcn.json

If you want to use the icon package directly in React, install it with:

npm install @mynaui/icons-react

Keep it clean

• Use the command on each component page to install the exact variant you want.
• Registry installs add source files to your app, so review the diff before committing.
• Theme MynaUI through your shadcn tokens instead of editing every component.