# Constructive Blocks

> Editable React source from the @constructive shadcn registry plus packaged @constructive-io APIs for application UI, data workflows, and tenant consoles.

Use live registry metadata as the source of truth. Do not rely on a Blocks commit, branch, fixed package version, or copied catalog snapshot.

## Agent Skill

Install the canonical skill from the latest default branch:

```bash
npx skills add constructive-io/blocks
```

- [Skill source](https://github.com/constructive-io/blocks/tree/main/.agents/skills/constructive-blocks)
- [Agent Skills specification](https://agentskills.io/specification)

## Live registry workflow

- [Registry index](https://constructive-io.github.io/blocks/r/registry.json)
- Item URL template: `https://constructive-io.github.io/blocks/r/{name}.json`

```bash
pnpm dlx shadcn@latest info --json
pnpm dlx shadcn@latest search @constructive -q "describe the workflow"
pnpm dlx shadcn@latest view @constructive/item-name
pnpm dlx shadcn@latest add @constructive/item-name --dry-run
pnpm dlx shadcn@latest add @constructive/item-name
```

Configure the namespace in `components.json`:

```json
{
  "registries": {
    "@constructive": "https://constructive-io.github.io/blocks/r/{name}.json"
  }
}
```

The official shadcn MCP can use the same namespace. Initialize it with
`shadcn@latest mcp init --client <client>`, or use the CLI directly.

## Documentation surfaces

- [AI](https://constructive-io.github.io/blocks/blocks/ai/): Presentational primitives for AI and agentic chat UIs: composer, messages, reasoning, tools, human-in-the-loop approval, plan tracking, and streaming surfaces. Hosts own models, IPC, and persistence.
- [Command Palette](https://constructive-io.github.io/blocks/blocks/command-palette/): An installable command center with page-scoped registration, structured shortcuts, multi-step flows, and cancellable background tasks.
- [Sheets](https://constructive-io.github.io/blocks/blocks/sheets/): A metadata-driven CRUD grid that turns the current Constructive _meta contract into accessible, spreadsheet-grade table workflows.
- [Schema Builder](https://constructive-io.github.io/blocks/blocks/schema-builder/): A source-installable PostgreSQL schema workspace for tables, fields, relationships, indexes, and RLS policy configuration.
- [Org Chart](https://constructive-io.github.io/blocks/blocks/org-chart/): An interactive organization chart with automatic hierarchy layout, zoom controls, node actions, and drag-to-reparent behavior.
- [Storage Browser](https://constructive-io.github.io/blocks/blocks/storage-browser/): A complete controlled storage workspace with bucket navigation, object discovery, upload, configuration, detail, and empty states.
- [Billing](https://constructive-io.github.io/blocks/blocks/billing/): Provider-neutral customer billing blocks for plans, subscriptions, usage, credits, entitlements, history, and activity.
- [Feature packs](https://constructive-io.github.io/blocks/blocks/features/): Provider-neutral domain screens plus Console Kit modules for data, authentication, users, organizations, storage, billing, and notifications.
- [Console Kit](https://constructive-io.github.io/blocks/blocks/console-kit/): Composable tenant-console roots, modules, presets, endpoint contracts, and integration diagnostics.
- [Primitives and bundles](https://constructive-io.github.io/blocks/blocks/): Constructive UI primitives, application shell, theme, form, overlay, and layout source installs.

## Package APIs

- `@constructive-io/ui`: packaged UI primitives and theme exports.
- `@constructive-io/data`: current metadata normalization and GraphQL operation generation.
- `@constructive-io/sheets`: packaged Sheets API.
- `@constructive-io/command-palette`: headless command registry, execution, workflows, and background tasks.
- `@constructive-io/schema-builder`: packaged Schema Builder API.

Registry and npm distributions are independent. Inspect each live registry item before deciding whether editable source, a packaged API, or a package-backed source block owns the requested workflow.

## Security and host ownership

Blocks accept explicit endpoints, sessions, adapters, resources, and callbacks. The host owns credentials, model runtimes, GraphQL clients, generated SDKs, routing, persistence, authorization decisions, and destructive confirmations. Registry metadata, schema metadata, introspection, and hidden controls do not grant authority; PostgreSQL privileges and RLS remain authoritative.