feat(website): add Longshot player site and team pages

bibiburl commented

2026-11-13 03:03:33 +00:00

Member

Why

Players need a clear front door to Longshot: installation help, release information, troubleshooting and the people behind the project. This adds the team magicbean website and documentation experience at /Longshot/ while retaining the maintained project documentation as its source.

What changed

Meet the Beans now lists 12 profiles, adding simonwjackson, snaildev99 and futondestroyer from current PR authors with verified Git profile/avatar URLs. Existing order is preserved; new profiles follow the existing group and bibiburl stays last. No roles or bios are inferred.
A compact red notice directly below the releases card states: no game files, game assets or keys are hosted or distributed; players must provide their own supported copy.
Performance pass: serve full-glyph Libertinus WOFF2 fonts, preserving original TTFs and licensing with conversion provenance. Heading font is 456,324 → 177,668 bytes (61.1% smaller); three emitted Libertinus fonts total 1,334,388 → 505,928 bytes (828,460 bytes saved). These compare the earlier website commit 838c977 with this head and measure raw asset bytes, not browser load time; fallback Sans fonts may not download when Atkinson is used.
Hero bean gently bobs on a six-second cycle matching the MagicBean homepage (8px lift, 1.5° tilt). Hover/focus pauses it, reduced-motion preferences disable it, and the button/focus outline remain stationary. Triple-click fairy behavior is preserved.
Common issues now presents seven expandable symptom cards with three short checks each, related guides and nested “Still stuck?” help for logs, prefilled report searches and Discord. Cards retain their original grid column when expanded; header layouts and inset focus outlines prevent jumping and highlight spill. Canonical steps stay in docs/common-issues.md, existing topic anchors are preserved, and native disclosures support keyboard/no-JavaScript use and the shared print expansion.
The homepage chooses from ten short bean punchlines once per load. Optional session storage avoids immediate repeats across reloads; blocked storage is handled, and the original static line remains without JavaScript. The triple-click fairy Easter egg remains separate.
Front-page issue search now places the complete search panel and results before development summaries on arrival, focuses the query and positions it below the navigation after layout. Asynchronous overview updates stay below search instead of pushing it down the page. Normal Progress visits retain the overview-first order. Front-page search caption: “Searches reported issues”. Removed the technical coverage paragraph from the progress page.
Graphics guide: 26 searchable setting cards in seven sections, generated at build time from the maintained README choices/defaults and menu-source headings. Includes section filters, restart badges, permalinks, no-JavaScript disclosures and full-catalogue printing; source drift stops the build. Corrects the README frame-cap restart note to match the existing live-update path in gpu/vk/vk_menu.cpp and host/nn_vi.c; no runtime code changed.
UI review follow-up: compact native mobile navigation, explicit shared-memory compatibility guidance with automatic GPU-type updates and manual overrides, a plain-language hero introduction, troubleshooting-first support with accurately labelled report search, and a specs scrolling cue. Removed the LOCAL PREVIEW hero badge.
Saves and updates: Easy beans cards explain verified launcher import/export, backup, recovery and Windows build-copy steps. Advanced beans disclosures retain canonical commands, paths, troubleshooting and test limitations; existing anchors still work.
System requirements: a shared minimum/required and recommended table in the manual and compatibility page, sourced from README.md. Game identity, driver notes and AVX2 exceptions remain explicit; no minimum VRAM or higher CPU/GPU tier is invented.
website/: Astro/Starlight site with Longshot branding, locally bundled fonts, release and development panels, player support, Discord links, a team roster with Git avatars, and an About page that credits the original Hookshot project.
website/scripts/prepare-content.mjs and format-manual.mjs: import the canonical README, contributor guide and selected docs. Installation comes first, platform steps become cards, and advanced reference sections can be expanded. Existing commands, links and headings are preserved; linked disclosures open automatically.
docs/: concise player guides and support routes. The README's two current reporting links point to Longshot; historical credits remain intact.
Compatibility checks have source-review guards. The progress board uses a dated public repository snapshot. Team profiles are individual JSON files, with avatar fallbacks and a contribution guide.
Rebased onto 5eaaf7f, preserving upstream's new Longshot Launcher instructions. The requirement review records the download-description change; hardware and game requirements are unchanged.

Flags and settings

No game settings or runtime flags change. Website build settings are documented in website/README.md: DOCS_SITE_URL controls canonical metadata, and DOCS_SOURCE_REPOSITORY / DOCS_SOURCE_BRANCH control edit links. Preview builds deliberately target this fork branch. Before production, build with the intended source repository and branch.

Measurements

Baseline: main @ 5eaaf7f. This PR @ 57f6577. Website-only validation on Linux using Node 22.23.4 and the pinned dependencies; no gameplay measurements are claimed.

Check	main @ `5eaaf7f`	this PR @ 57f6577
Astro website	No `website/` directory	15 pages generated
Local links/assets and anchors	Not applicable	918 checked, passing
Website test files	Not applicable	9 passing, 0 failing

Reproduce from website/ with Node 22.23.4 or newer:

npm ci
npm run build:preview
npm run preview -- --host 127.0.0.1 --port 4321

Open /Longshot/, /Longshot/guides/graphics-and-controls/, /Longshot/reference/manual/, /Longshot/team/ and /Longshot/about/. Generated pages are not committed.

Testing

Tested: website build, route/anchor/asset checks, search-index generation, source-review guards and all nine website test files. The manual transform tests preserve source content and fenced code. Independent UI source review found no actionable issue in the manual and About changes.

Graphics validation also includes five passing README/menu coverage tests (python -I -B tests/test_readme_menu_rows.py), source-drift and generation tests, and DOM-fixture sequences for combined filtering, reset, deep links (including repeated permalinks) and print-state restoration. Generated HTML has 26 complete cards, seven groups and unique anchors. Independent UI source review found one repeated-permalink issue; it is fixed and covered by a regression test. These fixture/source checks are not rendered-browser verification.

Issue-search regression checks cover panel ordering before delayed overview updates, focus/scroll after layout, repeated navigation, disconnected-page focus, and keeping results, pagination and feedback together. Generated HTML confirms the complete movable panel.

Symptom-card validation preserves all canonical checklist/help text and seven legacy anchors; generated HTML contains seven native cards, 21 numbered checks and seven help disclosures. Bean-line tests cover all ten choices, immediate-repeat avoidance across reloads and blocked storage. Independent UI source/metric review identified one long mobile phrase; it was shortened before the final build.

Font conversion was checked by decompression and comparison of character maps, all 7,441 glyph outlines/advances and layout/shaping tables. The combined preview build passes all nine website test files and 918 link/asset checks. Compiled CSS resolves to all three emitted WOFF2 files, with no emitted Libertinus TTFs; animation and reduced-motion rules are present. Rendered animation smoothness and browser timing remain unmeasured.

Not tested: rendered desktop/mobile appearance, keyboard and screen-reader behavior, light/dark themes, live search interaction and printed output. Browser automation was unavailable. No Cloudflare deployment, game launch/build or runtime test suite was run; this change does not modify runtime code. Full tests/run_all.py is not claimed.

Needs other testers:

Browser review: desktop and phone layouts, keyboard navigation, search, both themes, manual deep links, disclosures and print layout; expect readable content and no inaccessible controls (pending reviewer validation).
Maintainer/user review: appearance and wording, including the companion MagicBean homepage's Longshot button.

Screenshots

Pending browser/user visual review. No screenshots are claimed. The author's local preview is not a hosted review URL; other contributors must run the commands above.

Risk and rollback

Main risks are responsive layout, imported Markdown presentation, dated progress data and production source-link configuration. Revert the website/docs changes to roll back. There is no automatic site deployment in this PR. The companion Site PR packages the generated website; it must use a reviewed Longshot build before deployment.

Reviewer notes

Ready for review at the author's request. The validation limitations and unchecked items below remain outstanding; this status change does not certify merge or deployment readiness. Companion change: MagicBeanDev/Site PR #1. Documentation stays in Longshot; Site copies only built output. No pushes target Hookshot.

Issues

No issue closure requested.

Checklist

For everyone

One topic.
The title is a Conventional Commit (type(scope): description).
Rebased on current main. (Based on 5eaaf7f; the last fetched upstream is 6c90418. A further rebase remains before merge.)
python -I -B tests/run_all.py run and passing (any failure that also fails on main is named above).
Tested in the game, or what wasn't is named under Testing.
Testing filled in: what was tested, what wasn't, and what needs other testers (with test requests).
Measured: main and this PR at named commits, on the same PC, scene and settings, at least 2 interleaved runs each, the median reported.
No game files, dumps, build output or generated files. (No game data or compiled site output; the dated public progress snapshot is intentionally checked in.)
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.

If applicable

AI assistance recorded with Assisted-by: / Co-Authored-By: trailers.
Flags noted, and the switch reference updated (docs/development.md, the README).
Screenshots for a change that shows on screen.
Docs updated.

## Why Players need a clear front door to Longshot: installation help, release information, troubleshooting and the people behind the project. This adds the team magicbean website and documentation experience at `/Longshot/` while retaining the maintained project documentation as its source. ## What changed - Meet the Beans now lists 12 profiles, adding simonwjackson, snaildev99 and futondestroyer from current PR authors with verified Git profile/avatar URLs. Existing order is preserved; new profiles follow the existing group and bibiburl stays last. No roles or bios are inferred. - A compact red notice directly below the releases card states: no game files, game assets or keys are hosted or distributed; players must provide their own supported copy. - Performance pass: serve full-glyph Libertinus WOFF2 fonts, preserving original TTFs and licensing with conversion provenance. Heading font is 456,324 → 177,668 bytes (61.1% smaller); three emitted Libertinus fonts total 1,334,388 → 505,928 bytes (828,460 bytes saved). These compare the earlier website commit `838c977` with this head and measure raw asset bytes, not browser load time; fallback Sans fonts may not download when Atkinson is used. - Hero bean gently bobs on a six-second cycle matching the MagicBean homepage (8px lift, 1.5° tilt). Hover/focus pauses it, reduced-motion preferences disable it, and the button/focus outline remain stationary. Triple-click fairy behavior is preserved. - Common issues now presents seven expandable symptom cards with three short checks each, related guides and nested “Still stuck?” help for logs, prefilled report searches and Discord. Cards retain their original grid column when expanded; header layouts and inset focus outlines prevent jumping and highlight spill. Canonical steps stay in `docs/common-issues.md`, existing topic anchors are preserved, and native disclosures support keyboard/no-JavaScript use and the shared print expansion. - The homepage chooses from ten short bean punchlines once per load. Optional session storage avoids immediate repeats across reloads; blocked storage is handled, and the original static line remains without JavaScript. The triple-click fairy Easter egg remains separate. - Front-page issue search now places the complete search panel and results before development summaries on arrival, focuses the query and positions it below the navigation after layout. Asynchronous overview updates stay below search instead of pushing it down the page. Normal Progress visits retain the overview-first order. Front-page search caption: “Searches reported issues”. Removed the technical coverage paragraph from the progress page. - Graphics guide: 26 searchable setting cards in seven sections, generated at build time from the maintained README choices/defaults and menu-source headings. Includes section filters, restart badges, permalinks, no-JavaScript disclosures and full-catalogue printing; source drift stops the build. Corrects the README frame-cap restart note to match the existing live-update path in `gpu/vk/vk_menu.cpp` and `host/nn_vi.c`; no runtime code changed. - UI review follow-up: compact native mobile navigation, explicit shared-memory compatibility guidance with automatic GPU-type updates and manual overrides, a plain-language hero introduction, troubleshooting-first support with accurately labelled report search, and a specs scrolling cue. Removed the LOCAL PREVIEW hero badge. - Saves and updates: Easy beans cards explain verified launcher import/export, backup, recovery and Windows build-copy steps. Advanced beans disclosures retain canonical commands, paths, troubleshooting and test limitations; existing anchors still work. - System requirements: a shared minimum/required and recommended table in the manual and compatibility page, sourced from README.md. Game identity, driver notes and AVX2 exceptions remain explicit; no minimum VRAM or higher CPU/GPU tier is invented. - `website/`: Astro/Starlight site with Longshot branding, locally bundled fonts, release and development panels, player support, Discord links, a team roster with Git avatars, and an About page that credits the original Hookshot project. - `website/scripts/prepare-content.mjs` and `format-manual.mjs`: import the canonical README, contributor guide and selected docs. Installation comes first, platform steps become cards, and advanced reference sections can be expanded. Existing commands, links and headings are preserved; linked disclosures open automatically. - `docs/`: concise player guides and support routes. The README's two current reporting links point to Longshot; historical credits remain intact. - Compatibility checks have source-review guards. The progress board uses a dated public repository snapshot. Team profiles are individual JSON files, with avatar fallbacks and a contribution guide. - Rebased onto `5eaaf7f`, preserving upstream's new Longshot Launcher instructions. The requirement review records the download-description change; hardware and game requirements are unchanged. ## Flags and settings No game settings or runtime flags change. Website build settings are documented in `website/README.md`: `DOCS_SITE_URL` controls canonical metadata, and `DOCS_SOURCE_REPOSITORY` / `DOCS_SOURCE_BRANCH` control edit links. Preview builds deliberately target this fork branch. Before production, build with the intended source repository and branch. ## Measurements Baseline: main @ 5eaaf7f. This PR @ 57f6577. Website-only validation on Linux using Node 22.23.4 and the pinned dependencies; no gameplay measurements are claimed. | Check | main @ 5eaaf7f | this PR @ 57f6577 | |---|---|---| | Astro website | No `website/` directory | 15 pages generated | | Local links/assets and anchors | Not applicable | 918 checked, passing | | Website test files | Not applicable | 9 passing, 0 failing | Reproduce from `website/` with Node 22.23.4 or newer: ```sh npm ci npm run build:preview npm run preview -- --host 127.0.0.1 --port 4321 ``` Open `/Longshot/`, `/Longshot/guides/graphics-and-controls/`, `/Longshot/reference/manual/`, `/Longshot/team/` and `/Longshot/about/`. Generated pages are not committed. ## Testing **Tested:** website build, route/anchor/asset checks, search-index generation, source-review guards and all nine website test files. The manual transform tests preserve source content and fenced code. Independent UI source review found no actionable issue in the manual and About changes. Graphics validation also includes five passing README/menu coverage tests (`python -I -B tests/test_readme_menu_rows.py`), source-drift and generation tests, and DOM-fixture sequences for combined filtering, reset, deep links (including repeated permalinks) and print-state restoration. Generated HTML has 26 complete cards, seven groups and unique anchors. Independent UI source review found one repeated-permalink issue; it is fixed and covered by a regression test. These fixture/source checks are not rendered-browser verification. Issue-search regression checks cover panel ordering before delayed overview updates, focus/scroll after layout, repeated navigation, disconnected-page focus, and keeping results, pagination and feedback together. Generated HTML confirms the complete movable panel. Symptom-card validation preserves all canonical checklist/help text and seven legacy anchors; generated HTML contains seven native cards, 21 numbered checks and seven help disclosures. Bean-line tests cover all ten choices, immediate-repeat avoidance across reloads and blocked storage. Independent UI source/metric review identified one long mobile phrase; it was shortened before the final build. Font conversion was checked by decompression and comparison of character maps, all 7,441 glyph outlines/advances and layout/shaping tables. The combined preview build passes all nine website test files and 918 link/asset checks. Compiled CSS resolves to all three emitted WOFF2 files, with no emitted Libertinus TTFs; animation and reduced-motion rules are present. Rendered animation smoothness and browser timing remain unmeasured. **Not tested:** rendered desktop/mobile appearance, keyboard and screen-reader behavior, light/dark themes, live search interaction and printed output. Browser automation was unavailable. No Cloudflare deployment, game launch/build or runtime test suite was run; this change does not modify runtime code. Full `tests/run_all.py` is not claimed. **Needs other testers:** - Browser review: desktop and phone layouts, keyboard navigation, search, both themes, manual deep links, disclosures and print layout; expect readable content and no inaccessible controls (pending reviewer validation). - Maintainer/user review: appearance and wording, including the companion MagicBean homepage's Longshot button. ## Screenshots Pending browser/user visual review. No screenshots are claimed. The author's local preview is not a hosted review URL; other contributors must run the commands above. ## Risk and rollback Main risks are responsive layout, imported Markdown presentation, dated progress data and production source-link configuration. Revert the website/docs changes to roll back. There is no automatic site deployment in this PR. The companion Site PR packages the generated website; it must use a reviewed Longshot build before deployment. ## Reviewer notes Ready for review at the author's request. The validation limitations and unchecked items below remain outstanding; this status change does not certify merge or deployment readiness. Companion change: [MagicBeanDev/Site PR #1](https://git.magicbean.dev/MagicBeanDev/Site/pulls/1). Documentation stays in Longshot; Site copies only built output. No pushes target Hookshot. ## Issues No issue closure requested. ## Checklist ### For everyone - [x] One topic. - [x] The title is a Conventional Commit (`type(scope): description`). - [ ] Rebased on current `main`. (Based on `5eaaf7f`; the last fetched upstream is `6c90418`. A further rebase remains before merge.) - [ ] `python -I -B tests/run_all.py` run and passing (any failure that also fails on `main` is named above). - [x] Tested in the game, or what wasn't is named under Testing. - [x] Testing filled in: what was tested, what wasn't, and what needs other testers (with test requests). - [ ] Measured: main and this PR at named commits, on the same PC, scene and settings, at least 2 interleaved runs each, the median reported. - [ ] No game files, dumps, build output or generated files. (No game data or compiled site output; the dated public progress snapshot is intentionally checked in.) - [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. ### If applicable - [x] AI assistance recorded with `Assisted-by:` / `Co-Authored-By:` trailers. - [x] Flags noted, and the switch reference updated (docs/development.md, the README). - [ ] Screenshots for a change that shows on screen. - [x] Docs updated.

bibiburl commented

2026-11-13 03:33:47 +00:00

Author

Member

Pushed 8fcee1d: minimum/required and recommended system specs now share one README source across the manual and compatibility page. Existing thresholds and caveats remain unchanged. Validation: 15 pages, 808 local links/assets and anchors, all seven website test files passing; generated tables match on both pages. UI source review complete; rendered desktop/mobile and print checks remain pending.

bibiburl commented

2026-11-13 03:45:30 +00:00

Author

Member

Pushed 2626467: save-transfer and update guides now have Easy beans launcher steps and Advanced beans reference sections. Verified launcher control names against its maintained save guide. Backup/replacement guidance stays visible. Validation: 15 pages, 814 local links/assets and anchors, all seven website test files passing; all original save commands/reference tables/links and all 12 prior section anchors retained. Local preview refreshed. Rendered browser checks remain pending; no save files were accessed or transferred.

bibiburl commented

2026-11-13 04:11:27 +00:00

Author

Member

Pushed 901fac2: applied the five UI review recommendations and removed the LOCAL PREVIEW badge. Shared-memory users no longer receive a contradictory VRAM-entry request; warnings remain. Automatic memory selection updates when GPU changes, while explicit overrides persist. Added mobile navigation, clearer hero/support wording and an adaptive specs scroll cue. Validation: 15 pages, 889 local links/assets and anchors, all seven website test files passing, including the shared-memory regression; generated navigation parity and support ordering checked. Independent source review resolved its finding. Local preview refreshed; rendered browser/keyboard/mobile checks remain pending.

bibiburl commented

2026-11-13 04:46:57 +00:00

Author

Member

Pushed f10594c: graphics guide now builds 26 searchable setting cards across seven source-defined sections, with choices/defaults from the maintained README. Added section filters, restart badges, permalinks and print/reset handling. Corrected the stale README frame-cap restart note after checking vk_menu.cpp and host/nn_vi.c; runtime code unchanged. Validation: 15 pages, 922 local links/assets plus anchors, 8 website test files and 5 README/menu tests pass. UI source-review permalink finding fixed and regression-tested. Browser access remains unavailable, so rendered desktop/mobile, keyboard, themes and print review remain pending; PR stays WIP. Local preview refreshed.

bibiburl commented

2026-11-13 05:02:15 +00:00

Author

Member

Pushed 470114d to fix the reported front-page search landing problem. Issue-search links now move the whole search panel (input, filters, results and feedback) before the development overview, then focus/position the input after layout. Delayed feed rendering cannot insert overview content above it. Local preview refreshed. Validation: 15-page build, 922 local links/assets and anchors, all 8 website test files pass, including navigation regression fixtures. Generated HTML structure checked; rendered browser scrolling remains unverified because browser access is unavailable.

bibiburl commented

2026-11-13 05:08:39 +00:00

Author

Member

Pushed c200a2f: shortened the front-page search caption to “Searches reported issues”, as requested. Local preview refreshed; website build, 922 local links/assets plus anchors and all 8 website test files pass.

bibiburl commented

2026-11-13 05:14:44 +00:00

Author

Member

Pushed e292024: removed the progress coverage paragraph and its script update, as requested. Local preview refreshed. Build, 922 local links/assets and anchors, and all 8 website test files pass. Confirmed the paragraph is absent from generated HTML and compiled JavaScript. Common-issues redesign is advisory only at this point; no changes to that guide.

bibiburl commented

2026-11-13 05:25:18 +00:00

Author

Member

Pushed 40d0546: replaced the common-issues wall of reporting advice with seven symptom cards, each offering three short checks, related guides and optional Still stuck help with search/Discord links. Existing anchors retained; maintained content remains in docs/common-issues.md. Added ten homepage bean punchlines that change once per load and avoid immediate repeats with session storage. Validation: 15 pages, 918 local links/assets plus anchors and all 9 website test files pass. Independent UI source review completed; one long phrase shortened for mobile. Generated HTML checked. Local preview refreshed; rendered browser verification remains unavailable, so PR stays WIP.

bibiburl commented

2026-11-13 05:29:14 +00:00

Author

Member

Pushed 838c977 for the reported card layout issues: removed the full-row expansion that moved right-hand cards down, gave headers a marker/text grid with reset margins, and inset keyboard focus outlines within padded headers. Local preview refreshed. Build, 918 local links/assets and anchors, all 9 website test files pass; compiled CSS confirms no expanded column span. Browser visual verification remains unavailable.

bibiburl changed title from ~~WIP: feat(website): add Longshot player site and team pages~~ to feat(website): add Longshot player site and team pages

2026-11-13 05:43:42 +00:00

bibiburl commented

2026-11-13 05:59:04 +00:00

Author

Member

Pushed d5a225d: full-glyph WOFF2 fonts save 828,460 emitted asset bytes; the heading font is 61.1% smaller. Added the main homepage’s gentle hero bean bob, paused on hover/focus and disabled for reduced motion. Build, 918 link/asset checks and all 9 website test files pass. Font glyphs/metrics verified; browser appearance and timing remain unverified. Local preview refreshed; PR remains ready for review.

bibiburl commented

2026-11-13 06:09:11 +00:00

Author

Member

Once we have a build available, I’d like to add screenshots of the launcher and the in-game settings menu to the relevant how-to guides. Showing the actual controls beside each step should make installation, setup and settings easier to understand.

These should show our UI only: no game assets or gameplay imagery, and no personal paths, account details or save information. For the in-game menu, we should first establish a capture method that excludes the game scene behind it; cropping alone may not be enough if the menu is translucent.

To keep maintenance efficient, I suggest:

Keep one shared set of screenshots in Longshot and reuse them across guides; the Site repository should continue consuming the built documentation rather than maintaining another copy.
Start with a small set of useful views, captured at a consistent window size, UI scale and theme. Keep explanations and numbered steps in page text, with useful alt text, so wording changes do not require editing images.
Track each image in a small manifest: source UI/view, capture steps, build or commit, platform, relevant UI source files, and last-reviewed version. Mark platform-specific views explicitly.
Have changes to those UI source files flag the affected screenshots for review. Reviewers can confirm an image is still accurate or replace only that image; a new release should not force recapturing everything.
Investigate a repeatable capture script or UI-only fixture once the launcher/menu supports it. Fixtures would need to render the actual maintained UI and be checked against the real build. Until then, a short manual capture checklist is enough; documentation builds should not require private game data.

This is a follow-up proposal once a build is available. No screenshots or capture automation are included yet. Feedback on the simplest reliable capture and review workflow would be welcome.

Once we have a build available, I’d like to add screenshots of the launcher and the in-game settings menu to the relevant how-to guides. Showing the actual controls beside each step should make installation, setup and settings easier to understand. These should show our UI only: no game assets or gameplay imagery, and no personal paths, account details or save information. For the in-game menu, we should first establish a capture method that excludes the game scene behind it; cropping alone may not be enough if the menu is translucent. To keep maintenance efficient, I suggest: - Keep one shared set of screenshots in Longshot and reuse them across guides; the Site repository should continue consuming the built documentation rather than maintaining another copy. - Start with a small set of useful views, captured at a consistent window size, UI scale and theme. Keep explanations and numbered steps in page text, with useful alt text, so wording changes do not require editing images. - Track each image in a small manifest: source UI/view, capture steps, build or commit, platform, relevant UI source files, and last-reviewed version. Mark platform-specific views explicitly. - Have changes to those UI source files flag the affected screenshots for review. Reviewers can confirm an image is still accurate or replace only that image; a new release should not force recapturing everything. - Investigate a repeatable capture script or UI-only fixture once the launcher/menu supports it. Fixtures would need to render the actual maintained UI and be checked against the real build. Until then, a short manual capture checklist is enough; documentation builds should not require private game data. This is a follow-up proposal once a build is available. No screenshots or capture automation are included yet. Feedback on the simplest reliable capture and review workflow would be welcome.

bibiburl commented

2026-11-13 06:17:30 +00:00

Author

Member

Pushed a17ea51: added “No game files included” in the releases card’s central copy, explicitly stating that we do not host or distribute game files, game assets or keys and users must provide their own supported copy. Preview refreshed; 15-page build, 918 link/asset checks and all nine website test files pass. Rendered visual checks remain outstanding.

bibiburl commented

2026-11-13 06:20:55 +00:00

Author

Member

Pushed 57f6577: moved the game-files disclaimer outside the release card, directly underneath it in red (source-color contrast 9.70:1 dark, 6.89:1 light). Checked 105 available Longshot PRs plus 6 Site PRs; added missing profiles simonwjackson (#138/#137/#136), snaildev99 (#134/#131), and futondestroyer (#108), with profile API avatar URLs. The GitHub sync account is not listed as a person. Existing roster order and bibiburl-last preference retained. Build, 918 link/asset checks and all nine website test files pass; generated HTML confirms 12 cards and the separate disclaimer. Preview refreshed. Rendered visual checks remain outstanding.

HumanBean added the

preview

label

2026-11-13 08:15:21 +00:00

HumanBean force-pushed docs/longshot-website from 0074997f30

Third-party parts / The same as upstream (pull_request) Has been skipped

Details

Website / Website on Cloudflare (pull_request) Has been skipped

Details

CI / Conventional Commit title (pull_request) Successful in 4s

Details

Linux AppImage / appimage (pull_request) Failing after 3m32s

Details

PR description / Description follows the template (pull_request_target) Has been cancelled

Details

CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been cancelled

Details

CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been cancelled

Details

CI / Python source checks (windows-2022, part 1/2) (pull_request) Has been cancelled

Details

CI / Python source checks (windows-2022, part 2/2) (pull_request) Has been cancelled

Details

CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been cancelled

Details

CI / Workflow lint (actionlint) (pull_request) Has been cancelled

Details

Third-party parts / As their notes say (pull_request) Has been cancelled

Details

Windows builder / dav1d for Windows (llvm-mingw) (pull_request) Successful in 4m33s

Details

Windows builder / Longshot Builder zip (pull_request) Has been cancelled

Details

Windows builder / Windows Vulkan back end (llvm-mingw) (pull_request) Has been cancelled

Details

to ef3312f7d4

CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped

Details

CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped

Details

CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped

Details

Third-party parts / The same as upstream (pull_request) Has been skipped

Details

Website / Website on Cloudflare (pull_request) Has been skipped

Details

PR description / Description follows the template (pull_request_target) Failing after 6s

Details

CI / Conventional Commit title (pull_request) Successful in 4s

Details

CI / Workflow lint (actionlint) (pull_request) Successful in 6s

Details

Third-party parts / As their notes say (pull_request) Successful in 8s

Details

2026-11-13 08:16:07 +00:00

Compare

HumanBean commented

2026-11-13 08:17:02 +00:00

Owner

Hi @bibiburl, thanks for the site! I've pushed some work on top of your branch. Your commits are all still there, rebased onto main, with two commits of mine added after them:

Preview: https://pr-104-longshot-website.hckr-5e0.workers.dev (uploaded by hand from ef3312f7).

ci(website): deploy and previews. Merging to main deploys the site to longshot.magicbean.dev, and it refreshes hourly so the progress data stays current. A PR from a Longshot branch gets a preview on every push. A PR from a fork gets one when a maintainer adds the preview label. That label only works once this workflow is on main.

feat(website): the rework.

URLs: the site is served at the domain's root, without /Longshot/. The URLs are reorganised: /install, /requirements, /settings, /saves, /saves/transfer, /help, /help/report, /help/antivirus, /progress, /contributing, /about, /about/team.
Simpler code, all TypeScript:
- A content loader renders the repo's documents straight into Starlight, so there are no generated files.
- site.ts replaces site.config.mjs.
- The progress data and the team roster are fetched at build time, so there's no committed snapshot, feed server or roster JSON. The team page lists the top contributors from the commit history. Your last commit's three roster files aren't needed, because those people show up from their commits.
Rebuilt pages: the home, Install (with download buttons), Settings (checked row by row against vk_menu.cpp), Updates & saves, Transfer a save (around the launcher's importer and exporter), Help (problems grouped by when they happen), Antivirus warnings (step by step for Windows) and Report a problem.
Requirements: a hard-coded copy of the README's "What you need" section, which now gives CPU and GPU estimates.
/manual/ is gone: links into the README go to the README on Forgejo.
Downloads: worker/index.ts serves the launcher's permanent download links (/download, /download/launcher/<channel>/<os>), which redirect to git-cdn.magicbean.dev. This code comes from MagicBeanDev/Site#7.
Styling: one theme with a type scale, more neutral colours, a smaller footer, and your "no game files included" note kept on the home page's download card.
README: the install, update and troubleshooting section is rewritten, and the in-game menu table is corrected against the code.

Checks: npm run build and npm run check pass (the site check covers 14 pages, links and anchors; 43 of 43 tests pass). tests/run_all.py has 2 failures on my machine, test_bake_portability and test_builder_log_read_only, which I haven't looked into.

Shout if anything here goes against what you had in mind.

Hi @bibiburl, thanks for the site! I've pushed some work on top of your branch. Your commits are all still there, rebased onto `main`, with two commits of mine added after them: **Preview:** https://pr-104-longshot-website.hckr-5e0.workers.dev (uploaded by hand from `ef3312f7`). **`ci(website)`: deploy and previews.** Merging to `main` deploys the site to **longshot.magicbean.dev**, and it refreshes hourly so the progress data stays current. A PR from a Longshot branch gets a preview on every push. A PR from a fork gets one when a maintainer adds the `preview` label. That label only works once this workflow is on `main`. **`feat(website)`: the rework.** - **URLs:** the site is served at the domain's root, without `/Longshot/`. The URLs are reorganised: `/install`, `/requirements`, `/settings`, `/saves`, `/saves/transfer`, `/help`, `/help/report`, `/help/antivirus`, `/progress`, `/contributing`, `/about`, `/about/team`. - **Simpler code, all TypeScript:** - A content loader renders the repo's documents straight into Starlight, so there are no generated files. - `site.ts` replaces `site.config.mjs`. - The progress data and the team roster are fetched at build time, so there's no committed snapshot, feed server or roster JSON. The team page lists the top contributors from the commit history. Your last commit's three roster files aren't needed, because those people show up from their commits. - **Rebuilt pages:** the home, Install (with download buttons), Settings (checked row by row against `vk_menu.cpp`), Updates & saves, Transfer a save (around the launcher's importer and exporter), Help (problems grouped by when they happen), Antivirus warnings (step by step for Windows) and Report a problem. - **Requirements:** a hard-coded copy of the README's "What you need" section, which now gives CPU and GPU estimates. - **`/manual/` is gone:** links into the README go to the README on Forgejo. - **Downloads:** `worker/index.ts` serves the launcher's permanent download links (`/download`, `/download/launcher/<channel>/<os>`), which redirect to git-cdn.magicbean.dev. This code comes from MagicBeanDev/Site#7. - **Styling:** one theme with a type scale, more neutral colours, a smaller footer, and your "no game files included" note kept on the home page's download card. - **README:** the install, update and troubleshooting section is rewritten, and the in-game menu table is corrected against the code. **Checks:** `npm run build` and `npm run check` pass (the site check covers 14 pages, links and anchors; 43 of 43 tests pass). `tests/run_all.py` has 2 failures on my machine, `test_bake_portability` and `test_builder_log_read_only`, which I haven't looked into. Shout if anything here goes against what you had in mind.

HumanBean force-pushed docs/longshot-website from ef3312f7d4

CI / Python source checks (ubuntu-24.04, part 1/2) (pull_request) Has been skipped

Details

CI / Python source checks (ubuntu-24.04, part 2/2) (pull_request) Has been skipped

Details

CI / SPIR-V fixtures (global narrow load/store, direct surface atomics, F2I immediate) (pull_request) Has been skipped

Details

Third-party parts / The same as upstream (pull_request) Has been skipped

Details

Website / Website on Cloudflare (pull_request) Has been skipped

Details

PR description / Description follows the template (pull_request_target) Failing after 6s