From 5c1f51e74e7c9eed4d5c9d2836dc5610204d7c9c Mon Sep 17 00:00:00 2001
From: Wilkin Santana <28665914+wilkinsantana@users.noreply.github.com>
Date: Sat, 7 Nov 2026 06:33:44 -0500
Subject: [PATCH 1/2] Refresh TendUI onboarding and document community setup
Signed-off-by: Wilkin Santana <28665914+wilkinsantana@users.noreply.github.com>
---
.github/settings/README.md | 16 +-
CONTRIBUTING.md | 4 +
README.md | 561 +++--------------------------
docs/brand/README.md | 8 +
docs/brand/readme-banner-dark.png | Bin 0 -> 129454 bytes
docs/brand/readme-banner-light.png | Bin 0 -> 123912 bytes
docs/brand/readme-banners.json | 16 +
docs/library-guide.md | 456 +++++++++++++++++++++++
8 files changed, 540 insertions(+), 521 deletions(-)
create mode 100644 docs/brand/readme-banner-dark.png
create mode 100644 docs/brand/readme-banner-light.png
create mode 100644 docs/brand/readme-banners.json
create mode 100644 docs/library-guide.md
diff --git a/.github/settings/README.md b/.github/settings/README.md
index 928fd27..74430ad 100644
--- a/.github/settings/README.md
+++ b/.github/settings/README.md
@@ -1,21 +1,23 @@
# Owner-applied repository settings
-This directory is a reviewable configuration, not proof that GitHub settings
-are active. An owner with repository administration access should apply the
-main ruleset once the contribution workflow is merged and its check names exist.
+The **Reviewed main contributions** ruleset was applied and read back as active
+on 2026-11-07 UTC ([view ruleset](https://github.com/Tend-Stack/TendUI/rules/26745168)).
+This records the verified setup date; GitHub remains the source of truth for
+current enforcement. Review the live rules before changing them.
+
+To update this existing ruleset after reviewing the JSON:
```sh
-gh api --method POST repos/Tend-Stack/TendUI/rulesets --input .github/settings/main-ruleset.json
+gh api --method PUT repos/Tend-Stack/TendUI/rulesets/26745168 --input .github/settings/main-ruleset.json
```
-Read existing rulesets first. If one already has this name, update it by its ID
-with PUT rather than creating duplicates. The ruleset requires DCO and all CI,
+Do not POST another copy. The ruleset requires DCO and all CI,
one approving code-owner review, dismissal of stale approvals, approval of the
latest push, resolved conversations and an up-to-date branch. It blocks force
pushes and deletion. Repository admins have an explicit PR-only bypass for
maintainer exceptions; record the reason in the PR and preserve contributor DCO.
-Also enable GitHub private vulnerability reporting and web commit sign-off,
+Separate settings still require verification: enable GitHub private vulnerability reporting and web commit sign-off,
disable squash/rebase merges to preserve commit trailers, and allow merge commits.
Require approval for fork workflows according to the organization's trust policy.
Never run untrusted fork code on private self-hosted runners or with deployment
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 59e0495..f9c98cf 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -35,6 +35,10 @@ Identify significant generated material or reused sources in the PR description.
## Workflow
+Maintainers track both repositories in the shared [TendUI project](https://github.com/orgs/Tend-Stack/projects/2).
+The board is currently private while publication review is completed; use this
+repository's issues to propose work or report bugs.
+
1. Fork the repository and create a focused branch from current `main`.
2. Make the smallest complete change; keep unrelated cleanup separate.
3. Add proportionate tests and update documentation for changed behavior.
diff --git a/README.md b/README.md
index 101bd5b..06bc0ba 100644
--- a/README.md
+++ b/README.md
@@ -1,43 +1,39 @@
-# TendUI
-
-
-
+
+
-**Beautiful interfaces. No build pipeline.**
+# Beautiful interfaces. No build pipeline.
-Pure CSS. Semantic HTML. No Node.js, no npm, no bundled JavaScript.
-First-class Go and templ support.
+Pure CSS. Semantic HTML. **No Node.js, no npm, no bundled JavaScript.**
+First-class Go and templ support, with styles embedded directly in your binary.
-Use the stylesheet with any HTML stack. In Go, `//go:embed` bundles the CSS
-inside your application: build and ship one executable, with no runtime asset
-downloads. Typed templ components and optional HTMX attributes are ready when
-you need them.
+[Documentation](https://tendui.com/docs) · [Component catalog](https://tendui.com/catalog) · [Playground](https://tendui.com/playground) · [Examples](https://tendui.com/examples)
-TendUI pairs original semantic CSS with composable Go components. Build
-interfaces with native HTML, typed configuration, and application-owned behavior.
+## Small pieces. A complete starting point.
-See [migration notes](docs/tendui-migration.md) for the renamed Go module, CSS
-namespace, and use with other HTML stacks.
+| Build with | What you get |
+| --- | --- |
+| **Any HTML stack** | One semantic stylesheet for native elements, forms, cards and layouts. |
+| **Go** | Embedded assets and a standard-library HTTP handler. Build and ship one executable. |
+| **templ** | Typed component props and composable content slots; generated Go ships with the module. |
+| **Optional HTMX** | Explicit request attributes and page/fragment helpers. Your app supplies the runtime. |
-## Install and run
+Light, dark and system themes. Responsive layouts. Configurable spacing and
+surfaces. Native interactions, keyboard access and bounded CSS motion.
-Requires **Go 1.26+**, matching the pinned `github.com/a-h/templ v0.3.1100`
-runtime. The asset package imports only the standard library; the components
-have one direct Go dependency, templ. It is not a literally dependency-free
-module, and this version does not support Go 1.21.
+## Get a page running
-Install the pinned TendUI preview (API changes remain possible before a stable release):
+Use **Go 1.26+** and the pinned preview:
```sh
go get github.com/Tend-Stack/TendUI/v2026@v2026.2.0-preview.2
```
-Generated `*_templ.go` files ship with the module, so consumers do not need
-the templ CLI to use these components from Go.
-
-A complete `main.go`:
+The asset package uses only Go's standard library. Components use **templ
+v0.3.1100** as their one direct runtime dependency. No generator is required to
+consume the included components from Go; writing your own `.templ` files needs
+the matching templ generator.
```go
package main
@@ -55,12 +51,10 @@ func main() {
mux := http.NewServeMux()
mux.Handle(tendui.AssetPath, tendui.AssetHandler())
page := components.Layout(components.LayoutProps{
- Title: "My Go app",
- Language: "en",
- Theme: components.ThemeLight,
+ Title: "Hello, TendUI", Language: "en", Theme: components.ThemeLight,
}, components.Card(components.CardProps{
Body: components.Button(components.ButtonProps{
- Text: "Hello from Go", Primary: true,
+ Text: "Build something thoughtful", Primary: true,
}),
}))
mux.Handle("/", templ.Handler(page))
@@ -68,497 +62,36 @@ func main() {
}
```
-For a complete, tested Go/templ application, see [the quickstart](docs/quickstart.md)
-and [`examples/quickstart`](examples/quickstart). To use CSS with any stack, see
-[the plain HTML example](examples/html); Go and templ are optional for that path.
-
-Run the local demos, including a component playground, form lab, dashboard,
-appearance editor, workspace, native interactions, inline editing, motion and surfaces, and theme endpoint:
-
-```sh
-go run ./examples/basic -open
-```
-
-The `-open` flag opens `http://127.0.0.1:8080/playground` in your default Linux
-browser. See [the demo guide](examples/site/README.md) for all pages and test
-scenarios. The example deliberately blocks scripts with its
-Content Security Policy. Theme switching and the form work with JavaScript
-disabled.
-
-## Packages and assets
-
-```text
-tendui.go embedded CSS handler
-static/tendui.css readable semantic stylesheet
-components/
- layout.templ document, title, language, theme, stylesheet
- theme.templ native POST theme form with optional HTMX hooks
- buttons.templ buttons and button-styled links
- cards.templ article with optional header, body, footer
- forms.templ forms, inputs, selects, checkboxes, grids
- fields.templ composable labels, help/error bindings and input addons
- controls.templ textareas, radio groups, switches, file inputs
- feedback.templ alerts, badges, linked error summaries
- shell.templ application header, sidebar, main content
- overlays.templ native dialog and popover panels
- navigation.templ breadcrumbs and bounded pagination
- tables.templ data tables with column/row contracts and state slots
- wayfinding.templ page tabs, progress steps and native disclosures
- motion.templ typed one-shot entrance effects
- states.templ loading placeholders, empty states and metrics
- appearance.go typed settings, attributes, and CSS exports
- *_templ.go generated Go, included for consumers
-render/ buffered page/fragment HTTP responses
-examples/site/ thirteen demo pages, searchable catalog, preference cookies and downloads
-```
-
-Mount `AssetHandler()` directly at `/tendui/static/`. Do **not** apply
-`http.StripPrefix`: the handler already recognizes the complete path. It serves
-only `tendui.css`, supports GET/HEAD, conditional ETag requests and byte ranges,
-and returns 404 for directories and unknown assets. Revalidation prevents a
-browser from keeping stale CSS across binary upgrades. See the
-[asset delivery guide](docs/assets.md) for cache/proxy behavior, range requests
-and verification scope.
-
-## Components
-
-All text is escaped by templ. Link and form URLs use templ's safe URL handling.
-Keep URL destinations and HTMX endpoints application-controlled. Labels wrap
-controls, so an ID is optional and repeated components do not invent duplicate
-IDs. Supply meaningful labels for every input.
-
-```templ
-@components.Form(components.FormProps{
- Action: "/profile", Method: components.MethodPost,
- HxPost: "/profile", HxTarget: "#result", HxSwap: "innerHTML",
- HxIndicator: "#saving",
-}) {
- @components.Grid(components.GridProps{}) {
- @components.Input(components.InputProps{
- Name: "email", Label: "Email", Type: components.InputEmail,
- Required: true, Autocomplete: "email",
- })
- @components.Select(components.SelectProps{
- Name: "locale", Label: "Language", Value: "en",
- Options: []components.Option{
- {Label: "English", Value: "en"},
- {Label: "Español", Value: "es"},
- },
- })
- }
- @components.Checkbox(components.CheckboxProps{
- Name: "updates", Label: "Receive updates",
- })
- @components.Button(components.ButtonProps{
- Text: "Save", Type: components.ButtonTypeSubmit, Primary: true,
- })
- Saving…
-}
-
-```
-
-`ButtonProps`, `LinkProps`, and `FormProps` expose `HxGet`, `HxPost`, `HxTarget`,
-`HxSwap`, and `HxIndicator` directly. Set either HxGet or HxPost for a request,
-not both. Empty attributes are omitted. `Button` defaults to `type="button"`
-to avoid accidental submission; `Form` defaults to GET. Primary and Outline
-can be combined. Raw buttons use the primary color by default.
-
-`CardProps` accepts `Header`, `Body`, and `Footer` components. Cards also accept
-templ children after Body. Forms and grids use templ children. Pass ordinary
-components rather than `templ.Raw` for untrusted content.
-Cards can optionally override the page's shadow with `ElevationFlat`,
-`ElevationSubtle`, `ElevationRaised`, or `ElevationFloating`. The zero value
-inherits the page setting. See [surface elevation](docs/motion.md#elevation)
-for theme tokens, nesting, outlined cards and accessibility behavior.
-
-## Appearance and application components
-
-Appearance choices are independent. The zero value preserves the original
-Indigo, comfortable, rounded defaults:
-
-```go
-appearance := components.Appearance{
- Preset: components.PresetForest,
- Density: components.DensityCompact,
- Corners: components.CornersSoft,
- Typography: components.TypographySans,
- TextSize: components.TextStandard,
- Width: components.WidthWide,
- Elevation: components.ElevationFlat,
-}
-page := components.Layout(components.LayoutProps{
- Title: "My workspace",
- Theme: components.ThemeDark,
- Appearance: appearance,
-}, body)
-```
-
-Available presets: Indigo, Neutral, Forest, Rose. Choose comfortable/compact
-spacing, rounded/nearly-square/soft corners, system sans/serif/monospace fonts,
-standard/large text, narrow/standard/wide content, and flat/subtle/raised/floating shadows.
-No font downloads are needed. Light/dark/system mode remains an independent
-`LayoutProps.Theme` setting.
+Follow the [tested Go/templ quickstart](docs/quickstart.md), or start with
+[plain HTML and CSS](examples/html) with no Go dependency. Run the full local
+showcase with `go run ./examples/basic -open`.
-`Appearance.Normalize()` validates preferences and falls back to defaults.
-`Attributes()` produces native `data-*` attributes for applications that own
-their document shell. `CSS()` exports overrides referencing TendUI's canonical
-tokens, so it **requires tendui.css** and must be loaded after it. CSS exports
-configure appearance; keep light/dark/system mode on the root HTML element.
-`LayoutProps.Head` accepts trusted application components after the base
-stylesheet, for custom stylesheet links or metadata.
+## Explore your next step
-Open `/settings` in the demo to preview, save, reset, and download appearance
-settings. `/appearance.css` and `/appearance.go` export the selected settings.
-The library owns no persistence; the example uses bounded, validated preference
-cookies. Query previews take precedence over saved preferences without changing
-them. Cookie data never controls authorization or application behavior.
-
-New components:
-
-| Component | Contract |
+| I want to… | Start here |
| --- | --- |
-| `Badge(BadgeProps)` | Text plus neutral/info/success/warning/danger tone |
-| `Alert(AlertProps)` | Title, message, optional children; `Live` opts into announcements |
-| `ErrorSummary(ErrorSummaryProps)` | Error messages linked to application-supplied field IDs |
-| `Textarea(TextareaProps)` | Label, value, rows, maximum length, required/disabled/read-only/error states |
-| `RadioGroup(RadioGroupProps)` | Native fieldset/legend and labeled options sharing one name |
-| `Switch(SwitchProps)` | Native checkbox with switch semantics and keyboard interaction |
-| `FileInput(FileInputProps)` | Native file chooser with accept/multiple/required states |
-| `AppShell(AppShellProps)` | Brand, actions, sidebar links, optional footer, and one main landmark |
-
-`CheckboxProps` now also supports `Invalid` and `DescribedBy`. Use
-`FormProps{Method: components.MethodPost, Multipart: true}` for actual uploads.
-Applications must validate file types, bound request sizes, and handle storage;
-the `accept` attribute is only a browser hint. The playground file picker does
-not upload data.
-
-Static alerts do not create live regions. Set `Live: true` for inserted feedback:
-danger uses `role="alert"`; other tones use `role="status"`. These attributes
-do not guarantee announcements on a full page navigation, so visible error
-summaries and linked field errors remain available.
-
-Use `AppShell` as the body inside `Layout`, with page content as templ children.
-It owns the main landmark; do not nest another main or application shell inside
-it. `MainID` defaults to `main` and connects the skip link. Sidebar navigation
-uses a native disclosure that works on desktop and mobile without JavaScript.
-See `/workspace` and `examples/site/workspace.templ` for a complete example.
-
-## Native interactions and navigation
-
-`Dialog` and `Popover` use native HTML. Supply a nonempty ID with no whitespace;
-invalid IDs return a render error. IDs must be unique within the document, and
-their `-title` and `-description` suffixes are reserved for accessible labels.
-
-```templ
-@components.Button(components.ButtonProps{
- Text: "Review request",
- CommandFor: "review-request",
- Command: components.DialogShowModal,
-})
-@components.Dialog(components.DialogProps{
- ID: "review-request", Title: "Review request",
- Description: "Check the details before submitting.",
-}) {
- @components.Form(components.FormProps{
- Action: "/requests/approve", Method: components.MethodPost,
- }) {
- @components.Button(components.ButtonProps{
- Text: "Approve", Type: components.ButtonTypeSubmit,
- })
- }
-}
-```
-
-Keep dialogs outside other forms. The dialog includes a native `method="dialog"`
-close form and initially focuses that non-destructive close control. Closing a
-dialog does not submit an application request; use a separate normal form for
-an action that must reach Go. Native opener/closer fields on Button always force
-`type="button"`, even if Type was set to submit. Unsupported command values
-produce an inert button. Do not combine native commands and HTMX requests on
-the same control.
-
-Modal opening uses the newer `commandfor`/`command="show-modal"` attributes.
-Provide an ordinary-page alternative for unsupported browsers, as `/interactions`
-does. No JavaScript fallback is injected. See the browser's
-[native dialog commands](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/dialog#modal_dialogs_using_invoker_commands).
-
-For popovers, use `ButtonProps{PopoverTarget: "help"}` and
-`Popover(PopoverProps{ID: "help", Title: "Help"})` with templ children. The default
-automatic mode supports dismissal outside the panel; `Mode: PopoverManual`
-requires an explicit close/toggle action. Both variants include a close button.
-`PopoverAction` supports Toggle, Show, and Hide. Panels are non-modal, centered
-by default, and do not claim ARIA menu semantics. Unsupported browsers may show
-the content inline. See the [native popover attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/popover).
-
-`Breadcrumbs(BreadcrumbsProps{Items: ...})` renders ancestor links and a final,
-non-linked current page. Separators are hidden from assistive technology.
-
-`Pagination(PaginationProps{Page: page, TotalPages: total, URLForPage: pageURL})`
-renders normal links, current/disabled states, and a bounded page window with
-ellipses. Zero/one-page results omit the navigation. Current page numbers are
-clamped to range; a missing URL callback for multiple pages returns a render
-error. The application supplies totals, page data, and URLs that retain its
-filters. No database, router, or query convention is imposed by the component.
-Labels can be localized through the props.
-
-The dashboard example demonstrates filter → sort → paginate on a request-owned
-copy of sample records. Page URLs preserve search, status, sorting, page size,
-and appearance query settings. Invalid or excessive page numbers are normalized;
-empty results keep their recovery link.
-
-## Themes and the zero-JavaScript contract
-
-Set `LayoutProps.Theme` to `ThemeLight` or `ThemeDark` to emit the root
-`data-theme` attribute. Leave it at `ThemeSystem` (the empty default) to follow
-`prefers-color-scheme`. Override `--tendui-*` properties in your own CSS loaded
-after TendUI. Dark tokens have no effect on explicitly light pages.
-
-`ThemeToggle()` renders a small native form that POSTs to `/api/theme/toggle`.
-Place it **outside other forms**. You can pass `ThemeToggleProps` for a localized
-label and your application's CSRF token. The consumer owns cookies, request
-protection, routing, and page rendering; the library has no global theme state.
-
-The included endpoint alternates a validated `light`/`dark` cookie and returns
-303 to the current demo when its same-origin Referer is available, otherwise to
-the homepage. Cookies are HttpOnly, SameSite=Strict, and Secure over TLS;
-the example uses Go's cross-origin request protection. Behind a TLS-terminating
-proxy, configure your application's Secure-cookie policy explicitly. The first
-example visit uses light so the server can deterministically toggle it; the
-library's system theme remains available for applications that prefer it.
-
-The button preserves the requested `hx-post="/api/theme/toggle"`,
-`hx-target="html"`, and `hx-swap="outerHTML"` attributes. These are inert without
-HTMX. **HTMX itself is JavaScript** and is never included or loaded by TendUI.
-Consumers that already use it can use the hooks without writing custom JS.
-
-A document root swap is not a reliable way to replace a page's root attributes
-and head. The example detects `HX-Request: true` and sends **200 plus
-`HX-Redirect` to the cleaned demo URL** after setting the cookie. This requests a
-full navigation. Both native and HTMX paths remove the `theme` query parameter
-so a previous preview cannot override the new cookie, while preserving other
-settings. For HTMX, a validated same-origin `HX-Current-URL` takes precedence over
-Referer; invalid values fall back to a validated Referer, then the homepage.
-Only known demo pages are accepted. These headers control presentation, not access.
-HTMX does not process its response headers on 3xx responses. See the upstream
-[redirect header documentation](https://htmx.org/headers/hx-redirect/) and
-[swap reference](https://htmx.org/attributes/hx-swap/).
-The isolated browser consumer verifies this navigation with HTMX 2.0.11 in
-Chromium, Firefox and WebKit. The runtime is a test dependency and is not bundled.
-
-## Full pages and optional HTMX fragments
-
-`render` is a standard-library-only package. Its small `Component` interface is
-implemented by templ components; no adapter or additional dependency is needed.
-Use the same route for ordinary navigation and partial updates:
-
-```go
-import (
- "log"
- "net/http"
-
- "github.com/Tend-Stack/TendUI/v2026/components"
- "github.com/Tend-Stack/TendUI/v2026/render"
-)
-
-func profileHandler(w http.ResponseWriter, r *http.Request) {
- panel := components.Alert(components.AlertProps{Title: "Profile", Message: "Your profile is ready."})
- page := components.Layout(components.LayoutProps{Title: "Profile"}, panel)
- w.Header().Set("Cache-Control", "private, no-store")
- if err := render.HTML(w, r, http.StatusOK, page, panel); err != nil {
- log.Printf("render profile: %v", err)
- }
-}
-```
-
-`HTML` chooses the fragment for `HX-Request: true`, but serves the full page for
-history restoration or boosted navigation. A nil fragment always serves the page.
-It preserves existing `Vary` values and adds the three headers that affect the
-representation. Rendering is buffered so a component error produces a generic
-500 instead of partially written HTML; errors are returned for logging. HEAD
-has no body, including on failures. After calling it, do not write another error
-response: a render failure has already sent 500, and a transport failure may
-have committed the response. Only the selected component is rendered.
-
-The helper leaves authentication, CSRF protection, cache policy, CSP and status
-selection to the application. HTMX headers are presentation hints, never proof
-of identity or permission. For cacheable pages, use representation-specific ETags.
-Buffering is intended for bounded UI pages/fragments, not streaming responses.
-
-The [inline editing example](examples/site/editing.go) pairs native form actions
-and link destinations with `HxPost`/`HxGet`, `HxTarget` and `HxSwap`. It returns
-303 after a successful native POST and 200 with the updated panel for an HTMX
-request. Invalid native submissions return 422. Invalid HTMX submissions return
-200 **with field errors and no save**, because default HTMX does not swap 422
-responses. This policy is explicit in the example, not imposed by `render.HTML`.
-See the upstream [response handling](https://htmx.org/docs/#response-handling),
-[history](https://htmx.org/docs/#history) and
-[caching](https://htmx.org/docs/#caching) documentation.
-
-The included demo remains JavaScript-free and blocks scripts with CSP. Its native
-flow and HTTP fragment contract are testable separately. Applications enabling
-HTMX must supply their own runtime and appropriate CSP; this project neither
-loads nor bundles it. The example cookie is unsigned cosmetic sample data,
-validated and escaped on every read. It is not an account/session implementation.
-
-## Motion, surfaces and useful states
-
-Cards now accept typed `Surface`, `Entry`, `Delay` and `HoverLift` options.
-Choose tinted, outlined or gradient borders; use fade, rise or scale entrances.
-`Reveal` wraps other content with the same entrance system. `Skeleton`,
-`EmptyState` and `Stat` cover loading, recovery and metric presentation.
-
-`Appearance.Motion` accepts `MotionSystem` (default) or `MotionOff`. System mode
-respects OS reduced motion. Off also disables hover displacement; CSS/Go exports
-include the choice. Entrances run once, and loading decoration stops after three
-cycles. All styling stays in the embedded CSS, with no runtime dependency.
-
-See [the motion guide](docs/motion.md), try `/motion`, and track the broader
-[product roadmap](ROADMAP.md). See the [recorded browser results](docs/release-verification.md).
-
-## Data tables and navigation patterns
-
-`DataTable` provides semantic headers/row scopes, application-owned sort URLs,
-cell component slots, striped/compact styles, and loading/empty states. The
-Dashboard uses it for bidirectional sorting and native checkbox selection review.
-`Tabs` supplies ordinary page navigation; `Steps` labels application-owned
-progress; `Disclosure` uses native details/summary with optional grouping.
-
-See the [data and navigation guide](docs/data-navigation.md) and `/patterns`
-for composition rules, working examples and validation boundaries.
-
-## Composable fields and multi-step forms
-
-`Field` pairs a raw control with its label, description and error through typed
-`FieldProps.ControlAttributes()`. `InputGroup` adds text prefixes/suffixes while
-preserving native control behavior. `ButtonProps.FormNoValidate` supports Back
-actions that submit edits without native constraints blocking navigation.
-
-The `/wizard` project-brief example preserves draft values across Back/Continue,
-checks all submitted fields on completion, and shows a validated preview without
-creating or storing a project. See [the form guide](docs/forms.md) for composition,
-validation and workflow ownership rules.
-
-The `/uploads` example connects the native file chooser to a bounded Go CSV
-preview: download a sample, upload up to 64 KiB/50 rows, and inspect validated
-results or line-specific errors. Uploaded content stays in request memory;
-nothing is saved or imported. See the form guide for limits and HTTP behavior.
-
-## Accessibility and print
-
-Palette checks cover all built-in presets across page, card and subtle surfaces.
-Print uses a neutral palette independent of the screen theme, with readable
-outlined actions and native checkbox rendering for switches. See the
-[accessibility and print guide](docs/accessibility.md) for the measured scope,
-customization rules and browser checks still required.
-
-## Layout composition
-
-`Stack` provides vertical rhythm; `Cluster` wraps actions and other related items
-into rows. Typed gap and alignment props use a density-aware spacing scale,
-preserve document order, and compose with Grid, Card and native forms. Existing
-CSS utilities retain their behavior. Try `/patterns?section=composition` or read
-[the layout guide](docs/layout.md) for spacing tokens, semantics and examples.
-
-## Reading content
-
-`Prose` styles application-owned HTML for help pages, guides and release notes.
-Choose a typed reading measure, use native headings/lists/code, and opt embedded
-widgets out of prose typography. Try `/patterns?section=reading` and see the
-[reading-content guide](docs/prose.md) for tokens, semantics and examples.
-
-## Inline icons
-
-The Icon component provides 24 original SVG drawings, compiled into Go and
-rendered inline. They inherit text color and use no external image or font files.
-Button and Link accept optional `IconBefore`, `IconAfter` and `AriaLabel` fields.
-Icon-only actions require an explicit accessible name; decorative icons stay
-hidden from assistive technology. Explore `/catalog/icon` and the
-[icon guide](docs/icons.md) for sizes, composition and verification limits.
-
-## Searchable component catalog
-
-Open `/catalog` to browse all 37 public templ components by name, category or
-usage notes. Each entry provides a preview, guidance and a downloadable `.templ`
-recipe drawn from the same source compiled for that preview. Layouts open as
-standalone pages to preserve document landmarks. Search and pagination use Go
-requests; no client runtime or external assets are added.
-
-Catalog-only CSS and recipe source are embedded in the example executable, not
-the library stylesheet. See [the catalog guide](docs/catalog.md) for recipe
-adaptation, coverage checks and validation boundaries.
-
-## Maintaining the library
-
-Only contributors changing `.templ` files need the generator:
-
-```sh
-go install github.com/a-h/templ/cmd/templ@v0.3.1100
-templ fmt .
-templ generate
-go test -race ./...
-go vet ./...
-```
-
-Commit generated Go alongside its source. A normal Go build consumes CSS
-directly through `go:embed`; CSS editing needs no asset build step. Test output
-belongs under `tests/results/` and is ignored except for its placeholder.
-
-The Go-only developer tool also checks generated-source consistency, compiles
-all catalog downloads independently, records benchmarks and builds the versioned
-review executable. See [the development guide](docs/development.md) and
-[measured performance](docs/performance.md):
-
-```sh
-go run ./cmd/tendui-dev check
-go run ./cmd/tendui-dev api
-go run ./cmd/tendui-dev generated
-go run ./cmd/tendui-dev recipes
-go run ./cmd/tendui-dev bench
-go run ./cmd/tendui-dev build
-./tests/results/demos/tendui-demo -version
-```
-
-`check` already includes `api`; the separate command is useful during API review.
-The checked-in declaration baseline catches changed props, constants, signatures
-and method sets. See [API review and migration](docs/api-compatibility.md) for
-intentional updates and the limits of this check.
-
-The [CI matrix](docs/ci.md) checks native Linux, macOS and Windows with Go 1.26.0
-and 1.27.3, plus a vulnerability scan. Browser checks cover Chromium, Firefox and
-WebKit. These jobs must pass on the preview source; see
-[preview release notes](docs/releases/2026.2.0-preview.2.md). The older
-[release verification](docs/release-verification.md) documents the pre-rename
-release only and is not evidence for the current preview.
-
-Versions follow `YEAR.RELEASE.FIX`, with SemVer prerelease suffixes for previews:
-`v2026.2.0-preview.2`. Install the explicit tag; a preview is not a stable API promise.
-Development builds use `git describe --tags --long --dirty`.
-
-Go treats 2026 as the semantic major version, so the module path ends in
-`/v2026`. A new annual line such as 2027 will need `/v2027` and consumer import
-updates. Fixes and previews on the 2026 line retain `/v2026`.
-
-## Project links
-
-- Source and issues: https://github.com/Tend-Stack/TendUI
-- Website source: https://github.com/Tend-Stack/TendUI-web
-
-Fetch and integrate GitHub `main` before contributing. See `HANDOFF.md` for the
-current development entry points and remaining release checks.
+| Find a component and copy a recipe | [Live catalog](https://tendui.com/catalog) |
+| Customize themes, forms and layouts | [Library guide](docs/library-guide.md) |
+| Test interactions and appearance | [Playground](https://tendui.com/playground) · [Motion and surfaces](https://tendui.com/motion) |
+| Work with Codex or Claude Code | [Agent setup](docs/agents.md) |
+| Move from the earlier module | [Migration notes](docs/tendui-migration.md) |
+| Understand compatibility and verification | [API policy](docs/api-compatibility.md) · [Development guide](docs/development.md) |
-## License
+## Preview, with clear boundaries
-MIT. See [LICENSE](LICENSE).
+This is a preview; APIs may change before a stable release. Install a fixed
+version and review [release notes](docs/releases/2026.2.0-preview.2.md) when
+upgrading. Versions follow `YEAR.RELEASE.FIX`, with `-preview.N` for previews.
+The Go module uses `/v2026` for the 2026 major-version line.
-## Contributing
+Your application owns routing, authentication, request protection, persistence
+and sessions. HTMX is optional and requires application-supplied JavaScript.
-See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, review and MIT + DCO sign-off.
-Report vulnerabilities privately using [SECURITY.md](SECURITY.md); community
-participation follows [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+## Build with us
-## Coding agents
+Contributions are welcome under **MIT + DCO**. Contributors retain copyright;
+a human reviews and signs off every contribution. Start with
+[CONTRIBUTING.md](CONTRIBUTING.md), [open issues](https://github.com/Tend-Stack/TendUI/issues),
+or the [coding-agent instructions](AGENTS.md). `CLAUDE.md` imports the same guidance.
-Repository contributors should read [AGENTS.md](AGENTS.md); `CLAUDE.md` imports
-the same instructions for Claude Code. For applications using TendUI, see
-[the coding-agent guide](https://tendui.com/docs/agents) and merge its suggested
-section into your own project instructions.
+[Security reports](SECURITY.md) · [Code of conduct](CODE_OF_CONDUCT.md) · [MIT license](LICENSE) · [Website source](https://github.com/Tend-Stack/TendUI-web)
diff --git a/docs/brand/README.md b/docs/brand/README.md
index 0028295..3444a59 100644
--- a/docs/brand/README.md
+++ b/docs/brand/README.md
@@ -10,3 +10,11 @@ The website repository prepares the favicon, social previews and downloadable
web assets. See `https://tendui.com/brand/github-social-preview.png` for the
1280 × 640 GitHub social preview image. Uploading a social preview in repository
settings is separate from displaying the README logo.
+
+## README banners
+
+The light and dark README banners are copied unchanged from the owner-supplied
+Tend UI Gopher Brand Kit. Source names, byte sizes and SHA-256 hashes are recorded
+in [readme-banners.json](readme-banners.json). They are documentation assets and
+are not embedded into the runtime stylesheet or website executable. The README
+uses a `picture` element to follow the reader's preferred color scheme.
diff --git a/docs/brand/readme-banner-dark.png b/docs/brand/readme-banner-dark.png
new file mode 100644
index 0000000000000000000000000000000000000000..ef92e1c80bbd33e07e121a2c03d57717257c0208
GIT binary patch
literal 129454
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