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.

Form Variants

Different form layouts and patterns — switch stack and implementation mode, then pick a variant. FormConfig with React Hook Form, TanStack Form, or useActionState.

Build your own

Job Application

Submitted data

Waiting for a submit…

Submit the form above to see the validated payload rendered here.

Source Code

Install & set up

Everything this form needs: 6 generated files to copy and 26 shared engine files the CLI can install for you.

Form stack

Which form library the generated fields are wired to. Changes the code below and the live preview above.

Implementation mode

JSON Config reads a formConfig.ts at runtime through a generic renderer. Static JSX hand-unrolls each field instead — no formConfig.ts, no runtime dispatcher.

Choose how data is fetched

Two independent choices. The default adds no dependency at all — the command below and the code both follow whatever you pick.

HTTP client — used by services.ts

fetchaxios

Where results live — used by hooks.ts

React stateTanStack Query

Adds no extra packages.

Install it with the CLI

recommended

Installs every file below and its packages in one command. The steps after this are only for doing it by hand.

npx afnoui add forms/forms-job-application

Writes to 3 places

Or install the packages yourself

Only needed if you copied the files by hand instead of running the command above.

Runtime dependencies

npm install @hookform/resolvers date-fns react-hook-form zod

Dev dependencies

npm install -D @types/react @types/react-dom typescript

Generated files

Generated files are yours to copy and edit; shared engine files are installed once and reused.

Generated per form(6)

Shared engine — copy once(26)

Generated per form

Your form's JSON configuration — defines structure, fields, validation, and layout.

forms/formConfig.ts

import { FormConfig } from "../components/forms/types/types";

export const formConfig: FormConfig = {
  "id": "job-application-form",
  "title": "Senior Software Engineer",
  "description": "Join our engineering team and build amazing products",
  "submitLabel": "Submit Application",
  "showReset": false,
  "layout": "single",
  "sections": [
    {
      "id": "personal-info",
      "title": "Personal Information",
      "columns": 2,
      "fields": [
        {
          "type": "text",
          "name": "firstName",
          "label": "First Name",
          "placeholder": "John",
          "required": true
        },
        {
          "type": "text",
          "name": "lastName",
          "label": "Last Name",
          "placeholder": "Doe",
          "required": true
        },
        {
          "type": "email",
          "name": "email",
          "label": "Email",
          "placeholder": "john@example.com",
          "required": true
        },
        {
          "type": "tel",
          "name": "phone",
          "label": "Phone",
          "placeholder": "+1 (555) 000-0000"
        },
        {
          "type": "url",
          "name": "linkedin",
          "label": "LinkedIn Profile",
          "placeholder": "https://linkedin.com/in/johndoe"
        },
        {
          "type": "select",
          "name": "experience",
          "label": "Years of Experience",
          "options": [
            {
              "label": "0-2 years",
              "value": "0-2"
            },
            {
              "label": "3-5 years",
              "value": "3-5"
            },
            {
              "label": "5-8 years",
              "value": "5-8"
            },
            {
              "label": "8+ years",
              "value": "8+"
            }
          ]
        }
      ]
    },
    {
      "id": "application-details",
      "title": "Application Details",
      "columns": 1,
      "fields": [
        {
          "type": "file",
          "name": "resume",
          "label": "Resume/CV",
          "accept": ".pdf,.doc,.docx",
          "required": true
        },
        {
          "type": "textarea",
          "name": "coverLetter",
          "label": "Why do you want to join us?",
          "placeholder": "Tell us about yourself...",
          "rows": 4
        }
      ]
    }
  ]
};