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
2 changes: 1 addition & 1 deletion .github/workflows/browser.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ on:
permissions:
contents: read
concurrency:
group: gothui-browser-${{ github.ref }}
group: tendui-browser-${{ github.ref }}
cancel-in-progress: true
jobs:
browser:
Expand Down
16 changes: 8 additions & 8 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: Release GothUI
name: Release TendUI
on:
push:
tags: ['v2026.*']
Expand All @@ -7,7 +7,7 @@ permissions:
contents: write
actions: read
concurrency:
group: gothui-release-${{ github.ref }}
group: tendui-release-${{ github.ref }}
cancel-in-progress: false
jobs:
publish:
Expand Down Expand Up @@ -36,7 +36,7 @@ jobs:
python3 - <<'PY'
import json, os
runs = json.load(open('tests/results/release/checks.json'))['workflow_runs']
for name in ['Verify GothUI', 'Browser verification']:
for name in ['Verify TendUI', 'Browser verification']:
matching = [r for r in runs if r['head_sha'] == os.environ['GITHUB_SHA'] and r['name'] == name]
if not matching or max(matching, key=lambda r:r['id'])['conclusion'] != 'success':
raise SystemExit('Missing passing exact-commit checks: ' + name)
Expand All @@ -49,7 +49,7 @@ jobs:
release_consumer=$(mktemp -d)
trap 'go clean -modcache; rm -rf "$release_consumer"' EXIT
export GOMODCACHE="$release_consumer/modules"
export GOPRIVATE=github.com/Tend-Stack/GothUI
export GOPRIVATE=github.com/Tend-Stack/TendUI
export GOPROXY=https://proxy.golang.org,direct
export GOWORK=off
export GIT_TERMINAL_PROMPT=0
Expand All @@ -60,12 +60,12 @@ jobs:
export GIT_CONFIG_VALUE_0="AUTHORIZATION: basic $auth"
cp tests/release/consumer_test.go.txt "$release_consumer/consumer_test.go"
cd "$release_consumer"
go mod init example.com/gothui-release-consumer
go get "github.com/Tend-Stack/GothUI/v2026@$GITHUB_REF_NAME"
go mod init example.com/tendui-release-consumer
go get "github.com/Tend-Stack/TendUI/v2026@$GITHUB_REF_NAME"
go mod tidy
go test -v ./... | tee "$GITHUB_WORKSPACE/tests/results/release/consumer.log"
go mod verify
go list -m -json github.com/Tend-Stack/GothUI/v2026 > "$GITHUB_WORKSPACE/tests/results/release/module.json"
go list -m -json github.com/Tend-Stack/TendUI/v2026 > "$GITHUB_WORKSPACE/tests/results/release/module.json"
python3 - <<'PY'
import json, os
p = os.environ['GITHUB_WORKSPACE'] + '/tests/results/release/module.json'
Expand All @@ -78,7 +78,7 @@ jobs:
run: |
set -euo pipefail
if ! gh release view "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" > /dev/null 2>&1; then
gh release create "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" --verify-tag --title "GothUI $GITHUB_REF_NAME" --notes-file docs/releases/2026.1.0.md
gh release create "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" --verify-tag --title "TendUI $GITHUB_REF_NAME" --notes-file docs/releases/2026.1.0.md
fi
- name: Retain release installation evidence
if: always()
Expand Down
14 changes: 7 additions & 7 deletions .github/workflows/verify.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
name: Verify GothUI
name: Verify TendUI

on:
pull_request:
Expand All @@ -10,7 +10,7 @@ permissions:
contents: read

concurrency:
group: gothui-verify-${{ github.workflow }}-${{ github.ref }}
group: tendui-verify-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true

env:
Expand Down Expand Up @@ -45,17 +45,17 @@ jobs:
- name: Verify downloaded modules
run: go mod verify
- name: Check API, formatting, dependencies, size, race tests and vet
run: go run ./cmd/gothui-dev check
run: go run ./cmd/tendui-dev check
- name: Install pinned templ generator
run: go install github.com/a-h/templ/cmd/templ@v0.3.1100
- name: Compare generated source
run: go run ./cmd/gothui-dev generated
run: go run ./cmd/tendui-dev generated
- name: Compile all standalone catalog recipes
run: go run ./cmd/gothui-dev recipes
run: go run ./cmd/tendui-dev recipes
- name: Install and test the versioned module in an isolated consumer
run: go run ./cmd/gothui-dev consumer
run: go run ./cmd/tendui-dev consumer
- name: Build and run native version smoke check
run: go run ./cmd/gothui-dev build
run: go run ./cmd/tendui-dev build
- name: Retain bounded verification evidence
if: always()
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2
Expand Down
22 changes: 13 additions & 9 deletions HANDOFF.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# GothUI development handoff
# TendUI development handoff

GothUI is an original semantic CSS and typed templ component library for Go.
The public collaboration source is https://github.com/Tend-Stack/GothUI.
The standalone website lives at https://github.com/Tend-Stack/GothUI-Web.
TendUI is an original semantic CSS and typed templ component library for Go.
The public collaboration source is https://github.com/Tend-Stack/TendUI.
The standalone website lives at https://github.com/Tend-Stack/TendUI-web.

## Current implementation

- Embedded CSS; no Node/npm, CDN, external fonts, or bundled JavaScript.
- 36 templ components, 24 inline SVG icons, and 13 demo areas.
- 37 templ components, 24 inline SVG icons, and 13 demo areas.
- Light/dark/system appearance, color presets, density, typography, widths,
elevation, and bounded CSS motion with reduced-motion support.
- Native form workflows and optional HTMX attributes; applications supply
Expand All @@ -22,14 +22,14 @@ See [README.md](README.md) for setup and component usage,
[docs/ci.md](docs/ci.md) for the native verification matrix, and
[ROADMAP.md](ROADMAP.md) for remaining work.

Run `go run ./cmd/gothui-dev check` after code changes. Template edits also need
Run `go run ./cmd/tendui-dev check` after code changes. Template edits also need
`generated` and `recipes` checks. Commit generated Go alongside templates.
Use `go run ./cmd/gothui-dev build` to refresh the single review executable;
run `./tests/results/demos/gothui-demo -open` on a host with browser access.
Use `go run ./cmd/tendui-dev build` to refresh the single review executable;
run `./tests/results/demos/tendui-demo -open` on a host with browser access.

## Release boundary

The v2026.1.0 candidate at `2f622c95fbf7` passed the six native Go/OS jobs,
The historical pre-rename v2026.1.0 candidate at `2f622c95fbf7` passed the six native Go/OS jobs,
the vulnerability scan, and 53 browser checks in Chromium, Firefox and WebKit.
One WebKit forced-color emulation check is explicitly unsupported/skipped.
The documentation website passed all eight desktop/mobile browser checks and
Expand All @@ -41,3 +41,7 @@ automated accessibility checks are not a conformance certification.
Keep focused local test evidence under ignored `tests/results/`. Reuse one
review binary, remove completed disposable build environments, and preserve
active work. Fetch and integrate GitHub `main` before publishing changes.

The TendUI rename and shared SiteHeader are development changes after that tag.
See [migration notes](docs/tendui-migration.md); historical release evidence is
not validation of these changes.
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
MIT License

Copyright (c) 2026 GothUI contributors
Copyright (c) 2026 TendUI contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
Expand Down
74 changes: 42 additions & 32 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,31 +1,41 @@
# GothUI
# TendUI

<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/brand/logo-dark.svg">
<img src="docs/brand/logo-light.svg" alt="GothUI" width="240">
<img src="docs/brand/logo-light.svg" alt="Tend UI" width="260">
</picture>

Semantic CSS and typed templ components, embedded in your Go binary.
No Node.js, npm, Sass, CDN, web fonts, bundled JavaScript, or asset compilation.
**Beautiful interfaces. No build pipeline.**

GothUI pairs original semantic CSS with composable Go components. Build
Pure CSS. Semantic HTML. No Node.js, no npm, no bundled JavaScript.
First-class Go and templ support.

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.

TendUI pairs original semantic CSS with composable Go components. Build
interfaces with native HTML, typed configuration, and application-owned behavior.

See [migration notes](docs/tendui-migration.md) for the renamed Go module, CSS
namespace, and use with other HTML stacks.

## Install and run

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.

After repository publication, consumers can use:
The renamed TendUI module is currently available from the development branch:

```sh
go get github.com/Tend-Stack/GothUI/v2026
go get github.com/Tend-Stack/TendUI/v2026@main
```

The GitHub repository is currently private. Until that changes, Go downloads
require repository credentials and `GOPRIVATE=github.com/Tend-Stack/GothUI`.
require repository credentials and `GOPRIVATE=github.com/Tend-Stack/TendUI`.
Generated `*_templ.go` files ship with the module, so consumers do not need
the templ CLI to use these components from Go.

Expand All @@ -38,14 +48,14 @@ import (
"log"
"net/http"

"github.com/Tend-Stack/GothUI/v2026"
"github.com/Tend-Stack/GothUI/v2026/components"
"github.com/Tend-Stack/TendUI/v2026"
"github.com/Tend-Stack/TendUI/v2026/components"
"github.com/a-h/templ"
)

func main() {
mux := http.NewServeMux()
mux.Handle(gothui.AssetPath, gothui.AssetHandler())
mux.Handle(tendui.AssetPath, tendui.AssetHandler())
page := components.Layout(components.LayoutProps{
Title: "My Go app",
Language: "en",
Expand Down Expand Up @@ -76,8 +86,8 @@ disabled.
## Packages and assets

```text
gothui.go embedded CSS handler
static/gothui.css readable semantic stylesheet
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
Expand All @@ -100,9 +110,9 @@ render/ buffered page/fragment HTTP responses
examples/site/ thirteen demo pages, searchable catalog, preference cookies and downloads
```

Mount `AssetHandler()` directly at `/gothui/static/`. Do **not** apply
Mount `AssetHandler()` directly at `/tendui/static/`. Do **not** apply
`http.StripPrefix`: the handler already recognizes the complete path. It serves
only `gothui.css`, supports GET/HEAD, conditional ETag requests and byte ranges,
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
Expand Down Expand Up @@ -189,8 +199,8 @@ No font downloads are needed. Light/dark/system mode remains an independent

`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 GothUI's canonical
tokens, so it **requires gothui.css** and must be loaded after it. CSS exports
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.
Expand Down Expand Up @@ -298,8 +308,8 @@ empty results keep their recovery link.

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 `--gothui-*` properties in your own CSS loaded
after GothUI. Dark tokens have no effect on explicitly light pages.
`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
Expand All @@ -316,7 +326,7 @@ 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 GothUI.
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
Expand Down Expand Up @@ -344,8 +354,8 @@ import (
"log"
"net/http"

"github.com/Tend-Stack/GothUI/v2026/components"
"github.com/Tend-Stack/GothUI/v2026/render"
"github.com/Tend-Stack/TendUI/v2026/components"
"github.com/Tend-Stack/TendUI/v2026/render"
)

func profileHandler(w http.ResponseWriter, r *http.Request) {
Expand Down Expand Up @@ -465,7 +475,7 @@ hidden from assistive technology. Explore `/catalog/icon` and the

## Searchable component catalog

Open `/catalog` to browse all 36 public templ components by name, category or
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
Expand Down Expand Up @@ -497,13 +507,13 @@ review executable. See [the development guide](docs/development.md) and
[measured performance](docs/performance.md):

```sh
go run ./cmd/gothui-dev check
go run ./cmd/gothui-dev api
go run ./cmd/gothui-dev generated
go run ./cmd/gothui-dev recipes
go run ./cmd/gothui-dev bench
go run ./cmd/gothui-dev build
./tests/results/demos/gothui-demo -version
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.
Expand All @@ -528,8 +538,8 @@ fixes on the 2026 line keep `/v2026`. See Go's

## Project links

- Source and issues: https://github.com/Tend-Stack/GothUI
- Website source: https://github.com/Tend-Stack/GothUI-Web
- 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.
Expand Down
2 changes: 1 addition & 1 deletion ROADMAP.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# GothUI product roadmap
# TendUI product roadmap

The objective is an elegant Go-native UI library that ships in a single Go binary,
with the breadth, polish and developer experience expected of modern UI systems.
Expand Down
Loading
Loading