Ship a reliable integration

Ship a reliable integration

This is the Hextra review fixture described in the brand’s Hugo theme guidance. It exercises the states a theme has to prove before it can be approved: hierarchy, link behaviour, callouts, cards, code, status, and one primary action. Compare it against the Docsy fixture in examples/hugo-docsy/ — the two use the same content states, so a migration compares like with like.

Release boundary

Validate the configuration locally, then request promotion. The action below is the only primary action in this view.

Review release check

What the reader needs first

AreaStateOwner
ConfigurationValidatedPlatform team
DocumentationReviewedTechnical writer
ReleaseWaiting for approvalRelease manager

Link text stays blue — the Hextra configuration guide reads as a link, not as emphasis — while the accent-filled control above stays reserved for the next action. On narrow screens the table scrolls inside its own container rather than widening the page.

A card-led decision surface

Cards are scanning aids, not decoration. Their links stay links rather than becoming three competing primary actions.

Code remains a dark working surface

hugo.yaml
params:
  theme:
    default: system
    displayToggle: true
  navbar:
    width: wide

Inline code such as assets/css/custom.css stays distinct from its paragraph without looking like a second button. The block above stays dark in both theme modes, and its filename bar sits one step above the code surface rather than disappearing into it.

Status language is semantic

Validated

Success is only for a completed, evidenced check.

Needs attention

Warnings describe a condition to assess. The warning colour is gold, never the identity accent.

Blocked

Errors need a clear next action, and each callout carries a text label so the state never depends on colour alone.

Release check

At 320px, check the menu, table overflow, cards, action, code block, and table of contents. At 1280px, check reading measure, the sticky navigation, sidebar hierarchy, and the balance between the content column and its table of contents. Repeat each check in light and dark mode, with keyboard navigation and at 200% zoom.