From 2f0d61729e1786970e11c4b15a9bb44f260afba8 Mon Sep 17 00:00:00 2001 From: Dan Lynch Date: Sat, 22 Aug 2026 02:46:02 +0000 Subject: [PATCH] docs: add the Constructive logo header and badges to every README --- README.md | 11 +++++++++++ apps/blocks/README.md | 11 +++++++++++ packages/blocks-renderer/README.md | 8 ++++++++ packages/blocks-schema/README.md | 8 ++++++++ packages/command-palette/README.md | 12 ++++++++++++ packages/data/README.md | 12 ++++++++++++ packages/flow-to-blocks/README.md | 8 ++++++++ packages/json-renderer/README.md | 8 ++++++++ packages/json-schema-to-blocks/README.md | 8 ++++++++ packages/meta-to-blocks/README.md | 8 ++++++++ packages/schema-builder/README.md | 12 ++++++++++++ packages/sheets/README.md | 12 ++++++++++++ packages/ui/README.md | 12 ++++++++++++ 13 files changed, 130 insertions(+) diff --git a/README.md b/README.md index 3884f61..67055d8 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,16 @@ # Constructive Blocks +

+ +

+ +

+ + + + +

+ Constructive Blocks is the public home for the Constructive shadcn registry, component documentation, and published React packages. diff --git a/apps/blocks/README.md b/apps/blocks/README.md index 852ed8d..0cbc11d 100644 --- a/apps/blocks/README.md +++ b/apps/blocks/README.md @@ -1,5 +1,16 @@ # Blocks docs +

+ +

+ +

+ + + + +

+ 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. diff --git a/packages/blocks-renderer/README.md b/packages/blocks-renderer/README.md index 40be350..ed234b3 100644 --- a/packages/blocks-renderer/README.md +++ b/packages/blocks-renderer/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ React adapter for `blocks-schema` UI documents: a recursive renderer with layerable widget registries, binding resolution, form state, and a visible unknown-block fallback. diff --git a/packages/blocks-schema/README.md b/packages/blocks-schema/README.md index c31badf..e4f20cd 100644 --- a/packages/blocks-schema/README.md +++ b/packages/blocks-schema/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ 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. diff --git a/packages/command-palette/README.md b/packages/command-palette/README.md index 40c1128..5517783 100644 --- a/packages/command-palette/README.md +++ b/packages/command-palette/README.md @@ -1,5 +1,17 @@ # @constructive-io/command-palette +

+ +

+ +

+ + + + + +

+ 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`. diff --git a/packages/data/README.md b/packages/data/README.md index b39a19c..a9f3883 100644 --- a/packages/data/README.md +++ b/packages/data/README.md @@ -1,5 +1,17 @@ # @constructive-io/data +

+ +

+ +

+ + + + + +

+ 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. diff --git a/packages/flow-to-blocks/README.md b/packages/flow-to-blocks/README.md index 4d28c66..3c85276 100644 --- a/packages/flow-to-blocks/README.md +++ b/packages/flow-to-blocks/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ Evaluate a flow-based-programming graph into a [`blocks-schema`](../blocks-schema) UI document. Where [`json-schema-to-blocks`](../json-schema-to-blocks) and diff --git a/packages/json-renderer/README.md b/packages/json-renderer/README.md index a3a94e8..b6273b6 100644 --- a/packages/json-renderer/README.md +++ b/packages/json-renderer/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ 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 diff --git a/packages/json-schema-to-blocks/README.md b/packages/json-schema-to-blocks/README.md index 10ef43c..ed6d45a 100644 --- a/packages/json-schema-to-blocks/README.md +++ b/packages/json-schema-to-blocks/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ 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. diff --git a/packages/meta-to-blocks/README.md b/packages/meta-to-blocks/README.md index 3399ba7..d4b38a4 100644 --- a/packages/meta-to-blocks/README.md +++ b/packages/meta-to-blocks/README.md @@ -4,6 +4,14 @@

+

+ + + + + +

+ 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 diff --git a/packages/schema-builder/README.md b/packages/schema-builder/README.md index 04043cc..2bb5078 100644 --- a/packages/schema-builder/README.md +++ b/packages/schema-builder/README.md @@ -1,5 +1,17 @@ # Schema Builder +

+ +

+ +

+ + + + + +

+ 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 diff --git a/packages/sheets/README.md b/packages/sheets/README.md index bfbe523..dbe016a 100644 --- a/packages/sheets/README.md +++ b/packages/sheets/README.md @@ -1,5 +1,17 @@ # Sheets +

+ +

+ +

+ + + + + +

+ 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 diff --git a/packages/ui/README.md b/packages/ui/README.md index 2b180f7..ab05fdc 100644 --- a/packages/ui/README.md +++ b/packages/ui/README.md @@ -1,5 +1,17 @@ # @constructive-io/ui +

+ +

+ +

+ + + + + +

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