Skip to content

docs(brand): write the product name as Beatrax - #3

Merged
lessevv merged 3 commits into
mainfrom
docs/capitalise-product-name
Aug 16, 2026
Merged

lessevv merged 3 commits into
mainfrom
docs/capitalise-product-name

Conversation

@lessevv

@lessevv lessevv commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

What

Writes the product name with a capital B — Beatrax — across every user-facing surface the site owns:

  • Nav and footer wordmarks
  • Page <title>, JSON-LD name, and og:site_name (via site.name)
  • English copy (en.ts, pages-en.ts), Dutch copy (nl.ts, pages-nl.ts), feature cards, comparison tables
  • The served public/llms.txt and public/robots.txt
  • package.json description

Deliberately left lower-case

  • URLs and identifiers: beatrax.app, the beatrax-app org, the beatrax repo name
  • CLI commands (php artisan beatrax:setup) and release-asset filenames (beatrax_1.3.0_amd64.deb) in the reproduced changelog seed
  • The English FAQ questions and changelog release bodies — these are fetched at build time from the spec (faq.md) and the GitHub API, which still serve lower-case. Capitalising those belongs in the spec/app repos, not here.
  • The faqNl lookup keys stay lower-case so they keep matching the English questions the spec serves; only their Dutch values adopt the capital.

Verification

  • npm run check → 0 errors / 0 warnings (69 files)
  • npm run build → 33 pages built; Dutch FAQ confirmed rendering translated "Beatrax" (not English fallback), title/og confirmed "Beatrax"

Dependency

Depends on beatrax-app/spec#9, which flips DES-R1 to require the capital. That should merge first (GOV-R4 ordering). On merge here, deploy.yml publishes to GitHub Pages.

Spec: DES-R1

The name is being restyled with a capital B. This updates every
user-facing surface the site owns — the nav and footer wordmarks, the
page titles and structured-data name (through site.name), the English and
Dutch copy, the feature cards, the comparison tables, and the served
llms.txt / robots.txt — to write "Beatrax" in prose.

Left lower-case on purpose: URLs and identifiers (beatrax.app, the
beatrax-app org, the beatrax repo name), the CLI commands and
release-asset filenames in the reproduced changelog, and the English FAQ
questions and release bodies, which are fetched at build time from the
spec and the GitHub API and read lower-case there. The faqNl lookup keys
stay lower-case so they keep matching the English questions the spec
still serves, while their Dutch values adopt the capital.

Depends on beatrax-app/spec#9, which flips DES-R1 to require the capital.

Spec: DES-R1
Signed-off-by: Wessel Verheij <info@nightworks.io>
@github-actions github-actions Bot added dependencies Dependency update (Renovate / Dependabot) brand Design system, visual language, marks area:ux Cross-cutting UX properties — error model, accessibility, palette, PWA labels Aug 8, 2026
@github-actions

github-actions Bot commented Aug 8, 2026 •

Copy link
Copy Markdown

📎 Spec references

This PR cites the following spec identifiers:

  • DES-R1 — The product name MUST be written lower-case in prose, including at the start of a sentence.
  • GOV-R12 — Routine maintenance — dependencies, formatting, pipeline mechanics — MUST cite this identifier.

Updated automatically on each push.

lessevv added 2 commits August 9, 2026 00:33
The dependency scanner is a required check and reports three high-severity
transitive advisories against the committed lockfile: fast-uri 3.1.4
(GHSA-7p8r-x3mc-p8w7), js-yaml 4.3.0 (GHSA-5p4m-2wfm-xmqj) and nanoid
3.3.16 (GHSA-2v37-7h3g-55p8). All three fixes are patch releases inside
the existing semver ranges, so this is a lockfile-only bump — package.json
is untouched. `npm audit` now reports zero vulnerabilities and the site
still type-checks and builds all 33 pages.

Spec: GOV-R12
Signed-off-by: Wessel Verheij <info@nightworks.io>
Automatic analysis flags the i18n files as ~99% duplicated, which fails the
quality gate's new-code duplication condition. The duplication is by design:
en.ts / nl.ts and pages-en.ts / pages-nl.ts are parallel translations of one
structure, defined key-for-key so the type system stops the two locales from
drifting. Copy-paste detection has nothing useful to say about that, so the
locale files are excluded from CPD only — bug, vulnerability and
maintainability analysis still runs on them.

Automatic analysis ignores sonar-project.properties, so the setting lives in
.sonarcloud.properties, the file it does read.

Spec: GOV-R12
Signed-off-by: Wessel Verheij <info@nightworks.io>
@sonarqubecloud

sonarqubecloud Bot commented Aug 8, 2026

Copy link
Copy Markdown

@lessevv
lessevv merged commit ffecec4 into main Aug 16, 2026
13 checks passed
@lessevv
lessevv deleted the docs/capitalise-product-name branch August 16, 2026 21:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:ux Cross-cutting UX properties — error model, accessibility, palette, PWA brand Design system, visual language, marks dependencies Dependency update (Renovate / Dependabot)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant