Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# Constructive Blocks

<p align="center" width="100%">
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
</p>

Constructive Blocks is the public home for the Constructive shadcn registry,
component documentation, and published React packages.

Expand Down
11 changes: 11 additions & 0 deletions apps/blocks/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,16 @@
# Blocks docs

<p align="center" width="100%">
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
</p>

This Next.js app documents the Constructive Blocks registry: the UI foundation,
29 base primitives, customer billing blocks, seven capability-aligned feature
packs, and Console Kit.
Expand Down
8 changes: 8 additions & 0 deletions packages/blocks-renderer/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/blocks-renderer"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fblocks-renderer%2Fpackage.json"/></a>
</p>

React adapter for `blocks-schema` UI documents: a recursive
renderer with layerable widget registries, binding resolution, form state, and
a visible unknown-block fallback.
Expand Down
8 changes: 8 additions & 0 deletions packages/blocks-schema/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/blocks-schema"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fblocks-schema%2Fpackage.json"/></a>
</p>

Portable JSON UI document specification for Constructive Blocks: the storage
format, runtime validators, JSON Schema export, and pure document-manipulation
API. No React — this package is safe in servers, workers, and agents.
Expand Down
12 changes: 12 additions & 0 deletions packages/command-palette/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# @constructive-io/command-palette

<p align="center" width="100%">
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/@constructive-io/command-palette"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fcommand-palette%2Fpackage.json"/></a>
</p>

Headless command registration, structured shortcuts, execution, multi-step flows, and cancellable background-task state for React applications.

The visual palette is source-installed from the Constructive registry. This package deliberately has no dependency on `@constructive-io/ui`, `cmdk`, or `motion`.
Expand Down
12 changes: 12 additions & 0 deletions packages/data/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# @constructive-io/data

<p align="center" width="100%">
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/@constructive-io/data"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fdata%2Fpackage.json"/></a>
</p>

Runtime query generation and metadata utilities for Constructive/PostGraphile data endpoints.

The package combines Constructive's versioned `_meta` contract with standard GraphQL introspection. `_meta` supplies PostgreSQL encodings, advisory CRUD inflections, relations, constraints, scope, storage, search, i18n, and realtime metadata; standard introspection supplies the exact executable roots, input objects, filters, ordering, pagination, enums, and custom operations.
Expand Down
8 changes: 8 additions & 0 deletions packages/flow-to-blocks/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/flow-to-blocks"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fflow-to-blocks%2Fpackage.json"/></a>
</p>

Evaluate a flow-based-programming graph into a
[`blocks-schema`](../blocks-schema) UI document. Where
[`json-schema-to-blocks`](../json-schema-to-blocks) and
Expand Down
8 changes: 8 additions & 0 deletions packages/json-renderer/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/json-renderer"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fjson-renderer%2Fpackage.json"/></a>
</p>

The framework-agnostic core of a declarative JSON UI document: the document
envelope and node tree, runtime validation, JSON Schema export, composition
(fragments, slots, per-node overrides, merge), binding resolution, and the
Expand Down
8 changes: 8 additions & 0 deletions packages/json-schema-to-blocks/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/json-schema-to-blocks"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fjson-schema-to-blocks%2Fpackage.json"/></a>
</p>

Lower a JSON Schema into a [`blocks-schema`](../blocks-schema) UI document: any
schema-described value gets a form with no hand-authored JSON. Pure functions,
no React — usable in servers, workers, and agents.
Expand Down
8 changes: 8 additions & 0 deletions packages/meta-to-blocks/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/meta-to-blocks"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fmeta-to-blocks%2Fpackage.json"/></a>
</p>

Lower Constructive `_meta` database metadata into
[`blocks-schema`](../blocks-schema) UI documents: generated form, list, and
detail screens with no hand-authored JSON. Columns lower through JSON Schema, so
Expand Down
12 changes: 12 additions & 0 deletions packages/schema-builder/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# Schema Builder

<p align="center" width="100%">
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/@constructive-io/schema-builder"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fschema-builder%2Fpackage.json"/></a>
</p>

Framework-agnostic React schema builder for Constructive applications. The host owns the TanStack Query client, authenticated data adapter, scope, color mode, navigation, active tab, and persisted preferences.

Configure the `@constructive` registry in `components.json`, then install the
Expand Down
12 changes: 12 additions & 0 deletions packages/sheets/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# Sheets

<p align="center" width="100%">
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/@constructive-io/sheets"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fsheets%2Fpackage.json"/></a>
</p>

Portable spreadsheet-like CRUD editor for Constructive/PostGraphile backends. The package provides a native DOM grid with filtering, pagination, cell editing, draft rows, relation handling, and standalone authentication.

## Requirements
Expand Down
12 changes: 12 additions & 0 deletions packages/ui/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,17 @@
# @constructive-io/ui

<p align="center" width="100%">
<img height="250" src="https://raw.githubusercontent.com/constructive-io/constructive/refs/heads/main/assets/outline-logo.svg" />
</p>

<p align="center" width="100%">
<a href="https://github.com/constructive-io/blocks/actions/workflows/ci.yml">
<img height="20" src="https://github.com/constructive-io/blocks/actions/workflows/ci.yml/badge.svg" />
</a>
<a href="https://github.com/constructive-io/blocks/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"/></a>
<a href="https://www.npmjs.com/package/@constructive-io/ui"><img height="20" src="https://img.shields.io/github/package-json/v/constructive-io/blocks?filename=packages%2Fui%2Fpackage.json"/></a>
</p>

A modern React component library built on [Base UI](https://base-ui.com/) primitives and [Tailwind CSS v4](https://tailwindcss.com/).

## Installation
Expand Down
Loading