Skip to content

docs-app styling pass: hero, themed demo cards, dark/light polish - #23

Merged
NullVoxPopuli merged 4 commits into
universal-ember:mainfrom
NullVoxPopuli-ai-agent:docs-style-pass
Jul 21, 2026
Merged

docs-app styling pass: hero, themed demo cards, dark/light polish#23
NullVoxPopuli merged 4 commits into
universal-ember:mainfrom
NullVoxPopuli-ai-agent:docs-style-pass

Conversation

@NullVoxPopuli-ai-agent

Copy link
Copy Markdown
Contributor

A styling/layout pass over the docs site, verified in a real browser in both themes (landing + docs pages + interacting with demos). Deliberately stays inside the universal-ember family language — no generic component-library look.

Landing

  • @universal-ember/ eyebrow over a large boxed form wordmark — echoing ember-primitives' boxed logo treatment.
  • Call-to-action is the family signature: docs-support's InternalLink with the offset-underline style, scaled — same as primitives. (An earlier iteration used a pill button; reverted as too generic.)
  • The blurb/features section had hard-coded 50%/66% widths; now centered max-width layout with text-wrap: balance, so it holds up on narrow viewports.

Demos

  • Every live demo now renders in a bordered light-dark() card (targeting .repl-sdk__demo, ember-repl's wrapper — the table-era .glimdown-render styles never matched, which is why demos floated unstyled in the prose).
  • Demo form controls previously forced color: black (table-era carryover) — illegible on dark backgrounds. Now inputs/selects/textareas/buttons have explicit light-dark() colors in both themes.
  • Gotcha for future reference: don't set color-scheme: light dark on individual controls — it re-enables OS preference resolution and defeats the site's forced theme (made inputs render light inside dark mode).

Also

  • Theme-aware hr.
  • The page-walking a11y test suite passes with the new styles (all pages × 3 themes).

Related, in docs-support

A separate small PR to ember-primitives is coming for the side-nav active-highlight not matching .md-suffixed URLs (every prose cross-link produces them, which silently drops the nav highlight) — that one benefits primitives/table/form alike.

🤖 Generated with Claude Code

NullVoxPopuli-ai-agent and others added 2 commits July 20, 2026 12:49
…rols

- landing: '@universal-ember/' eyebrow over a large boxed 'form' display
  title (echoing the family look), pill call-to-action, centered
  responsive blurb/features (fixed 50%/66% widths replaced with
  max-widths)
- every live demo now renders in a bordered light-dark() card
  (.repl-sdk__demo — ember-repl's wrapper — plus the older
  .glimdown-render for good measure); demo inputs/selects/textareas and
  buttons get explicit light-dark() colors instead of forced black text,
  which was illegible on dark backgrounds
- note: do not set 'color-scheme: light dark' on individual controls —
  it re-enables OS preference and defeats the site's forced scheme
- theme-aware hr

Verified in the browser in both themes (landing, docs pages, demos);
docs-app page-walk/a11y suite passes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…pill

The scaled InternalLink with docs-support's offset-underline treatment is
the universal-ember signature (same as ember-primitives); the pill
button read as generic.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor
Project Preview URL
Docs https://7168bf66.ue-form.pages.dev

Logs

@NullVoxPopuli
NullVoxPopuli merged commit eb5482c into universal-ember:main Jul 21, 2026
1 check passed
@NullVoxPopuli NullVoxPopuli added the documentation Improvements or additions to documentation label Jul 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants