Website: Migrate to new public-facing site

[aidanfnv]

Preview: https://nvidia.github.io/flashdreams/pr-preview/after/

Changes the site theme, with different layouts depending on the page's content, purpose, and audience, and reorganizes the site into 5 sections:

1. Landing/home page, which consists of:

• A headline section, which uses auto-playing looping AVIF instead of video embed
• Why FlashDreams?
• "Performance" as a summary of some benchmarks from the "Models" section
• "Try FlashDreams!" with links to the "Get Started" section
• "Supported Models" with a glimpse of what models are in the "Models" section

2. Get Started:

• Consolidates the quickstart pages into a single "Get Started" page

3. Documentation:

• "Documentation" links to a landing page for the devleoper guides index page, the api/cli references index page, and the troubleshooting page
• Rewrites the index pages for the developer guides and api/cli references to use grids summarizing the contents
• Makes some prose changes to the developer guides to use more second person language and fix some typos
• Incorporates the troubleshooting doc into the documentation section and adds a link to it from the community support page

4. Models, which rewrites the existing models index page to include:

• Gallery of available models, with sample clips
• 2 categories of benchmarks: Autoregressive and Bidirectional vs Upstream, and Super-resolution
• Benchmark methodology
• How to run a model yourself (content from the original page)

5. Contribute, which includes:

• "Contribute" links to the contents of CONTRIBUTE.md, but there are additional support/contributing docs linked from there, including the existing Discord doc
• "Getting Help" doc to guide users to the right place should they have problems
• FAQ doc

Also changes the Sphinx search functionality to respect hyphens, so for example flashdreams-run actually searches for flashdreams-run instead of searching for flashdreams and/or run.

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[greptile-apps]

Greptile Summary

This PR migrates the FlashDreams documentation site from the Furo theme to pydata-sphinx-theme, reorganises the site into five sections (Home, Get Started, Documentation, Models, Contribute), and overhauls the homepage with a full-bleed marketing layout while preserving the reference-docs scaffold for all other pages.

• Theme migration and layout system: Replaces Furo with pydata-sphinx-theme; introduces a Jinja layout switch (_fd_is_reference) that routes marketing pages into a full-bleed fd-landing-main wrapper and reference pages into the standard docs scaffold. A CSS custom-property token system replaces the old ad-hoc overrides.
• Content consolidation: Merges installation.rst and first_world_model.rst into a single Get Started page; rewrites the models index into a video-card gallery with benchmark charts; adds FAQ, Getting Help, and a Documentation hub page.
• Custom search tokenizer: Registers a _SearchEnglishHyphenated subclass of SearchEnglish that indexes hyphenated CLI commands (e.g. flashdreams-run) as both the intact token and its parts, while querying only the intact token, preserving recall without ranking noise.

Confidence Score: 5/5

Safe to merge — all changes are documentation and static-site assets with no effect on the Python runtime.

The entire changeset is documentation infrastructure (RST content, Sphinx config, CSS, JS, Jinja templates). No Python runtime, API, or data-handling code is modified. The one dead-code finding in layout.html has no functional impact on the rendered site. Internal cross-references were verified to be intact after the quickstart consolidation.

docs/source/_templates/layout.html — the unreachable _fd_hero_indices variable warrants a quick cleanup pass.

Important Files Changed

Filename	Overview
docs/source/conf.py	Migrates from Furo to pydata-sphinx-theme; adds GA4 analytics, icon links, per-page sidebar/secondary-sidebar config, and a custom search tokenizer that preserves hyphenated terms.
docs/source/_templates/layout.html	Adds marketing vs reference layout switching and body-class logic; _fd_hero_indices is unreachable dead code (see comment).
docs/source/_static/js/supported_models_nav.js	New script that populates the homepage Supported Models right-rail by reading the on-page card grid; correctly guards against non-homepage pages with an early return.
docs/source/_static/js/image_zoom.js	Changes zoom from hover-with-delay to click-to-zoom; adds overlay click and Escape-key dismissal; CSS correctly sets pointer-events on the overlay.
docs/source/_static/js/benchmark_chart.js	Switches chart font-family from hardcoded DejaVu Sans to inherit; SVG text fill colors remain hardcoded to near-black (#111827), which is invisible in dark mode (pre-existing, noted elsewhere).
docs/source/_static/custom.css	Near-complete rewrite of site CSS; introduces CSS custom-property tokens, marketing layout components, dark/light theme support, and a wide layout for the models gallery page.
docs/source/models/index.rst	Rewrites the models index into a full gallery with video cards, benchmark methodology, and benchmark data; removes the orphan directive so the page is now part of the site nav.
docs/source/quickstart/index.rst	Consolidates the former installation.rst and first_world_model.rst (both deleted) into a single Get Started page.
docs/source/index.rst	Rewrites the homepage with hero section (AVIF), feature cards, performance stat tiles, CTA, and Supported Models grid; references all consolidated quickstart, models, documentation, and community sections.
docs/source/community/index.rst	Renamed from contribute.rst; now uses myst_parser to inline CONTRIBUTING.md and hosts the community toctree.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    REQ["Browser request for a page"] --> JINJA["layout.html: evaluate _fd_is_reference"]

    JINJA -->|"pagename startswith developer_guides/, api/, community/, models/, quickstart/\nor pagename in (documentation, troubleshooting, search, …)"| REF["Reference scaffold\n(super() → bd-article-container)"]
    JINJA -->|"everything else\n(only: index / master_doc)"| MKT["Marketing layout\n(fd-landing-main full-bleed)"]

    REF --> SIDEBAR["html_sidebars config\n(sidebar-nav-bs or empty per page)"]
    REF --> SEC["secondary_sidebar_items\n(page-toc per section)"]

    MKT --> NAVCHECK{"pagename == master_doc?"}
    NAVCHECK -->|Yes| RAIL["Inject #fd-models-nav aside\n(supported_models_nav.js populates it)"]
    NAVCHECK -->|No| NOMORE["No rail (no other marketing pages)"]

    JINJA --> BODY["body_tag block: assign CSS classes"]
    BODY --> LANDING["fd-page-landing (marketing pages)"]
    BODY --> PLAIN["fd-page-plain (marketing, no hero)"]
    BODY --> WIDE["fd-page-wide (models/index only)"]

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    REQ["Browser request for a page"] --> JINJA["layout.html: evaluate _fd_is_reference"]

    JINJA -->|"pagename startswith developer_guides/, api/, community/, models/, quickstart/\nor pagename in (documentation, troubleshooting, search, …)"| REF["Reference scaffold\n(super() → bd-article-container)"]
    JINJA -->|"everything else\n(only: index / master_doc)"| MKT["Marketing layout\n(fd-landing-main full-bleed)"]

    REF --> SIDEBAR["html_sidebars config\n(sidebar-nav-bs or empty per page)"]
    REF --> SEC["secondary_sidebar_items\n(page-toc per section)"]

    MKT --> NAVCHECK{"pagename == master_doc?"}
    NAVCHECK -->|Yes| RAIL["Inject #fd-models-nav aside\n(supported_models_nav.js populates it)"]
    NAVCHECK -->|No| NOMORE["No rail (no other marketing pages)"]

    JINJA --> BODY["body_tag block: assign CSS classes"]
    BODY --> LANDING["fd-page-landing (marketing pages)"]
    BODY --> PLAIN["fd-page-plain (marketing, no hero)"]
    BODY --> WIDE["fd-page-wide (models/index only)"]

Loading

_{Reviews (10): Last reviewed commit: "Move latency tuning back" | Re-trigger Greptile}

[greptile-apps]

Workflow auto-triggers are scoped to a branch that won't exist on main

Once this file is merged to main, neither the pull_request nor the push trigger will fire — both target dev/aidanf/flashdreams-site, which is the integration branch, not main. Only workflow_dispatch will work. The comment at the top of the file explains this is intentional, but the file in main is essentially inert from an automation standpoint. Consider confirming this is intended before merging, since a dormant preview workflow in main could mislead future maintainers.

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!