[joshistoast]

Summary

Rebuilds the docs site for v7 so it looks and behaves like the app, and turns the densest guides from walls of prose into visual, interactive pages.

• Site: v7 app theme, topic sidebar with a switcher, shared header and page actions, topic-scoped search with settings results, a rebuilt home page (interactive tour, showcase, model families) and download page, and an OS/GPU setup picker on the install guides.
• App integration: the docs build generates a search index that the command palette uses to search the docs.
• Translations: German, Spanish and Hindi locales served from a translation catalog and synced through Crowdin, with parser-based checks that translated pages match the English structure.
• Guide rewrites, facts checked against the code:
  • Intermediates and Models introduction with annotated app sketches (numbered pins linked to a legend).
  • Upscaling with a before/after slider of real Model only vs Refine output and a static pipeline diagram.
  • A new Which memory option do I need? page with an interactive picker and one format comparison table; Low-VRAM, FP8 Storage, int8 Compute and SDNQ restructured; FP8 Compute split into its own page.
  • Multi-user admin and user guides rewritten around setup steps, role tables and a security section.
  • Community nodes as a searchable, filterable grid backed by one YAML file per pack; the Custom Node Manager page updated for the current UI.
• Weekly challenges: winners of the Discord art challenges are published as one folder per week (YAML + images, strict schema and folder checks).
  • The latest week is featured on /showcase/.
  • /showcase/challenges/ is the archive, and each week gets a shareable page.
  • A home page strip shows the latest winners.
  • docs/src/content/challenges/README.md is the step-by-step guide for adding a week; publishing is a manual pull request for now.
• Corrections along the way, among them:
  • the JWT key-rotation SQL now works on MySQL/MariaDB;
  • multi-GPU queueing and the max_cache_vram_gb budget are described correctly;
  • the model subfolder syntax is repo::v2;
  • the FLUX.1 Refine step count is right;
  • Re-identify clears a model's Source URL;
  • semantic search needs no restart.

Related Issues / Discussions

Supersedes #9368 (translations for the previous docs site).

QA Instructions

From docs/ with Node 22.23.4 or newer and pnpm 10:

• pnpm test: 299 passed, 0 failed (includes the translation and i18n-key checks).
• GITHUB_TOKEN=$(gh auth token) pnpm build: passes; "All internal links are valid." Without a token the changelog loader can hit GitHub's rate limit locally.
• pnpm run check-deploy-output, pnpm run check-redirects (88 targets) and pnpm run check-app-search-index: pass.
• In invokeai/frontend/webv2: docsSearchProvider.test.ts (8) and LaunchpadCommandPaletteDialog.browser.test.tsx (2): pass.
• Browser: each rewritten page checked at 1440px and 390px with Playwright; interactions exercised (pins, slider, picker, grid filters, copy buttons); no-JS fallbacks checked; no console errors from the production preview.

Not done: screenshots aren't attached yet. Forced-colors styles on the annotated pins were written but not rendered in a high-contrast mode.

The challenge pages include the last 10 Discord challenges; layouts were checked with that data and with edge-case fixtures (removed).

To try it: pnpm build && pnpm preview (search only works in a production build), then open /, /users-guide/image-generation/upscale/, /configuration/optimization/memory-options/ and /users-guide/workflows/community-nodes/.

Review

Each guide rewrite was reviewed against the code. Material findings were fixed and re-checked, including:

• the MySQL-incompatible key-rotation SQL;
• the FLUX.1 Refine step count;
• an over-broad Refine output-size claim;
• a promise that model-settings exports import across versions;
• an annotated-pin Escape bug and overlapping tap targets on phones;
• unstable callout ids;
• picker cards that didn't name their setups without JavaScript.

Remaining limits:

• The community nodes page links to its contributor README on main; that link 404s until this merges.
• The External Models introduction page is still outdated (missing Atlas Cloud, unrendered !!! admonitions).
• App behaviour found while checking facts, not changed here:
  • Re-identify drops source_url.
  • The Refine size preview overstates SD output with a 1× upscaler.
  • Node pack Reload re-runs every pack.

Compatibility / Rollout

• The app's command palette reads invokeai/frontend/webv2/src/workbench/palette/docsSearchIndex.json, generated from the docs build. Docs CI fails if it drifts; regenerate with pnpm run sync-app-search-index.
• Crowdin still needs project-side setup before the first sync: parser frontmatter exclusions, "Skip untranslated files" and the translator notes (see docs/README.md).

Checklist

• The PR has a short but descriptive title, suitable for a changelog
• Meaningful regression coverage added / updated where needed; obsolete tests/code removed
• Persisted-state and API changes include required migrations / compatibility validation
• Relevant performance/efficiency opportunities considered; material claims have evidence
• Material review findings resolved and relevant checks rerun
• Documentation added / updated (if applicable)
• Updated What's New copy (if doing a release after this PR)

---

^{Need help on this PR? Tag @codesmith-bot with what you need.}

[joshistoast]

Still working on how weekly challenge submissions should get handled, so don't merge or approve yet

[joshistoast]

Ok ready for review now I think