Skip to content

Align docs with the Reflex marketing design - #7549

Merged
carlosabadia merged 8 commits into
mainfrom
codex/docs-marketing-style
Oct 14, 2026
Merged

carlosabadia merged 8 commits into
mainfrom
codex/docs-marketing-style

Conversation

@Alek99

@Alek99 Alek99 commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

The documentation site still used the older visual system across its navigation, landing pages, article controls, and component catalogs. This brings those surfaces into the current Reflex marketing style with Inter/Geist typography, warm neutral colors, the opal announcement banner, and compact, consistent controls.

Changes

  • Restyle the docs overview, AI workflow cards, component and integration catalogs, recipes, and 404 page.
  • Align desktop and mobile navigation, search, feedback, code examples, tables, callouts, and Back/Next links; add an accessible title and close control to the mobile documentation drawer.
  • Keep the documentation content, routes, code syntax colors, and live example behavior intact. Add scoped hooks in reflex-site-shared, local font assets with licenses, and support for dark mode and reduced motion.

Validation

  • Docs application suite: 668 passed, 65 skipped (test_published_seo.py excluded because this is a local change).
  • Relevant shared docs component tests: 71 passed. Frontend quality checks: 5 passed.
  • Production compilation and bundle completed for all 1,073 registered docs routes.
  • Manually checked representative desktop/mobile pages, light/dark themes, navigation and search, live examples, API controls, integration filtering, and the compact Back/Next links.
  • Ruff checks and formatting, Pyright, codespell, and git diff --check passed for the changed files.

Browser coverage is representative rather than an automated run of every documentation route. This PR is a draft for visual review.

View guided diff Turn on auto-fix

@codspeed

codspeed Bot commented Oct 13, 2026 •

Copy link
Copy Markdown

Merging this PR will not alter performance

⚠️ 18 benchmarks spent significant time in system calls

System calls cannot be consistently instrumented, so they are not included in the measure, which understates the real cost. Please switch to the Walltime instrument to accurately measure system calls.

Measurement and system calls

✅ 148 untouched benchmarks


Comparing codex/docs-marketing-style (7494632) with main (2fc4a9c)

Open in CodSpeed

@greptile-apps

greptile-apps Bot commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 5/5

[Medium impact] The PR appears safe to merge; no actionable new issues were found.

Summary

Updates the docs site to the marketing design with Inter/Geist typography, warm colors, and an opal announcement banner.

  • Docs pages use Inter, Geist, and warm colors in both themes.
  • The docs landing pages present guides and AI workflows as compact cards.
  • Docs navigation and article pages use compact, accessible controls.
  • Component reference pages give live examples and options a compact style.
  • Catalogs, recipes, and component previews use matching cards and controls.

Reviews (6) · Last reviewed commit: "Merge branch 'main' into codex/docs-mark..." · Reviewed by Greptile

Comment thread docs/app/reflex_docs/pages/docs_landing/views/enterprise.py Outdated
Comment thread docs/app/reflex_docs/views/docs_announcement_banner.py Outdated
Alek99 and others added 6 commits October 13, 2026 13:57
Review fixes:
- Reuse section_heading for the Enterprise, Cloud, Self-Hosting, and
  Other overview sections instead of repeating its heading markup. The
  sections now take their heading spacing from the helper's bottom
  margin rather than a flex gap; the rendered layout is unchanged.
- Add Returns sections to the docstrings of the docs announcement
  banner, the docs navbar helpers (github_button, logo, navigation_menu,
  docs_navbar), and the overview call to action.

Narrow-screen fixes carried over from the in-progress mobile layout work:
- Start wide examples at the left edge of their scroll container: demo
  and generated API previews use safe centering, and the API preview
  scrolls horizontally instead of overflowing the reading column.
- Let long headings such as API identifiers wrap inside the reading
  column instead of widening the page.
- Cover the API preview with a unit test and both behaviors at 320px
  and 390px with preview browser tests.
- Previous/next links share a two-column grid instead of flex items
  beside a spacer, which left each link a third of the column. A lone
  next link stays in the right column, and the pager is labelled as
  adjacent-page navigation.
- The docs footer's theme and social controls wrap on narrow screens,
  so every social link stays reachable.
- Sidebar links that are not the current page darken on hover again, in
  the sidebar and the mobile drawer. Their grey rule outranked the hover
  rule; its :not() conditions now sit in :where() so they add no
  specificity.

The pager test builds its page from placeholder content so it does not
re-run demo code that earlier tests already executed, and the footer test
uses the file's existing typing pattern so it passes pyright.
@carlosabadia
carlosabadia marked this pull request as ready for review October 14, 2026 19:48
@carlosabadia
carlosabadia requested a review from a team as a code owner October 14, 2026 19:48

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

All reported issues were addressed across 53 files

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread packages/reflex-site-shared/news/+docs-theme-hooks.docs.md
Comment thread docs/app/reflex_docs/templates/docpage/docpage.py
@carlosabadia
carlosabadia merged commit 11f6e17 into main Oct 14, 2026
146 checks passed
@carlosabadia
carlosabadia deleted the codex/docs-marketing-style branch October 14, 2026 20:19
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