feat(docs): update layout and categorise the sidebar items

[adithyaakrishna]

Summary

• Update the layout of docs and add missing content
• Categorise the sidebar items

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation
• Other: Layout and design update for docs

Testing

• cd apps/docs && bun run dev
• Check how the layout looks on the browser

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Screenshots/Videos

Before:

After:

[cursor]

PR Summary

Medium Risk
Mostly UI/content changes, but it also adds server-side filesystem checks to resolve GitHub source URLs and changes copy behavior to fetch MDX at runtime, which could affect rendering/build behavior and client clipboard flows.

Overview
Updates the docs layout and styling, including switching to the Season Sans + Martian Mono font stack, refining navbar/search/sidebar visuals, and adding a new persistent DocsFooter.

Enhances page actions by adding a new ViewOptionsPopover (open Markdown/GitHub/LLM tools) and updating LLMCopyButton to copy via a markdownUrl fetch for normal docs pages; OpenAPI pages continue to copy generated content. Docs pages now compute markdownUrl and a best-effort GitHub source URL (via existsSync) for these actions.

Reorganizes sidebar separators into categorized sections with icons, and adds/updates documentation content (new blocks docs like Memory, Note, Thinking, Webhook (outbound), plus new Tables and Mailer pages and various copy/model list updates across locales).

^{Written by Cursor Bugbot for commit 06035f6. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

[vercel]

@adithyaakrishna is attempting to deploy a commit to the Sim Team on Vercel.

A member of the Team first needs to authorize it.

[greptile-apps]

Greptile Summary

This PR refreshes the Sim docs layout: it replaces Inter/Geist with Season + Martian Mono fonts, introduces a categorised sidebar with section icons and a neutral active-state palette, adds a ViewOptionsPopover that lets readers open a page in GitHub, copy its Markdown, or send it to various AI tools (ChatGPT, Claude, Cursor, Scira), and reorganises the sidebar navigation with translated section headings across all six locales.

Key changes:

• layout.tsx: swaps Google fonts for a local Season woff2 + Martian Mono; removes AnimatedBlocks.
• sidebar-components.tsx: refactors style constants; adds icon mapping for new section separators.
• All meta.json files: adds translated section separators (Basics, Core Concepts, Integrations, Security & Configuration, Execution & Operations, Deployment, Reference) and adds missing mailer/tables entries to non-English locales.
• page.tsx + components/ai/page-actions.tsx + components/page-actions.tsx: new ViewOptionsPopover and MarkdownCopyButton components; server-side resolveGitHubDocUrl resolves the source file on disk to produce a GitHub link.
• global.css: font variable references updated and several sidebar/code/navbar CSS tweaks.

Issues found:

• CONTENT_DOCS_DIR = join(process.cwd(), 'apps/docs/content/docs') will resolve to a non-existent path when Next.js runs from the apps/docs/ directory (the standard dev setup), causing the GitHub link to silently never appear in the popover.
• The module-level fetch cache in MarkdownCopyButton permanently stores rejected promises; a single failed network request prevents copy from ever working again without a page reload.
• global.css received extensive style edits, violating the project guideline to avoid this file in favour of component-local styles.
• Two relative imports (../../lib/cn, '../icons') bypass the @/ path alias convention used everywhere else.

Confidence Score: 4/5

• Safe to merge after fixing the CONTENT_DOCS_DIR path; the rest of the layout and categorisation changes are solid.
• The docs layout refresh and sidebar categorisation work well. Two logic issues need attention: the wrong process.cwd() prefix silently breaks the GitHub link, and the fetch cache can trap rejected promises. Both are confined to the new ViewOptionsPopover feature and don't affect the primary docs reading experience. The style/import issues are minor. A one-line path fix and a cache-eviction guard would clear all P1 concerns.
• apps/docs/app/[lang]/[[...slug]]/page.tsx (CONTENT_DOCS_DIR path), apps/docs/components/ai/page-actions.tsx (rejected-promise cache)

Important Files Changed

Filename	Overview
apps/docs/app/[lang]/[[...slug]]/page.tsx	Adds ViewOptionsPopover with GitHub/AI links; CONTENT_DOCS_DIR path likely wrong (doubles apps/docs prefix), silently breaking the GitHub link; minor indentation inconsistency on second popover block.
apps/docs/components/ai/page-actions.tsx	New MarkdownCopyButton and ViewOptionsPopover components; module-level fetch cache permanently stores rejected promises, preventing retry after a failed network request.
apps/docs/app/global.css	Extensive style updates (font references geist→season/martianMono, sidebar colors, hover/active states, code block styling); violates the guideline to avoid editing globals.css unless necessary.
apps/docs/components/ui/popover.tsx	New Radix-based Popover wrapper; uses a relative ../../lib/cn import instead of the @/lib/cn path alias used project-wide.
apps/docs/components/navbar/navbar.tsx	Adds Discord and Mothership CTA buttons, replaces "Mothership" nav tab with "Changelog"; uses a relative '../icons' import instead of @/components/icons.
apps/docs/app/[lang]/layout.tsx	Switches fonts from Inter/Geist Mono to Season (local) / Martian Mono; removes AnimatedBlocks; correctly applies new font CSS variables to html and body.
apps/docs/components/docs-layout/sidebar-components.tsx	Refactors sidebar item/folder styles to shared cn constants; adds per-section icons mapped from the new separator labels; neutral color palette replaces previous emerald accents.
apps/docs/content/docs/en/meta.json	Adds labeled section separators (Basics, Core Concepts, Integrations, Security & Configuration, Execution & Operations, Deployment, Reference) and moves quick-reference to the Reference section.

Sequence Diagram

sequenceDiagram
    participant Browser
    participant PageTSX as page.tsx (Server)
    participant FS as Node.js fs
    participant Client as ViewOptionsPopover (Client)
    participant GitHub
    participant AI as AI Tools (ChatGPT / Claude / etc.)

    PageTSX->>PageTSX: resolveGitHubDocUrl(page.url)
    PageTSX->>FS: existsSync(CONTENT_DOCS_DIR/lang/slug.mdx)
    FS-->>PageTSX: true/false
    PageTSX->>PageTSX: build GitHub blob URL (or undefined)
    PageTSX->>Browser: render ViewOptionsPopover(markdownUrl, githubUrl)

    Browser->>Client: user clicks "Open ▾"
    Client->>Client: useMemo → build items list
    Client-->>Browser: show popover with links

    Browser->>GitHub: Open in GitHub (if githubUrl defined)
    Browser->>Client: user clicks "Copy Markdown"
    Client->>Client: check module-level cache
    Client->>PageTSX: fetch(markdownUrl) → raw .mdx text
    PageTSX-->>Client: MDX content
    Client->>Browser: clipboard.write(content)

Loading

_{Reviews (1): Last reviewed commit: "chore: update layout and contents" | Re-trigger Greptile}