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 (JSON Config or Static JSX), then pick a variant. Each demo uses FormConfig with React Hook Form, TanStack Form, or useActionState. Install per variant, e.g. npx afnoui add forms/forms-contact.

Install with:

npx afnoui add forms/forms-job-application

Job Application

Submitted data

Waiting for a submit…

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

Source Code

Required Dependencies & Files

Install packages and copy 25 files to run this form

Dependencies

@hookform/resolvers@tanstack/react-queryaxiosdate-fnsreact-hook-formzod

Dev Dependencies

@types/react@types/react-domtypescript

💡 Using CLI? Shared files are auto-installed

Run npx afnoui form init (or pnpm dlx / yarn dlx / bunx) to scaffold all ● shared files for this stack. You only need to copy ● variant-specific files for your form.

● Variant-specificformConfig.ts, MyFormPage.tsx, formSchema.ts — regenerated per form● Sharedtypes.ts, ReactHookForm.tsx, ReactHookFormField.tsx, … useBackendErrors.ts, field components — install via CLI or copy once

📁forms/formConfig.tsvariant-specific

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

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
        }
      ]
    }
  ]
};