diff --git a/.github/settings/PROJECT_BOARD.md b/.github/settings/PROJECT_BOARD.md index 00fd23f..2ddb88c 100644 --- a/.github/settings/PROJECT_BOARD.md +++ b/.github/settings/PROJECT_BOARD.md @@ -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 @@ -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 diff --git a/.github/settings/README.md b/.github/settings/README.md index 7250ed5..d686b78 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-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 diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index ebab27f..32e278b 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 ac1cdce..5d3c553 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,9 @@ -# TendUI Web + + + Tend UI — Modern UI for Go + -TendUI +# 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 @@ -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. diff --git a/content/install.html b/content/install.html index 3f2914c..b2d8ec4 100644 --- a/content/install.html +++ b/content/install.html @@ -70,5 +70,5 @@

5. Ship one binary

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.

This is the tested quickstart in the preview source.

Versioning

-

Releases use YEAR.RELEASE.FIX. This prerelease is v2026.2.0-preview.2; API changes remain possible before stable release. The /v2026 module suffix follows Go's major-version rules. Historical pre-rename tags are not TendUI installation targets.

+

Releases use YEAR.RELEASE.FIX. This prerelease is v2026.2.0-preview.2; API changes remain possible before stable release. The /v2026 module suffix follows Go's major-version rules.

{{end}} diff --git a/docs/brand/README.md b/docs/brand/README.md new file mode 100644 index 0000000..bba48a3 --- /dev/null +++ b/docs/brand/README.md @@ -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. diff --git a/docs/brand/readme-banner-dark.png b/docs/brand/readme-banner-dark.png new file mode 100644 index 0000000..ef92e1c Binary files /dev/null and b/docs/brand/readme-banner-dark.png differ diff --git a/docs/brand/readme-banner-light.png b/docs/brand/readme-banner-light.png new file mode 100644 index 0000000..86ca331 Binary files /dev/null and b/docs/brand/readme-banner-light.png differ diff --git a/docs/brand/readme-banners.json b/docs/brand/readme-banners.json new file mode 100644 index 0000000..ebee64d --- /dev/null +++ b/docs/brand/readme-banners.json @@ -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 + } +] diff --git a/static/docs.css b/static/docs.css index 998c654..22fb19b 100644 --- a/static/docs.css +++ b/static/docs.css @@ -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; } diff --git a/static/header.css b/static/header.css index 7a22580..5f1503c 100644 --- a/static/header.css +++ b/static/header.css @@ -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; } +} diff --git a/static/site.css b/static/site.css index 5881a14..1b47139 100644 --- a/static/site.css +++ b/static/site.css @@ -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. */ diff --git a/tests/browser/site.spec.js b/tests/browser/site.spec.js index defb286..6943cb6 100644 --- a/tests/browser/site.spec.js +++ b/tests/browser/site.spec.js @@ -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(); + } +});