Repository navigation
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
📸 Screenshot drift checkNo drift: the committed screenshots already match a fresh deterministic generation. ✅ |
maniator
force-pushed
the
claude/project-thread-vpvjev
branch
from
November 15, 2026 22:22
73c6774 to
1a9a900
Compare
The manual draws the game's Win95 menu bar under its title bar, with File (back to the game, print), Edit (find, copy this page's link), Options (light, dark, match the device) and Help (what's new, report a problem, sponsor). The bar's behavior is the game's MenuBar, its styles move to a shared src/styles/menu-bar.css that both import, and each pick reports app_action help_menu_pick with the item's code. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ms7trYsinXUbmcSQZ3d6N7
A production build now puts the manual at the root of its own host, so its pages read help.verticopolis.com/rooms/ and the installed Android app opens Help in the browser over the running game instead of in place of it. Every other build (previews, staging, CI, local) keeps it under /help on its own host. - scripts/vercel-build.sh sets VC_HELP_ORIGIN for production. The help build reads it for its base, its canonical links and sitemap, and a Satteri hast plugin points the pages' /help/... and game links at this build's address. The game reads it (src/helpAddress.ts) for every link it opens into the manual. - vercel.json moves to ordered routes so the help host can be matched before the filesystem: help.verticopolis.com serves dist/help/, and verticopolis.com/help/... redirects (308) to the same page there. - Drop the test that parsed vercel.json's headers; it read configuration, not behavior, and the routes format replaced what it parsed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ms7trYsinXUbmcSQZ3d6N7
maniator
force-pushed
the
claude/project-thread-vpvjev
branch
from
November 15, 2026 22:32
8f2379d to
acaefef
Compare
6 of 12 tasks
Owner
Author
|
Moved to #2339 (branch Generated by Claude Code |
Contributor
|
The docs preview for this pull request was removed when it closed. |
maniator
temporarily deployed
to
github-pages
November 15, 2026 22:33 — with
GitHub Actions
Inactive
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Naftali · project thread
What & why
Two changes Naftali asked for after #2316:
The game's menu bar on the help site. The Win95 menu bar is now the top row of every help page, above the navy title bar, where the game draws it.
The bar's behavior is the game's own
MenuBar(src/ui/menuBar.ts). Its styles move unchanged into a sharedsrc/styles/menu-bar.css, which both the game and the help site import. Each pick sendsapp_actionhelp_menu_pickwith the item's code.The manual moves to help.verticopolis.com, with clean addresses (help.verticopolis.com/rooms/, Naftali's pick). On Android the installed app keeps in-scope links in its own window, so the manual replaced the game. On its own host, Help opens in the browser over the running game.
scripts/vercel-build.shsetsVC_HELP_ORIGIN=https://help.verticopolis.comin a production build. The help build (help-site/site.mjs) then sits at the root of that host, with its canonical links, sitemap and share cards there. A Satteri hast plugin (astro.config.mjs) andsiteHrefpoint the pages'/help/...and game links at the right address. The Markdown keeps writing/help/..., because the game's own Help window reads the same files.helpUrl(src/helpAddress.ts,__HELP_ORIGIN__): the Help button, the mode badge, the welcome, the update prompt, About's privacy link, the Classic and Modern summary, the gallery and the 404 page.vercel.jsonmoves to orderedroutes. Vercel checks its files before anyrewritesrun, so the game'sindex.htmlwould otherwise win at help.verticopolis.com/. Requests on the help host are now served fromdist/help/, except/api/(the analytics relay),/_vercel/, and/assets/and/styles/(the shared 404 page). verticopolis.com/help/... answers with a 308 to the same page on the help host. The cache headers are the same rules as before, now also matching the help host's/_astro/and/pagefind/paths.*.verticopolis.com. The help page view and the landing read the base from Astro, so they report the same page names on the new host.How the manual ships per release
It stays in the same Vercel project and the same build, so every production deployment carries its matching manual. help.verticopolis.com is a second domain on that deployment, so the game and the manual can never drift apart, and a rollback moves both. Previews and staging keep the manual at
/helpon their own host, as today; staging gets no separate help host.Before this merges (owner setup)
The MCP token can't add domains or env vars (403), so the owner adds:
help.verticopolis.comon the project. Vercel already hosts the DNS, so it configures the record and certificate itself. First assign it to the Git branchclaude/project-thread-vpvjevto try it on this preview, then switch it to Production right before the release that carries this PR deploys.VC_HELP_ORIGIN=https://help.verticopolis.comscoped to branchclaude/project-thread-vpvjev, then a redeploy. Delete it at merge. While it is set, this branch's*.vercel.apppreview builds the manual for the help host, so its own/helplinks break. That is expected.The production deploy must not go out before the domain is on Production, or verticopolis.com/help would redirect to a host that doesn't answer.
Type of change
Game mode impact
n/a: the help site's chrome, its address and the game's links to it. No simulation change.
Quality gates
npm run typechecknpm run lintnpm test(CI. The help site, help address, help menu, About and Help, 404, update prompt, compare and telemetry suites pass locally.)npm run build(CI. The help site builds locally in both modes:/help, with the link check at 0 broken, and the help host root.)Versioning
.changesnote with the rightapp:andcrate:levels, or this PR changes no deployed pathpackages/verticopolis-engine/README.mdand/orengine-rs/CRATE_README.md, or read both and putreadmes: unchangedin the note, or this PR changes no engine sourceComplexity
n/a: no hot path. The help menu runs only on a click, and
helpUrlruns only when the player opens a manual link. The game's menu bar CSS moves to its own file and keeps the same rules in the same cascade position (src/styles.cssimports it right beforegame/menubar.css). The routes add no function or middleware: game requests match only the same header rules as before.Hot-path record (section 6): no hot-path surface
Screenshots / recordings
The local builds (desktop and phone) are in the project thread. The preview link is in the Vercel comment.
Notes for reviewers
--sl-nav-height). The bar sits on top, and the title bar's logo and the phone's menu button keep their old size, moved down under it (help-site/src/styles/help.css)./help/link is left, game links are absolute to verticopolis.com, and the search results, room pictures (catalog.json) and menu links resolve, with no 4xx in the browser.src/tests/helpSite.test.tsloses its vercel.json header test. It parsed configuration rather than behavior, which project policy rules out, and the routes format replaced what it read.Generated by Claude Code
https://claude.ai/code/session_01Ms7trYsinXUbmcSQZ3d6N7
Generated by Claude Code