docs: restate PocketJS as a portable application runtime - #328
Merged
Conversation
One positioning sentence now carries the project everywhere it is defined: "PocketJS is a portable application runtime that turns modern component code into native pixels across radically different hardware." It replaces the UI-runtime-minus-the-browser framing in the landing hero, the homepage and site-wide meta descriptions, the docs overview and architecture intros, and the npm package description. The landing headline becomes "UI runtime for every kind of computer"; the pinned hero copy in tests/site-stage.test.ts follows. The README keeps the chapter order it gained in #325 but drops the landing voice: section names are now plain technical headings (Programming model, Rendering and execution, Performance, Native modules, Hardware support, Applications, Getting started, Ahead-of-time compilation, Repository layout, Building and testing, Documentation), prose is third person, and the frameworks, styling, animation and target-admission material sits under subsections. Adds a Contents list and a Documentation index; keeps every measurement, receipt link and attribution. Verified: `bun run test` (11/11 stages), `bun run site:build`, and a headless Chrome measurement of the three-line headline (widest line 445 px against 651 px of plate at 1600w, no overflow at 1600/1280/820/390 px). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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.
Positioning
One sentence now defines the project everywhere it is stated:
site/home.html)site/build.ts)SITE_DESC)SITE_FOOTER_DESC)docs/overviewintrodocs/architectureintrodocs/getting-startedscope linedescriptiontests/site-stage.test.tspins the hero copy, so both assertions were updated with it.README register
Same chapter order as #325, without the landing voice:
### Frameworks,### Styling,### Animation,### Target admission,### From component to pixel,### The frame contract,### On a Sony PSP,### On a desktop).Verification
bun run test— 11/11 stages green, 443 tests. (One earlier run had a single non-reproducing unit-stage failure, the known flake on this machine; the clean run is the one reported.)bun run site:build— homepage, 18 docs pages, 19 blog posts; built output carries the new descriptions.fits: trueand zero horizontal overflow at 1600 / 1280 / 820 / 390 px. A two-line break would have been 636 px against 651 px, so the three-line break is deliberate.pocketjs.devdocs/blog slug re-checked; TOC anchors match the headings.Docs and site copy only; no runtime code paths touched.
🤖 Generated with Claude Code