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
25 changes: 16 additions & 9 deletions .github/settings/PROJECT_BOARD.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,10 @@
# Shared TendUI project board

The GitHub connector used for preparation cannot create Projects. The issues
below already exist; this file describes the owner setup still needed, not a
claim that a board is active.

Create an organization-level **TendUI** project at
https://github.com/orgs/Tend-Stack/projects using the Board layout. It should
track both `Tend-Stack/TendUI` and `Tend-Stack/TendUI-web`.
The shared [TendUI project](https://github.com/orgs/Tend-Stack/projects/2) was
created and verified on 2026-11-07 UTC. Both `Tend-Stack/TendUI` and
`Tend-Stack/TendUI-web` are linked. Status and Priority fields, four named board
views and the four seed issues below were configured by the owner setup script.
The board remains private pending publication review.

## Fields and views

Expand All @@ -26,8 +24,17 @@ track both `Tend-Stack/TendUI` and `Tend-Stack/TendUI-web`.
- https://github.com/Tend-Stack/TendUI/issues/5 — html/template recipe; Normal, Ready, good first issue.
- https://github.com/Tend-Stack/TendUI-web/issues/3 — visual baselines; Normal, Backlog.

Link the current preview PRs as In review. Add the board URL to each repository's
About/Projects area and CONTRIBUTING.md once the board exists.
Add current review PRs as In review during triage. The project is linked to both
repositories and referenced in their CONTRIBUTING.md files.

## Remaining UI configuration

- Open All work and group the board by Status. Arrange columns as Backlog,
Ready, In progress, In review, Done; keep existing option identities.
- Review the default View 1 table and keep it only if useful for triage.
- The Launch view filters `label:launch`; apply that label to launch tasks.
- Verify the built-in automation below in the Project settings. The setup script
did not enable or verify these workflows.

## Automation and triage

Expand Down
16 changes: 9 additions & 7 deletions .github/settings/README.md
Original file line number Diff line number Diff line change
@@ -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-web/rules/26745169)).
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-web/rulesets --input .github/settings/main-ruleset.json
gh api --method PUT repos/Tend-Stack/TendUI-web/rulesets/26745169 --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
Expand Down
4 changes: 4 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
18 changes: 16 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,9 @@
# TendUI Web
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/brand/readme-banner-dark.png">
<img src="docs/brand/readme-banner-light.png" alt="Tend UI — Modern UI for Go" width="1200">
</picture>

<img src="static/brand/mascot.svg" alt="TendUI" width="112">
# The home of TendUI

The documentation and examples website for [TendUI](https://github.com/Tend-Stack/TendUI):
beautiful interfaces with no frontend build pipeline. Pure CSS and semantic HTML
Expand All @@ -27,6 +30,17 @@ cache for already-downloaded dependencies, records a tag or exact pseudo-version
and removes its temporary proxy and cache. Commit the resulting module metadata,
manifest, and vendor directory together. No local `replace` ships in the repo.

[Visit tendui.com](https://tendui.com) · [Documentation](https://tendui.com/docs) · [Component catalog](https://tendui.com/catalog) · [Library source](https://github.com/Tend-Stack/TendUI)

## At a glance

| Surface | Purpose |
| --- | --- |
| Documentation | Go/templ and HTML quickstarts, theming, accessibility and agent setup. |
| Catalog | Component previews and downloadable recipes. |
| Playground | Native controls for states, appearance and interactions. |
| Deployment | One Go binary with embedded assets and vendored dependencies. |

## Run

Requires Go 1.26 or newer. Use a patched compiler for deployment.
Expand Down
2 changes: 1 addition & 1 deletion content/install.html
Original file line number Diff line number Diff line change
Expand Up @@ -70,5 +70,5 @@ <h2>5. Ship one binary</h2>
<p>Your generated page and TendUI stylesheet are compiled into the executable using Go's native embedding. No runtime asset directory, Node.js, npm or bundled JavaScript is needed. Add application-specific storage, routing and production server configuration as required.</p>
<p>This is the <a href="https://github.com/Tend-Stack/TendUI/tree/v2026.2.0-preview.2/examples/quickstart">tested quickstart in the preview source</a>.</p>
<h2>Versioning</h2>
<p>Releases use <code>YEAR.RELEASE.FIX</code>. This prerelease is <code>v2026.2.0-preview.2</code>; API changes remain possible before stable release. The <code>/v2026</code> module suffix follows Go's major-version rules. Historical pre-rename tags are not TendUI installation targets.</p>
<p>Releases use <code>YEAR.RELEASE.FIX</code>. This prerelease is <code>v2026.2.0-preview.2</code>; API changes remain possible before stable release. The <code>/v2026</code> module suffix follows Go's major-version rules.</p>
{{end}}
9 changes: 9 additions & 0 deletions docs/brand/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# TendUI website documentation artwork

## 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.
Binary file added docs/brand/readme-banner-dark.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/brand/readme-banner-light.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 16 additions & 0 deletions docs/brand/readme-banners.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
[
{
"file": "readme-banner-dark.png",
"source": "03_web_and_social/illustrated-header-dark-1800x420.png",
"processing": "Copied unchanged from the owner-supplied Tend UI Gopher Brand Kit",
"sha256": "abfccb9cfa2169c767a213eb8fd57c07fe18984d95f917ec1731941c89293eea",
"bytes": 129454
},
{
"file": "readme-banner-light.png",
"source": "03_web_and_social/illustrated-header-light-1600x400.png",
"processing": "Copied unchanged from the owner-supplied Tend UI Gopher Brand Kit",
"sha256": "7a3e7ecc43532cb70d2127efefe2ddb4d9174c0af377d9d94f7d5a9d7f70ecd3",
"bytes": 123912
}
]
2 changes: 1 addition & 1 deletion static/docs.css
Original file line number Diff line number Diff line change
Expand Up @@ -46,4 +46,4 @@
.prose .example-directory h3 { font-size: 1.2rem; font-weight: 600; line-height: 1.35; margin: 0 0 .75rem; }
.example-directory p { color: var(--tendui-muted); }
.example-directory .example-link { margin-block-start: auto; font-size: .9rem; text-decoration: none; }
.example-directory .example-link:hover { text-decoration: underline; }
.example-directory .example-link:hover { text-decoration: none; }
41 changes: 41 additions & 0 deletions static/header.css
Original file line number Diff line number Diff line change
Expand Up @@ -8,3 +8,44 @@

.site-source-link { display: inline-flex; align-items: center; gap: .5rem; }
.site-source-icon { flex: none; inline-size: 1rem; block-size: 1rem; }

/* Website action links: clear targets without decorative text underlines.
Scoped to navigation/actions so in-text documentation links remain identifiable. */
.catalog-card h2 a,
.catalog-card h2 a:hover { text-decoration: none; }
.catalog-card h2 a:hover { color: var(--tendui-primary); }
.catalog-card-link,
.example-directory .example-link,
.catalog-section-heading > a,
.catalog-results-heading > a {
display: inline-flex;
align-items: center;
align-self: flex-start;
gap: .5rem;
padding: .4rem .65rem;
border: 1px solid transparent;
border-radius: .5rem;
background: var(--tendui-subtle);
color: var(--tendui-primary);
font-weight: 600;
text-decoration: none;
}
.catalog-card-link:hover,
.example-directory .example-link:hover,
.catalog-section-heading > a:hover,
.catalog-results-heading > a:hover {
background: var(--tendui-surface);
border-color: var(--tendui-primary);
text-decoration: none;
}
.catalog-card a:focus-visible,
.example-directory .example-link:focus-visible,
.catalog-section-heading > a:focus-visible,
.catalog-results-heading > a:focus-visible {
outline: 3px solid var(--tendui-primary);
outline-offset: 4px;
}
@media (forced-colors: active) {
.catalog-card-link, .example-directory .example-link,
.catalog-section-heading > a, .catalog-results-heading > a { border-color: LinkText; }
}
4 changes: 2 additions & 2 deletions static/site.css
Original file line number Diff line number Diff line change
Expand Up @@ -116,8 +116,8 @@ footer a { text-decoration: none; }
.mascot-welcome img { flex: none; inline-size: clamp(4rem, 18cqi, 7rem); block-size: auto; }
.mascot-welcome p { margin: .4rem 0; color: var(--text); font-size: 1.3rem; font-weight: 600; }
.mascot-welcome span { color: var(--muted); font-size: .75rem; }
.principles h2 a { text-decoration: none; }
.principles h2 a:hover { text-decoration: underline; }
.principles h2 a { display: inline-block; padding: .15rem .4rem; margin-inline-start: -.4rem; border-radius: .4rem; text-decoration: none; }
.principles h2 a:hover, .principles h2 a:focus-visible { color: var(--accent); background: var(--tendui-subtle); text-decoration: none; }
@media (max-width: 650px) { .mascot-welcome { gap: .5rem; } }

/* Arrange the preview by its own available width, including on tablets. */
Expand Down
29 changes: 29 additions & 0 deletions tests/browser/site.spec.js
Original file line number Diff line number Diff line change
Expand Up @@ -213,3 +213,32 @@ test('HTML onboarding downloads match the working example', async ({ browser, re
await expect(page.locator('script')).toHaveCount(0);
await context.close();
});


test('homepage and catalog actions use clear hover and keyboard treatments', async ({ page }, testInfo) => {
for (const theme of ['dark', 'light']) {
await page.context().addCookies([{ name: 'tendui_theme', value: theme, url: 'http://127.0.0.1:8080' }]);
await page.goto('/');
await expect(page.locator('html')).toHaveAttribute('data-theme', theme);
const principle = page.locator('.principles h2 a').first();
await principle.hover();
await expect(principle).toHaveCSS('text-decoration-line', 'none');
await page.locator('.principles').screenshot({ path: testInfo.outputPath(`principles-${theme}.png`) });
await page.goto('/catalog');
const card = page.locator('.catalog-card').first();
const action = card.locator('.catalog-card-link');
await expect(action).toHaveCSS('text-decoration-line', 'none');
await action.hover();
await expect(action).toHaveCSS('text-decoration-line', 'none');
await action.focus();
await page.keyboard.press('Tab');
await page.keyboard.press('Shift+Tab');
await expect(action).toBeFocused();
expect(await action.evaluate(e => getComputedStyle(e).outlineStyle)).not.toBe('none');
await card.screenshot({ path: testInfo.outputPath(`catalog-action-${theme}.png`) });
const href = await action.getAttribute('href');
await action.click();
await expect(page).toHaveURL(new RegExp(href + '$'));
await expect(page.getByRole('heading', { name: 'Templ example' })).toBeVisible();
}
});