AfnoUI is an open-source, registry-driven React + TypeScript component library and CLI. It provides accessible Radix UI + Tailwind CSS v4 components plus visual builders for forms, tables, kanban boards, trees, and database schemas, a 17-type chart library, a dependency-free drag-and-drop engine, and a live theme lab.

How do I install AfnoUI?

Run `npx afnoui init` to set up Tailwind, CSS variables, and the base design system, then `npx afnoui add button card dialog` to add components. It works with npm, pnpm, yarn, and bun (npx / pnpm dlx / yarn dlx / bunx).

What CLI commands does AfnoUI have?

Setup: `afnoui init` (design system; add --dnd for the drag-and-drop engine). Install: `afnoui add ` and `afnoui add / ` for variants. Engine systems: `afnoui form init`, `table init`, `kanban init`, `tree init`, `dnd init`, and `chart init` each install the complete shared system for that category. Discover: `afnoui list` and `afnoui list variants`. Maintain: `afnoui update`, `afnoui doctor`, `afnoui diagnose`, and `afnoui clean`. Run `afnoui help` for the full reference. Every command accepts --dry-run, --force, and --debug.

Is AfnoUI free and open source?

Yes. AfnoUI is free and open source. The CLI writes component source directly into your project, so you own and can edit the code — it is not a runtime dependency.

Will the AfnoUI CLI overwrite my changes?

No. AfnoUI records a hash of every file it writes in afnoui.json. If you have edited one of those files since it was installed, a re-install stops and asks before touching it, and only --force overwrites. Files AfnoUI never wrote are left alone entirely, and --dry-run previews every write and install without touching disk.

How is AfnoUI different from shadcn/ui?

Like shadcn/ui, AfnoUI copies source into your repo instead of shipping a black-box package. It goes further with visual builders (form, table, kanban, tree, schema), a 17-type chart library, a drag-and-drop engine with no third-party dependency, and a live theme lab, all driven by a hosted registry the CLI fetches from at install time.

Which frameworks and tools does AfnoUI use?

AfnoUI targets Next.js 15 and React 19 with TypeScript, Tailwind CSS v4, and Radix UI. Forms use Zod with React Hook Form, TanStack Form, or Action Form.

Can I build forms without writing code?

Yes. The Visual Form Builder lets you drag and drop 25+ field types, add conditional logic and dependent dropdowns, and export production-ready React + TypeScript with runtime or compile-time Zod validation.

Can I save a build and come back to it later?

Yes. Every builder has a JSON button that exports the complete build as a single JSON document — configuration, data, and any custom cell or card renderers. Paste that JSON back into the Import tab and you get the exact same build, including the template variant it started from. Nothing is stored on a server, so the JSON is yours to keep in a repo, a ticket, or a gist.

Does AfnoUI check my build for mistakes before I export?

Yes. Each builder runs a Build health check over your configuration and lists real problems with the exact fix: duplicate field names or column ids, conditional fields watching a field that no longer exists, columns whose data key is missing from the rows, kanban cards pointing at a deleted column, columns over their WIP limit, and flow nodes with a route action but no href. These are the mistakes that would otherwise surface as broken generated code in your project.

Dropdown

Explore different variants and configurations of the Dropdown component.

npx afnoui add dropdown/dropdown-basic

Writes to 2 places

Basic Dropdown

npx afnoui add dropdown/dropdown-icon-only

Writes to 2 places

Icon Only

npx afnoui add dropdown/dropdown-keyboard-shortcuts

Writes to 2 places

Keyboard Shortcuts

npx afnoui add dropdown/dropdown-checkbox-items

Writes to 2 places

Checkbox Items

npx afnoui add dropdown/dropdown-radio-items

Writes to 2 places

Radio Items (Theme)

npx afnoui add dropdown/dropdown-radio-items-priority

Writes to 2 places

Radio Items (Priority)

npx afnoui add dropdown/dropdown-nested

Writes to 2 places

Nested Submenu

npx afnoui add dropdown/dropdown-user-account

Writes to 2 places

User Account

npx afnoui add dropdown/dropdown-context-actions

Writes to 2 places

Context Actions

Document.pdf

2.4 MB • Modified 2 hours ago