Skip to content

fix(stacks-docs-next): conditional banner margin and dupe description fix#2237

Merged
dancormier merged 1 commit intomainfrom
STACKS-843/docs-page-fixes
Apr 15, 2026
Merged

fix(stacks-docs-next): conditional banner margin and dupe description fix#2237
dancormier merged 1 commit intomainfrom
STACKS-843/docs-page-fixes

Conversation

@dancormier
Copy link
Copy Markdown
Contributor

Summary

  • On pages without a banner image, the breadcrumb row had an unconditional mb128 (128px) gap before the page title, which created an awkward large blank space. This is now conditional: mb128 when a banner image is present, mb24 otherwise.
  • flex.md had its description text duplicated: once in the frontmatter description: field (rendered by the page template in the styled header area) and once as a standalone paragraph near the end of the file's content. The body duplicate is removed. Also fixes a stray </p> at the end of the frontmatter value.

Related Issue

STACKS-843

Changes

packages/stacks-docs-next

  • src/routes/[category]/[[section]]/[subsection]/+page.svelte — make mb128 on breadcrumb row conditional on data?.active?.image
  • src/docs/public/system/base/flex.md — remove duplicate description paragraph from content body; fix stray </p> in frontmatter

Testing

These are docs-only changes. Verify visually:

  • A page with a banner image (e.g. /brand/logo) should have the large gap between breadcrumbs and title as before
  • A page without a banner image (e.g. /system/accessibility/intro) should have a smaller mb24 gap instead of the previous mb128
  • The /system/base/flex page should not show the description text twice once legacy is removed

This PR was generated by a developer using an AI agent with the
stacks-v3-dev skill

…tion

- Apply mb128 below breadcrumb row only when a banner image is present;
  fall back to mb24 on pages without a banner
- Remove duplicate description paragraph from flex.md content (it already
  exists in the frontmatter which the template renders in the page header)
- Fix stray </p> at end of flex.md description frontmatter value

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@dancormier dancormier requested a review from a team April 14, 2026 22:52
@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 14, 2026

⚠️ No Changeset found

Latest commit: 5edb1d9

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@netlify
Copy link
Copy Markdown

netlify bot commented Apr 14, 2026

Deploy Preview for stacks ready!

Name Link
🔨 Latest commit 5edb1d9
🔍 Latest deploy log https://app.netlify.com/projects/stacks/deploys/69dec544f7e3f20007bb84d9
😎 Deploy Preview https://deploy-preview-2237--stacks.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@dancormier dancormier marked this pull request as draft April 14, 2026 23:11
@dancormier dancormier changed the title fix(stacks-docs-next): conditional banner margin and fix flex description fix(stacks-docs-next): conditional banner margin and dupe description fix Apr 14, 2026
Copy link
Copy Markdown
Collaborator

@abovedave abovedave left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested locally, looks good

@dancormier dancormier marked this pull request as ready for review April 15, 2026 15:55
@dancormier dancormier merged commit d30bc72 into main Apr 15, 2026
8 checks passed
@dancormier dancormier deleted the STACKS-843/docs-page-fixes branch April 15, 2026 15:56
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.

2 participants