docs(website): add illustrated launcher guide under Get started #709

Open
bibiburl wants to merge 3 commits from bibiburl/Longshot:docs/launcher-guide into main
Member

Type: docs · Risk: low · Tested on: Linux, Chromium 153, website and game-free checks · Needs: review of this rebased head; inherited test/source-review failures resolved before deployment

Why

Players need an illustrated guide to choosing a player, finding their save and using the launcher, accessible from Getting started. Add a Launcher section that explains the player picker, the three home screens, updates, saves, privacy controls and the Steam Deck flow.

See LongshotLauncher issue #68. Its screenshots are HTML mockups, not a released launcher. The guide uses direct player instructions and explanatory picture captions, with one short opening preview notice and links to the current installation and save guides. Approved by Jordan at cb983fce; rebased without changing its own documentation diff onto 839a8cc4 for current validation; this PR is not a deployment request.

What changed

Added Get started → Launcher at /launcher/, plus a Launcher card at the end of Install. The guide has a three-step navigation strip, an explanation of Kid / Normal / Advanced homes, and eight inline pictures beside the controls they explain. Each picture has descriptive alt text, a caption explaining the controls and a full-size link.

  • docs/launcher.md: canonical source, including direct instructions for player selection, manual versus automatic updates, shared builds versus separate saves, privacy controls and useful help links.
  • docs/getting-started.md, website/src/content-pages.ts, website/astro.config.ts: entry point, source registration and sidebar placement.
  • website/src/styles/content.css: responsive flow cards, a grouped home-screen comparison and captioned figures, using existing theme tokens.
  • docs/images/launcher-preview/: eight unchanged issue #68 mockups (player picker, three homes, saves, storage, telemetry and splash), with original attachment URLs, dimensions and SHA-256 hashes. The existing asset integration serves them locally; generated copies are ignored by Git.
  • website/README.md: maintenance guidance and the requirement to verify a named launcher version before presenting this as a released-feature walkthrough.

No new JavaScript, dependencies or game-derived assets. Mockups load lazily with reserved dimensions and retain their source attribution/provenance; they are separate from the released-UI screenshot manifest. Existing UI screenshots retain their version captions and provenance. This branch starts from current main independently of the earlier website PRs.

Screenshots

Rebased guide @ 661277a4, local built site. These are design mockups of the upcoming launcher; the opening preview notice remains. All eight lazy-loaded images were decoded before capture.

Launcher full page — 1440 px, light

Launcher full page — 1440 px, dark

Launcher full page — 390 px, light

Launcher full page — 390 px, dark

Measurements

Verdict: the requested website changes pass their focused regressions, built-page checks and integration checks. Inherited failures are identified under Testing; this is not a gameplay measurement.

Hardware: Linux x86_64, Node/npm with the repository’s pinned dependencies, Chromium 153 for browser checks
Scene: local built website at desktop 1440 px and mobile 390 px
Method: functional checks against untouched main @ 839a8cc4 and this PR @ 661277a4; no performance comparison.
How to reproduce: from website/ with npm run build, npm run check, node --test tests/*.test.ts; from the repository root with python -I -B tests/run_all.py.

Check Before: main @ 839a8cc4 After: this PR @ 661277a4
Website tests 82 pass, 1 existing failure 82 pass, same 1 failure
Game-free suite 535 pass, 17 fail, 74 skip 535 pass, same 17 fail, 74 skip
Static build / generated-page check 17 pages, passes 18 pages, passes
Guide source review 15 changed Graphics inputs Same inherited 15 inputs

Flags and settings

None. No game, launcher or deployment setting changes.

Testing

Tested: current-head full website suite, static build/generated-page check, complete game-free suite, image integrity and git diff --check. Browser checks at 1440/390 px in light/dark show no horizontal overflow. All eight original mockups decode successfully at 960 px wide; fresh full-page screenshots are above. The rebased PR preserves the original documentation/assets diff. Earlier keyboard/search and axe results were recorded at cb983fce; they were not rerun as new accessibility audits here.

The same existing graphics-settings.test.ts failure, HDR Native condition accepts current prose but remains required (Missing expected exception), reproduces on untouched main @ 839a8cc4. The generated-page/source/link checks pass; npm run check still exits nonzero on that test. The earlier public-copy publication violations no longer reproduce on this baseline.

The complete game-free suite has the same 17 failing files and 74 skips as untouched main: tests/test_appimage_player_build.py, tests/test_bake_portability.py, tests/test_crash_dialog.py, tests/test_crt_options.py, tests/test_env_on.py, tests/test_forge_pr.py, tests/test_lift_cleanup_error.py, tests/test_linux_preflight.py, tests/test_linux_update.py, tests/test_make_game_cache.py, tests/test_missing_nup.py, tests/test_mods_size_table.py, tests/test_options_budget_once.py, tests/test_pipeline_tour.py, tests/test_readback_late.py, tests/test_vk_occlusion_queries.py, tests/test_vk_pgo.py. Skips are missing local tools/headers or platform-specific checks, not passes.

The guide-source CI failure also reproduces on untouched main: 15 recorded Graphics-menu inputs have drifted since the e9bed614 image review. Existing image integrity, screenshot-checker regressions and capture-isolation regressions pass. docs/images/guide/source-review-microphone-device-limit.md already records that the old Graphics illustration describes superseded VRAM-budget help. This update does not certify it as current, reset its fingerprints or build a game/menu capture. A source-and-image refresh remains separate work; the external Launcher source check is not performed here.

Combined integration: #611 + #638 + #709 merge cleanly on main @ 839a8cc4, build 19 pages, pass generated-page checks and run 139 website tests successfully with the same one inherited HDR assertion. Browser interaction confirms mouse/keyboard tab changes update #release-rc and #release-stable. #768’s alternative hero is not included in this combination; earlier screenshots of that four-PR combination remain historical evidence only.

Not tested: real Actions token execution, deployment/runner queues, notification delivery, Cloudflare production, game or Launcher runtime, Firefox/Safari, Windows/Steam Deck. No game was built or launched.

Must be tested:

  • Forgejo Actions and Cloudflare production, by hand after approved rollout: a maintainer checks production downloads and release refreshes, including one controlled refresh failure/recovery, expecting correct channel downloads and one Actions-owned incident that closes on success. Resolve the inherited website-test and Graphics-image/source-review failures before deployment. This update does not deploy the website.

  • Windows/Linux/Steam Deck, by hand before removing the preview notice in a future change: a maintainer checks the guide against a named launcher release, expecting controls and instructions to agree. Retain the notice until then; a runtime check is not required to merge this preview guide.

Risks

What could break: readers could mistake a proposal for a shipped feature. The opening preview notice identifies the upcoming launcher and its design mockups, and the Install entry also notes its preview status. Practical guidance about saves, shared-build updates and PC-wide privacy controls remains explicit. Local picture files, their source manifest and the guide must stay in sync and be checked against the eventual launcher release; captions explain the controls shown.

Turning it off: revert this documentation change.

Compatibility: nothing changes for saves, options, caches, renderer ABI, launcher behavior or builder tools. Existing guide links and source ownership are preserved.

Issues

See MagicBeanDev/LongshotLauncher#68

Related implementation: MagicBeanDev/LongshotLauncher#55 and MagicBeanDev/LongshotLauncher#59. This documentation does not close the redesign issue or claim those features have shipped.

Checklist

Everyone

  • One topic.
  • The title is a Conventional Commit (type(scope): description) of the status line's type.
  • Why gives the reason plainly and links the issues that fit (the tracker searched).
  • Measurements has a verdict, or one line saying why there is nothing to measure.
  • Testing names what was tested, what wasn't, and what must still be tested, where and how.
  • Rebased on current main (e090cc48, fetched again before committing).
  • python -I -B tests/run_all.py passes (any failure that also fails on main is named above).
  • No game files, dumps, build output or generated files.
  • third_party/ untouched (a new folder with a PROVENANCE.md instead).
  • The license is OK: GPL-3.0-or-later, nothing incompatible and nothing decompiled. Original guide prose/CSS and the project’s unchanged design mockups from issue #68, included at the user’s request with their source provenance retained; no game-derived content.

When it applies

  • AI assistance recorded with Assisted-by: / Co-Authored-By: trailers.
  • Screenshots of the same spot, captioned like the Measurements columns, for a change that shows on screen (Install before/after; the new Launcher page has no before version).
  • Docs updated.
**Type:** docs · **Risk:** low · **Tested on:** Linux, Chromium 153, website and game-free checks · **Needs:** review of this rebased head; inherited test/source-review failures resolved before deployment ## Why Players need an illustrated guide to choosing a player, finding their save and using the launcher, accessible from Getting started. Add a **Launcher** section that explains the player picker, the three home screens, updates, saves, privacy controls and the Steam Deck flow. See [LongshotLauncher issue #68](https://git.magicbean.dev/MagicBeanDev/LongshotLauncher/issues/68). Its screenshots are HTML mockups, not a released launcher. The guide uses direct player instructions and explanatory picture captions, with one short opening preview notice and links to the current installation and save guides. Approved by Jordan at `cb983fce`; rebased without changing its own documentation diff onto `839a8cc4` for current validation; this PR is not a deployment request. ## What changed Added **Get started → Launcher** at `/launcher/`, plus a Launcher card at the end of Install. The guide has a three-step navigation strip, an explanation of Kid / Normal / Advanced homes, and eight inline pictures beside the controls they explain. Each picture has descriptive alt text, a caption explaining the controls and a full-size link. - `docs/launcher.md`: canonical source, including direct instructions for player selection, manual versus automatic updates, shared builds versus separate saves, privacy controls and useful help links. - `docs/getting-started.md`, `website/src/content-pages.ts`, `website/astro.config.ts`: entry point, source registration and sidebar placement. - `website/src/styles/content.css`: responsive flow cards, a grouped home-screen comparison and captioned figures, using existing theme tokens. - `docs/images/launcher-preview/`: eight unchanged issue #68 mockups (player picker, three homes, saves, storage, telemetry and splash), with original attachment URLs, dimensions and SHA-256 hashes. The existing asset integration serves them locally; generated copies are ignored by Git. - `website/README.md`: maintenance guidance and the requirement to verify a named launcher version before presenting this as a released-feature walkthrough. No new JavaScript, dependencies or game-derived assets. Mockups load lazily with reserved dimensions and retain their source attribution/provenance; they are separate from the released-UI screenshot manifest. Existing UI screenshots retain their version captions and provenance. This branch starts from current main independently of the earlier website PRs. ## Screenshots Rebased guide @ `661277a4`, local built site. These are **design mockups of the upcoming launcher**; the opening preview notice remains. All eight lazy-loaded images were decoded before capture. ![Launcher full page — 1440 px, light](https://git.magicbean.dev/attachments/ac208be0-199b-46c9-9bd1-1e7b448b501e) ![Launcher full page — 1440 px, dark](https://git.magicbean.dev/attachments/0f2586f2-b569-42c5-be74-e62c6d25af97) ![Launcher full page — 390 px, light](https://git.magicbean.dev/attachments/eb15eced-6838-4724-85cb-71e1adf716bf) ![Launcher full page — 390 px, dark](https://git.magicbean.dev/attachments/2f3dc6a4-b6fa-42ca-bb74-8a46ac44efc3) ## Measurements **Verdict:** the requested website changes pass their focused regressions, built-page checks and integration checks. Inherited failures are identified under Testing; this is not a gameplay measurement. Hardware: Linux x86_64, Node/npm with the repository’s pinned dependencies, Chromium 153 for browser checks Scene: local built website at desktop 1440 px and mobile 390 px Method: functional checks against untouched main @ `839a8cc4` and this PR @ `661277a4`; no performance comparison. How to reproduce: from `website/` with `npm run build`, `npm run check`, `node --test tests/*.test.ts`; from the repository root with `python -I -B tests/run_all.py`. | Check | Before: main @ 839a8cc4 | After: this PR @ 661277a4 | |---|---|---| | Website tests | 82 pass, 1 existing failure | 82 pass, same 1 failure | | Game-free suite | 535 pass, 17 fail, 74 skip | 535 pass, same 17 fail, 74 skip | | Static build / generated-page check | 17 pages, passes | 18 pages, passes | | Guide source review | 15 changed Graphics inputs | Same inherited 15 inputs | ### Flags and settings None. No game, launcher or deployment setting changes. ## Testing **Tested:** current-head full website suite, static build/generated-page check, complete game-free suite, image integrity and `git diff --check`. Browser checks at 1440/390 px in light/dark show no horizontal overflow. All eight original mockups decode successfully at 960 px wide; fresh full-page screenshots are above. The rebased PR preserves the original documentation/assets diff. Earlier keyboard/search and axe results were recorded at `cb983fce`; they were not rerun as new accessibility audits here. The same existing `graphics-settings.test.ts` failure, **HDR Native condition accepts current prose but remains required** (`Missing expected exception`), reproduces on untouched main @ `839a8cc4`. The generated-page/source/link checks pass; `npm run check` still exits nonzero on that test. The earlier public-copy publication violations no longer reproduce on this baseline. The complete game-free suite has the same 17 failing files and 74 skips as untouched main: `tests/test_appimage_player_build.py`, `tests/test_bake_portability.py`, `tests/test_crash_dialog.py`, `tests/test_crt_options.py`, `tests/test_env_on.py`, `tests/test_forge_pr.py`, `tests/test_lift_cleanup_error.py`, `tests/test_linux_preflight.py`, `tests/test_linux_update.py`, `tests/test_make_game_cache.py`, `tests/test_missing_nup.py`, `tests/test_mods_size_table.py`, `tests/test_options_budget_once.py`, `tests/test_pipeline_tour.py`, `tests/test_readback_late.py`, `tests/test_vk_occlusion_queries.py`, `tests/test_vk_pgo.py`. Skips are missing local tools/headers or platform-specific checks, not passes. The guide-source CI failure also reproduces on untouched main: 15 recorded Graphics-menu inputs have drifted since the `e9bed614` image review. Existing image integrity, screenshot-checker regressions and capture-isolation regressions pass. `docs/images/guide/source-review-microphone-device-limit.md` already records that the old Graphics illustration describes superseded VRAM-budget help. This update does not certify it as current, reset its fingerprints or build a game/menu capture. A source-and-image refresh remains separate work; the external Launcher source check is not performed here. **Combined integration:** #611 + #638 + #709 merge cleanly on main @ `839a8cc4`, build 19 pages, pass generated-page checks and run 139 website tests successfully with the same one inherited HDR assertion. Browser interaction confirms mouse/keyboard tab changes update `#release-rc` and `#release-stable`. #768’s alternative hero is not included in this combination; earlier screenshots of that four-PR combination remain historical evidence only. **Not tested:** real Actions token execution, deployment/runner queues, notification delivery, Cloudflare production, game or Launcher runtime, Firefox/Safari, Windows/Steam Deck. No game was built or launched. **Must be tested:** - Forgejo Actions and Cloudflare production, by hand after approved rollout: a maintainer checks production downloads and release refreshes, including one controlled refresh failure/recovery, expecting correct channel downloads and one Actions-owned incident that closes on success. Resolve the inherited website-test and Graphics-image/source-review failures before deployment. This update does not deploy the website. - Windows/Linux/Steam Deck, by hand before removing the preview notice in a future change: a maintainer checks the guide against a named launcher release, expecting controls and instructions to agree. Retain the notice until then; a runtime check is not required to merge this preview guide. ## Risks **What could break:** readers could mistake a proposal for a shipped feature. The opening preview notice identifies the upcoming launcher and its design mockups, and the Install entry also notes its preview status. Practical guidance about saves, shared-build updates and PC-wide privacy controls remains explicit. Local picture files, their source manifest and the guide must stay in sync and be checked against the eventual launcher release; captions explain the controls shown. **Turning it off:** revert this documentation change. **Compatibility:** nothing changes for saves, options, caches, renderer ABI, launcher behavior or builder tools. Existing guide links and source ownership are preserved. ## Issues See https://git.magicbean.dev/MagicBeanDev/LongshotLauncher/issues/68 Related implementation: https://git.magicbean.dev/MagicBeanDev/LongshotLauncher/pulls/55 and https://git.magicbean.dev/MagicBeanDev/LongshotLauncher/pulls/59. This documentation does not close the redesign issue or claim those features have shipped. ## Checklist ### Everyone - [x] One topic. - [x] The title is a Conventional Commit (`type(scope): description`) of the status line's type. - [x] Why gives the reason plainly and links the issues that fit (the tracker searched). - [x] Measurements has a verdict, or one line saying why there is nothing to measure. - [x] Testing names what was tested, what wasn't, and what must still be tested, where and how. - [x] Rebased on current `main` (`e090cc48`, fetched again before committing). - [x] `python -I -B tests/run_all.py` passes (any failure that also fails on `main` is named above). - [x] No game files, dumps, build output or generated files. - [x] `third_party/` untouched (a new folder with a `PROVENANCE.md` instead). - [x] The license is OK: GPL-3.0-or-later, nothing incompatible and nothing decompiled. Original guide prose/CSS and the project’s unchanged design mockups from issue #68, included at the user’s request with their source provenance retained; no game-derived content. ### When it applies - [x] AI assistance recorded with `Assisted-by:` / `Co-Authored-By:` trailers. - [x] Screenshots of the same spot, captioned like the Measurements columns, for a change that shows on screen (Install before/after; the new Launcher page has no before version). - [x] Docs updated.
docs(website): add launcher UI preview under Get started
Some checks failed
CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped
CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped
Third-party parts / The same as upstream (pull_request) Has been skipped
Website / Website on Cloudflare (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 3s
PR description / Description follows the template (pull_request_target) Has been cancelled
CI / Workflow lint (actionlint) (pull_request) Has been cancelled
Guide screenshots / Guide images and local UI source review (pull_request) Has been cancelled
Third-party parts / As their notes say (pull_request) Has been cancelled
e230d57619
Explain the proposed player homes, updates, saves, privacy and Deck flow from Launcher issue 68, with clear preview status and links to existing installation instructions.

Assisted-by: Codex (OpenAI)
Author
Member

First website preview for this draft. These are screenshots of the documentation page, not a running redesigned launcher. The guide links to the design mockups in Launcher issue #68.

After: this PR @ e230d576, Launcher overview, 1440 × 1000, light.
Launcher overview

Full-page desktop light and dark (1440 px), and mobile light (390 px), at the same PR commit:
Launcher desktop light
Launcher desktop dark
Launcher mobile light

Install page, same 1440 px viewport and light theme. The existing launcher screenshots remain version-captioned examples.
Before: main @ e090cc48.
Install before
After: this PR @ e230d576, with the Launcher sidebar item and section.
Install after

First website preview for this draft. These are screenshots of the documentation page, not a running redesigned launcher. The guide links to the design mockups in Launcher issue #68. After: this PR @ e230d576, Launcher overview, 1440 × 1000, light. ![Launcher overview](https://git.magicbean.dev/attachments/1a554277-f62b-4bf4-aca0-2f03b6b222e2) Full-page desktop light and dark (1440 px), and mobile light (390 px), at the same PR commit: ![Launcher desktop light](https://git.magicbean.dev/attachments/3087bc00-b5c4-47a6-9ffa-5e6c04cc7186) ![Launcher desktop dark](https://git.magicbean.dev/attachments/0ec41c24-5231-4dbb-ae37-8d7c2f88b03b) ![Launcher mobile light](https://git.magicbean.dev/attachments/d1ac3078-192c-4096-aa5d-4ba1fc40bbf7) Install page, same 1440 px viewport and light theme. The existing launcher screenshots remain version-captioned examples. Before: main @ e090cc48. ![Install before](https://git.magicbean.dev/attachments/97f879bc-a2fa-4355-9df5-85a0590f12ba) After: this PR @ e230d576, with the Launcher sidebar item and section. ![Install after](https://git.magicbean.dev/attachments/a52fcbd8-0821-4de1-8131-4a70a684b191)
Author
Member

Added the first-attempt screenshots to the main description: desktop overview, full-page light/dark and mobile guide, plus the Install before/after comparison. Validation results and existing baseline failures are recorded there. Keeping this PR WIP as requested; the guide explicitly labels Launcher #68 as a proposed redesign.

Added the first-attempt screenshots to the main description: desktop overview, full-page light/dark and mobile guide, plus the Install before/after comparison. Validation results and existing baseline failures are recorded there. Keeping this PR WIP as requested; the guide explicitly labels Launcher #68 as a proposed redesign.
Author
Member

Updated the guide itself with eight inline design mockups from Launcher issue #68. Each has descriptive alt text, a design-preview caption and a full-size link; all images are served locally and preserved unchanged with source URLs and SHA-256 provenance.

After: this PR @ 40e5af86. These screenshots show the illustrated website guide, not a released launcher.

Illustrated guide overview — 1440 × 1100, light
Illustrated guide full page — desktop light
Illustrated guide full page — desktop dark
Illustrated guide full page — mobile light

Validation repeated: build passes; all eight images load from local assets and match their original hashes; no horizontal overflow at 1440/768/390/320 in either theme; four axe audits report zero violations. Keyboard full-size image navigation works. Existing baseline failures remain unchanged. Keeping this PR WIP.

Updated the guide itself with eight inline design mockups from Launcher issue #68. Each has descriptive alt text, a design-preview caption and a full-size link; all images are served locally and preserved unchanged with source URLs and SHA-256 provenance. After: this PR @ 40e5af86. These screenshots show the illustrated website guide, not a released launcher. ![Illustrated guide overview — 1440 × 1100, light](https://git.magicbean.dev/attachments/f1d5d514-6ab8-499c-919c-01b04b5251e5) ![Illustrated guide full page — desktop light](https://git.magicbean.dev/attachments/91e62524-6da5-4bcb-906a-1b88ca1aa218) ![Illustrated guide full page — desktop dark](https://git.magicbean.dev/attachments/163fee49-9e3f-48bb-9d54-2457f349ba57) ![Illustrated guide full page — mobile light](https://git.magicbean.dev/attachments/63651a36-2466-4015-acc7-0babeb9c52b3) Validation repeated: build passes; all eight images load from local assets and match their original hashes; no horizontal overflow at 1440/768/390/320 in either theme; four axe audits report zero violations. Keyboard full-size image navigation works. Existing baseline failures remain unchanged. Keeping this PR WIP.
docs(website): illustrate the launcher preview with design mockups
Some checks failed
CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped
CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped
Third-party parts / The same as upstream (pull_request) Has been skipped
Website / Website on Cloudflare (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 5s
CI / Workflow lint (actionlint) (pull_request) Successful in 7s
Guide screenshots / Guide images and local UI source review (pull_request) Failing after 8s
Third-party parts / As their notes say (pull_request) Successful in 11s
PR description / Description follows the template (pull_request_target) Successful in 14s
40e5af862d
Place eight original issue 68 mockups beside their explanations, with accessible captions and local full-size links. Record source URLs and hashes separately from released UI captures.

Assisted-by: Codex (OpenAI)
Author
Member

Updated the main post for 40e5af86: the guide now contains eight captioned mockups with local full-size links, and the main-post screenshots show the illustrated version. Recorded repeated validation and retained the WIP status.

Updated the main post for 40e5af86: the guide now contains eight captioned mockups with local full-size links, and the main-post screenshots show the illustrated version. Recorded repeated validation and retained the WIP status.
docs(website): make the launcher guide player facing
Some checks failed
CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped
CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped
Third-party parts / The same as upstream (pull_request) Has been skipped
Website / Website on Cloudflare (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 14s
CI / Workflow lint (actionlint) (pull_request) Successful in 21s
Guide screenshots / Guide images and local UI source review (pull_request) Failing after 20s
Third-party parts / As their notes say (pull_request) Successful in 31s
Website / Website on Cloudflare (pull_request_target) Has been skipped
PR description / Description follows the template (pull_request_target) Successful in 5s
cb983fce43
Use direct instructions and explanatory picture captions, replace development-status notes with help links, and keep one opening preview notice for the upcoming launcher.

Assisted-by: Codex (OpenAI)
Author
Member

Updated the guide with direct player instructions and captions that explain each screen. One opening preview notice identifies the upcoming launcher; save, update and privacy guidance remains explicit. The development-status section is now useful help links.

Current screenshots at cb983fce (the launcher pictures are design mockups). These replace the earlier guide screenshots in the main post.

Guide overview

Full-page exports and updated Install entry

Guide desktop light

Guide desktop dark

Guide mobile light

Install after

Website build passes. Layout and accessibility checks pass; existing website and game-free test failures are unchanged from the base. This remains WIP.

Updated the guide with direct player instructions and captions that explain each screen. One opening preview notice identifies the upcoming launcher; save, update and privacy guidance remains explicit. The development-status section is now useful help links. Current screenshots at `cb983fce` (the launcher pictures are design mockups). These replace the earlier guide screenshots in the main post. ![Guide overview](https://git.magicbean.dev/attachments/155613c2-c6bf-45c1-a529-9793cb3deef2) <details> <summary>Full-page exports and updated Install entry</summary> ![Guide desktop light](https://git.magicbean.dev/attachments/8d72cfe8-50d3-4f2f-9b22-227bcd2e5033) ![Guide desktop dark](https://git.magicbean.dev/attachments/89bdcf31-71ef-4077-8946-230874e41c72) ![Guide mobile light](https://git.magicbean.dev/attachments/52461b5f-530d-45a0-b1f8-9a917bbf6d13) ![Install after](https://git.magicbean.dev/attachments/5adb0a6a-997e-4b0c-b6fd-b1cc1ae33366) </details> Website build passes. Layout and accessibility checks pass; existing website and game-free test failures are unchanged from the base. This remains WIP.
bibiburl changed title from WIP: docs(website): add launcher UI preview under Get started to WIP: docs(website): add illustrated launcher guide under Get started 2026-11-15 05:49:27 +00:00
madebyjordan left a comment

Reviewed at cb983fce: good to go in from my side. It merges cleanly with main and with #768, it's self-contained, and the opening notice says the pictures are mockups of the upcoming launcher. I'll approve once it's out of WIP.

Review drafted with Claude Code and checked by Jordan.

Reviewed at cb983fce: good to go in from my side. It merges cleanly with main and with #768, it's self-contained, and the opening notice says the pictures are mockups of the upcoming launcher. I'll approve once it's out of WIP. *Review drafted with Claude Code and checked by Jordan.*
Author
Member

Preparing this for final review following Jordan’s feedback. Normalised the description checker’s Measurements and Must be tested sections; the guide, screenshots and recorded validation are unchanged at cb983fce. This does not request deployment.

Preparing this for final review following Jordan’s feedback. Normalised the description checker’s Measurements and Must be tested sections; the guide, screenshots and recorded validation are unchanged at cb983fce. This does not request deployment.
bibiburl changed title from WIP: docs(website): add illustrated launcher guide under Get started to docs(website): add illustrated launcher guide under Get started 2026-11-15 12:09:41 +00:00
madebyjordan approved these changes 2026-11-15 12:38:28 +00:00
Dismissed
madebyjordan left a comment

Reviewed at cb983fce and still the same head: approved. Drafted with Claude Code and checked by Jordan.

Reviewed at cb983fce and still the same head: approved. *Drafted with Claude Code and checked by Jordan.*
bibiburl force-pushed docs/launcher-guide from cb983fce43
Some checks failed
Website / Website on Cloudflare (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped
CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped
Third-party parts / The same as upstream (pull_request) Has been skipped
Third-party parts / As their notes say (pull_request) Successful in 31s
CI / Conventional Commit title (pull_request) Successful in 14s
CI / Workflow lint (actionlint) (pull_request) Successful in 21s
Guide screenshots / Guide images and local UI source review (pull_request) Failing after 20s
PR description / Description follows the template (pull_request_target) Successful in 5s
Website / Website on Cloudflare (pull_request_target) Has been skipped
to 661277a4a2
Some checks failed
CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped
CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped
Third-party parts / The same as upstream (pull_request) Has been skipped
Website / Website on Cloudflare (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 4s
CI / Workflow lint (actionlint) (pull_request) Successful in 6s
Guide screenshots / Guide images and local UI source review (pull_request) Failing after 6s
Third-party parts / As their notes say (pull_request) Successful in 10s
PR description / Description follows the template (pull_request_target) Successful in 4s
2026-11-15 20:33:13 +00:00
Compare
bibiburl dismissed madebyjordan's review 2026-11-15 20:33:14 +00:00
Reason:

New commits pushed, approval review dismissed automatically according to repository settings

Author
Member

Rebased the approved guide onto main @ 839a8cc4; new head 661277a4 preserves the PR’s documentation/assets diff. Refreshed the main post with full-page light/dark screenshots at 1440 and 390 px. All eight original mockups decode correctly; no horizontal overflow.

Build and generated-page checks pass (18 pages). Website tests: 82 pass, the same one HDR-condition assertion as main. Game-free: 535 pass, 17 fail, 74 skip, with identical failing files to main. The guide-source CI failure is inherited Graphics screenshot drift (15 inputs), not changed Launcher mockups; the source/image review notes and limits are explicit in the main post. No capture fingerprints were reset, no game was built/launched, and no website deployment occurred.

Rebased the approved guide onto main @ 839a8cc4; new head 661277a4 preserves the PR’s documentation/assets diff. Refreshed the main post with full-page light/dark screenshots at 1440 and 390 px. All eight original mockups decode correctly; no horizontal overflow. Build and generated-page checks pass (18 pages). Website tests: 82 pass, the same one HDR-condition assertion as main. Game-free: 535 pass, 17 fail, 74 skip, with identical failing files to main. The guide-source CI failure is inherited Graphics screenshot drift (15 inputs), not changed Launcher mockups; the source/image review notes and limits are explicit in the main post. No capture fingerprints were reset, no game was built/launched, and no website deployment occurred.
madebyjordan approved these changes 2026-11-15 20:38:22 +00:00
Dismissed
madebyjordan left a comment

Re-approving after the rebase onto main @ 839a8cc4 (my approval of cb983fce was dismissed by the force-push). git range-diff shows all three commits' patches unchanged (=), and the PR's whole diff matches cb983fce's except the index lines of the three website files main changed underneath. It still merges cleanly with #768. The red Guide screenshots check is main's: check_guide_screenshots.py --review-sources gives the same 16 settings-graphics.png review issues on main @ 839a8cc4 and on this head.

Drafted with Claude Code at Jordan's request.

Re-approving after the rebase onto main @ 839a8cc4 (my approval of cb983fce was dismissed by the force-push). `git range-diff` shows all three commits' patches unchanged (=), and the PR's whole diff matches cb983fce's except the index lines of the three website files main changed underneath. It still merges cleanly with #768. The red Guide screenshots check is main's: `check_guide_screenshots.py --review-sources` gives the same 16 settings-graphics.png review issues on main @ 839a8cc4 and on this head. *Drafted with Claude Code at Jordan's request.*
Some checks failed
CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped
CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped
CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped
Third-party parts / The same as upstream (pull_request) Has been skipped
Website / Website on Cloudflare (pull_request) Has been skipped
CI / Conventional Commit title (pull_request) Successful in 4s
CI / Workflow lint (actionlint) (pull_request) Successful in 6s
Guide screenshots / Guide images and local UI source review (pull_request) Failing after 6s
Third-party parts / As their notes say (pull_request) Successful in 10s
PR description / Description follows the template (pull_request_target) Successful in 4s
This pull request has changes conflicting with the target branch.
  • website/astro.config.ts
  • website/src/content-pages.ts
View command line instructions

Manual merge helper

Use this merge commit message when completing the merge manually.

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u 'docs/launcher-guide:bibiburl-docs/launcher-guide'
git switch 'bibiburl-docs/launcher-guide'
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
MagicBeanDev/Longshot!709
No description provided.