Registry

Endpoints

Catalog, then one item, then the React-only shadcn projection of the same item.

https://forma-web-smoky-delta.vercel.app/r/index.json

https://forma-web-smoky-delta.vercel.app/r/button.json

https://forma-web-smoky-delta.vercel.app/r/shadcn/button.json

Authoring

One spec, three implementations. Absence of a platform key means the item is not installable there — the CLI fails instead of skipping silently. Specs that fail validation never land in public/r.

{
  "name": "input",
  "title": "Input",
  "category": "input",
  "status": "stable",
  "platforms": {
    "react": {
      "adaptation": "Native HTML input and textarea."
    },
    "swiftui": {
      "adaptation": "SwiftUI TextField / SecureField."
    },
    "compose": {
      "adaptation": "Material 3 OutlinedTextField with FelicityUI colors."
    }
  }
}

registry/input/
  spec.json
  docs.mdx
  react/input.tsx
  swiftui/Input.swift
  compose/Input.kt

Artifacts

Built payloads are the install source. File path is relative to the item directory and cannot leave it.

Namespaces

Addresses such as @felicityui/button resolve to this registry. @shadcn/button is reserved for a future adapter. V1 does not fetch third-party registries.

Integrity

Each file in the built payload has digest: sha256:<hex>. The CLI refuses to write a file whose bytes do not match, unless you pass --insecure. Signing is reserved and not implemented in v1.

Catalog

Complete items only. Tokens and utils install as dependencies of these — they are not listed as UI. Do not invent Badge, Field, Select, or Input Group as extra catalog items.

• ButtonNative <button>, SwiftUI.Button, and a Compose button with FelicityUI colors.
• InputNative <input>, SwiftUI TextField, and Compose OutlinedTextField. Textarea ships in the same item.
• AccordionNative details/summary, SwiftUI DisclosureGroup, and a Compose expandable column.
• DialogNative <dialog>, SwiftUI .alert, and Compose AlertDialog. Short confirms only.
• DrawerEdge panel on the web, .sheet on iOS, ModalBottomSheet on Android. No overlay library.

Install

Point init at this registry, then copy source with the CLI. Review the diff.

npx felicityui init --registry https://forma-web-smoky-delta.vercel.app/r

npx felicityui add button --platform react
npx felicityui add input --platform react
npx felicityui add accordion --platform react
npx felicityui add dialog --platform react
npx felicityui add drawer --platform react

Same add commands with --platform swiftui or --platform compose. See Installation for project setup, and MCP for a read-only catalog.