Skip to content

Docs landing & product-page rework#748

Open
CahidArda wants to merge 28 commits into
mainfrom
docs-landing-rework
Open

Docs landing & product-page rework#748
CahidArda wants to merge 28 commits into
mainfrom
docs-landing-rework

Conversation

@CahidArda

@CahidArda CahidArda commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

https://linear.app/upstash/issue/DX-2806/docs-landing-page-improvements

Summary

Reworks the Get Started landing page and every product landing page into richer
hubs. Adds a shared catalog of SDKs, integrations, and demos so each product page
surfaces the right resources, and gives the landing a custom layout that keeps the
docs sidebar.

Shared building blocks

  • snippets/catalog.jsx: one source of truth for SDKs, integrations, demos, and
    guides. Filter by product and type; cards show a language icon where relevant.
  • snippets/landing.jsx: custom landing components (hero, product grid, agent
    resources, concepts, community).
  • style.css: custom card and section styles for light and dark.
  • Icons: product icons (img/icons/*.svg), language icons (TypeScript and Python
    from Tabler, Ruby logo), the Context7 mark, and Tabler icons for the
    agent-resource and concept cards.

Per-page changes

  • Get Started (introduction.mdx): custom landing (mode: frame, keeps the
    sidebar). Hero, Products grid, Agent Resources (MCP Server, Skills, CLI,
    Context7), Concepts, and Community.
  • Redis (redis/overall/getstarted): SDKs, Integrations, and Featured Demos
    (Hacker News Trends, Eve).
  • Redis Search (redis/search/introduction): a Demos section showing the
    search-related demos.
  • QStash (qstash/overall/getstarted): SDKs and Integrations.
  • Workflow (workflow/getstarted): SDKs and Demos.
  • Search (search/overall/getstarted): SDKs and Integrations (including
    Documentation Crawler and Database Migrator).
  • Box (box/overall/quickstart): SDKs (TypeScript, Python, CLI) and Guides
    (OpenClaw, Hermes, Crabbox, Playwright).
  • Vector (vector/overall/getstarted): SDKs and Integrations.

Future work

  • Migration guides: a "Migrate to Upstash" section is scaffolded
    (snippets/migrate.jsx) but hidden. It will list source platforms (Redis Cloud,
    ElastiCache, DynamoDB, and others) once the guides exist.
  • Console screenshots: an "In the Upstash Console" showcase is planned for each
    product page once the screenshots are ready.

Note on style.css

Custom CSS is officially supported by Mintlify
(they auto-load a root style.css and recommend CSS files over inline styles), so
the amount here is fine. Most of it is our own .u-* classes.

Page-specific overrides are scoped with Mintlify's documented
data-current-path
selector (e.g. the mode: frame full-width fix only applies to /introduction).

The one caveat: a couple of rules still target Mintlify's internal elements
(#content-area / #content-side-layout, plus a prose <img> margin reset).
Mintlify warns that "styling of common elements is subject to change," so these
could break on a future Mintlify upgrade. They're isolated and commented in
style.css.

@mintlify

mintlify Bot commented Jul 3, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
upstash 🟢 Ready View Preview Jul 3, 2026, 12:29 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@CahidArda CahidArda changed the title docs: rework Get Started + product landing pages (Supabase-style) docs: rework Get Started + product landing pages Jul 3, 2026
… Redis demos; fix MCP link to /agent-resources/mcp
…r and Database Migrator to Search integrations
…rgets (redirect stubs don't redirect on direct nav)
@CahidArda CahidArda changed the title docs: rework Get Started + product landing pages Docs landing & product-page rework Jul 9, 2026
…low Agents SDK; drop hero buttons; re-add console tabs (placeholders)
…e-width fix via data-current-path instead of :has()
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