Files
d965d819f2 docs: add an unlinked browser demo for production testing (#4280)
Adds a **Try it** page at `/try-it/`, available by direct URL while
production embedding is tested; excluded from navigation, site search,
and the sitemap, with a noindex directive, with a live Worktrunk demo in
a browser-local Alpine ARM64 VM via [Demoshell](https://demoshell.com).
Nothing downloads until Run is pressed. The page includes Demoshell
attribution and a permanent full-page fallback link.

The VM definition lives in `docs/demos/demoshell/`: the setup recipe,
Bash startup rcfile, and guide. The guide covers list → create → edit →
list → merge, followed by an optional manual picker step. Merge commits
the change automatically. Studio must launch Bash explicitly: changing
root's login shell does not replace its running ash session. The prompt
retains the `arm64js:` prefix required by Demoshell's command tracker.
The README maps each file to its Studio field and provides an ARM64
Alpine Docker check using the same Bash entry point.

**Production test rollout:** `m/tui:worktrunk` resolves from the allowed
`worktrunk.dev` origin. The recipe, startup file, and guide draft are
entered in Studio, but the final snapshot upload is stalled at 1% after
setup completes. The currently published snapshot predates the prompt
repair, and visitors still receive the old guide. The page is
intentionally unlinked so it can be merged and tested on the accepted
production origin before broader exposure. The corrected snapshot must
finish saving, then the new guide must be published and tested in a
fresh visitor session.

Validation: the required command patterns and output checks pass on
ARM64 Alpine with `wt v0.81.0`. In the real Studio preview, applying the
Bash/prompt corrections allowed the required steps to check off, merge
to commit automatically, and the shell to return to main. The optional
picker opens and exits; its guide step uses manual completion because
Demoshell did not detect the alternate-screen exit. Local docs build,
type checks, plugin/site tests, and docs sync passed. Final snapshot
publication and a fresh end-to-end run remain blocked by the upload.

The sidebar-order test accepts Astro page routes, and the page-outline
test exempts `/try-it/`, whose table of contents is disabled to give the
demo more width.

Disclosure from the original author: they run Demoshell. Hosting is free
for eligible open-source projects, and the embed carries attribution.

> _This was written by Codex on behalf of max-sixty_

---------

Co-authored-by: worktrunk-bot <254187624+worktrunk-bot@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Maximilian Roos <m@maxroos.com>
2026-10-21 19:40:15 -07:00
..