Skip to content

Theme: brand harmonization with www (page header, tokens, Poppins 600, links) - #565

Merged
wienke merged 5 commits into
masterfrom
docs/brand-alignment-2026-10
Oct 14, 2026
Merged

wienke merged 5 commits into
masterfrom
docs/brand-alignment-2026-10

Conversation

@wienke

@wienke wienke commented Oct 14, 2026

Copy link
Copy Markdown
Contributor

Aligns the docs theme with the new brand guidelines and with www.thethingsnetwork.org, which shipped the same changes today.

What changes

  • Shared page header: the docs home, section pages and articles open with the same page header as www (light band, breadcrumb, one label, Poppins SemiBold title, intro). The markup and CSS follow the website's page-header contract.
  • Shared brand tokens: colours, type, 8px radius, spacing, motion and a visible focus ring now come from the website exporter (ttn-tokens.css + self-hosted Poppins 600). This replaces the hand-copied values.
  • Type:
    • All headings in Poppins SemiBold 600, self-hosted (the Google Fonts Poppins 700 link is removed).
    • No uppercase or wide letter spacing.
    • Line heights from the type scale.
  • Links: TTI blue #0047FF on light backgrounds and #6699FF on dark.
  • Logos: current lockups for TTN, The Things Stack and LoRaWAN. The old TTS-logo.svg and TTN-logo.svg URLs now serve the current files.
  • Motion: token-based transitions, with prefers-reduced-motion respected.
  • Header and footer: re-exported from the website (new footer tagline, UTM tags on links to The Things Industries). This also includes the earlier docs/tti-utm-tags commit.
  • Content:
    • 13 pages that started at h3 or h4 now start at h2.
    • The unused lead, actions and button shortcodes are removed.

Checked

  • Builds with the pinned Hugo 0.88.1: 243 pages, in both the default and the gh-pages config.
  • Before/after screenshots at 1440 and 390 px.
  • Reviewed in two adversarial rounds; the confirmed findings are fixed.

Merge after the www release is live (it is, as of today), so the header and design values match.

🤖 Generated with Claude Code

wienke and others added 5 commits October 13, 2026 10:33
Re-exported doc/data/site_nav.json from thethingsnetwork-v2 (scripts/export-docs-chrome.mjs):
Enterprise, "Need professional support?" and the footer's The Things Stack link now carry
utm_source=thethingsnetwork.org, utm_medium=referral, utm_campaign=ttn-website, utm_content=<placement>.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
- Radius on the 8px grid: 8px for buttons, inputs, cards, menus and controls
  (no more pill buttons), 16px only for the feature banner and video panel,
  999px only for the account avatar.
- No uppercase or positive letter-spacing: sidebar/rail labels, eyebrows,
  glossary letters, table headers and footer headings are Inter Label/Small
  13/16 600, sentence case.
- Line-heights: body 15/21; explicit line-heights on labels, buttons, card
  titles and headings; long-form prose keeps 16/1.6 on purpose.
- Motion: one shared token-based transition (140ms, standard easing) on
  color/background/border/shadow for every interactive element, 220ms for the
  dropdown chevron, no width animation on the search field, and a
  prefers-reduced-motion block.
- Logos: TTN horizontal color/white, The Things Stack and LoRaWAN from the
  brand logo set as supplied; the stale TTS-logo.svg / TTN-logo.svg URLs now
  serve the current lockups; unused outdated PNGs removed.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
…600, link colour)

- Load the website's generated ttn-tokens.css (export-brand-tokens.mjs: self-hosted Inter 300-600 +
  Poppins SemiBold 600, every brand token, .tn-wrap, .tn-eyebrow, motion, the tn-ph page header)
  before docs.css, concatenated into one css/docs.css. docs.css drops its own @font-face rules (Inter
  700, gstatic Poppins 700) and token copies; only docs-only tokens remain. Retire the Inter, Lato
  and AvantGarde font files.
- Page headers per the platform's docs/brand-page-header.md: the docs home and 404 get the tint band
  (tn-ph); every page with the left navigation gets the inset variant (crumbs, eyebrow = sidebar
  group, H2-style title, lede from `lead`/`description`, buttons from `actions` front matter). The
  LoRaWAN landing's lead and buttons move from shortcodes to front matter.
- Headings h2-h6 and card titles in Poppins 600; no 700 weights left. Text links tti-500 (tti-300
  on the navy feature panel), prose links underlined; navigation stays neutral. Icons on 16/24.
- Review fixes: header/footer rules identical to site.css (nav line-height 1.2: 28.8px items, drop
  items, account chip, toggle 24px, auth gap, mobile panel, footer line-heights); feature-panel
  eyebrow letter-spacing 0; small secondary text grey-700 (6.0:1) instead of grey-600 (3.6:1).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
…itle, heading order)

- ttn-tokens.css re-exported (shared --focus-ring token, page-header.css: underlined lede links,
  sized title <sup>, spaced phone sub-nav).
- Focus: :focus-visible = a 2px tti-500 outline; buttons, header links and the search field use
  --focus-ring (the #CCE8FF ring was ~1.2:1).
- Header "Enterprise" link: --ttn-700 (AA, was 4.48:1).
- Page header actions follow the shared button spec (48px, 14px 26px, primary = ttn-500 fill).
- Feature panel title: .dx-feature__title, a Poppins 600 H5 heading (was an Inter "eyebrow" h2).
- /docs/lorawan/: lede copy and the link to The Things Fundamentals certification restored.
- Deleted the unused lead, actions and button shortcodes and their CSS.
- 13 pages whose first heading was h3/h4 promoted so headings start at h2 (no skipped levels).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@wienke
wienke requested a review from pierrephz as a code owner October 14, 2026 21:17
@wienke
wienke merged commit f1f0075 into master Oct 14, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant