Skip to content

feat: add mix/remix product switcher and restructure docs under /documentation/mix#9

Merged
tilucasoli merged 22 commits intomainfrom
tilucasoli/mix-remix-sidebar
Apr 18, 2026
Merged

feat: add mix/remix product switcher and restructure docs under /documentation/mix#9
tilucasoli merged 22 commits intomainfrom
tilucasoli/mix-remix-sidebar

Conversation

@tilucasoli
Copy link
Copy Markdown
Collaborator

Summary

  • Move existing docs from /documentation/* to /documentation/mix/*, scaffold a /documentation/remix placeholder, and add redirects plus internal link rewrites so legacy URLs keep working.
  • Add a MixRemixSwitcher sidebar component rendering Mix/Remix logos, mounted via _meta.tsx, with CSS that hides the inactive product and flattens the active one.
  • Wire a data-product attribute on <html> from the pathname so the sidebar and a Remix-specific green accent theme switch automatically.

Test plan

  • Visit /documentation/mix/... and confirm only Mix sections show in the sidebar with the Mix logo highlighted.
  • Visit /documentation/remix and confirm the green accent applies and only Remix is visible.
  • Hit a legacy /documentation/<path> URL and confirm redirect to /documentation/mix/<path>.

🤖 Generated with Claude Code

tilucasoli and others added 10 commits April 16, 2026 23:02
Captures the agreed structure for splitting docs into `documentation/mix/`
and `documentation/remix/` with a sidebar-top switcher, route-scoped
page map filtering, and redirects for existing URLs.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Task-by-task plan for splitting docs into mix/remix subtrees, adding
the sidebar-top switcher, portal-based injection, CSS-driven filtering,
and legacy URL redirects.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…n/mix

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Client-side portal finds .nextra-sidebar and prepends the switcher. The
mount component also sets data-product on <html>; global CSS rules keyed
off that attribute hide the inactive product's top-level <li> (matched
via its data-href button).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
The client-portal approach didn't make the switcher visible. Switch to
Nextra's native separator-with-React-title mechanism: _meta.tsx now
imports MixRemixSwitcher and renders it as the first entry, so Nextra
SSRs it directly inside .nextra-sidebar. MixRemixSwitcher itself now
owns the data-product html attribute (previously in the deleted
MixRemixSwitcherMount). CSS strips the default separator padding around
the switcher row.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@docs-page
Copy link
Copy Markdown

docs-page bot commented Apr 17, 2026

To view this pull requests documentation preview, visit the following URL:

docs.page/btwld/mix-docs~9

Documentation is deployed and generated using docs.page.

@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 17, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
mix-docs Ready Ready Preview, Comment Apr 18, 2026 0:15am

tilucasoli and others added 4 commits April 17, 2026 12:11
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Swap the sidebar MixRemixSwitcher for a FloatingNavbar pill that renders
across all routes, add a standalone /remix landing page, and tighten the
remix accent color.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
tilucasoli and others added 2 commits April 17, 2026 19:38
Introduction, component references (19 components including divider rewritten
in the Mix widgets format), and a dedicated Fortal design-system page. The
.dark body now pulls a shared radial glow + grid from CSS custom properties so
docs and homepage share the same backdrop.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Pulls remix 0.2.0 into mix_docs_preview and registers 19 component examples
(accordion, avatar, badge, button, callout, card, checkbox, divider,
icon_button, menu, progress, radio, select, slider, spinner, switch, tabs,
textfield, tooltip), each adapted from the btwld/remix api examples and
exposed as 'components/<name>.0' so FlutterPreview tags in the remix docs
resolve without any per-doc wiring.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Adds a `## Interactive preview` section with a `<FlutterPreview>` pointing at
the matching `components/<name>.0` entry in mix_docs_preview, right before the
Fortal styles section. Heights are tuned per component (240 default, 280 for
card/textfield, 320 for menu/select/tabs, 360 for accordion).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replace heading-style property lists with markdown tables matching the
mix docs format (Prop | Type | Required / Default Value) across all 18
remix component pages.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replace heading-style method lists with markdown tables (Method |
Description) across all 17 remix component pages that have a Style
Methods section.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Show a dismissible Nextra banner on the /remix landing and
/documentation/remix/* pages linking to the remix GitHub repo, so
readers know the package is still in active development.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Replace the top-of-page Nextra Banner with a fixed bottom-right alert
styled to match the existing floating surfaces. Uses localStorage to
persist dismissal.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Drop the close button and localStorage state; the banner now always
renders on remix pages. Removing the client-only dismissed state also
means the banner is SSR-rendered, eliminating the post-hydration flash.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@tilucasoli tilucasoli merged commit 225e864 into main Apr 18, 2026
4 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