web: /guide/make — 05 Community and 06 Pattern Lab

[engmung]

Stacked on #461 (base guide). Merge that first, then this one retargets to dev.

What this is

The guide is two pages now. /guide keeps the first hour (01–04), and its closing card links on. /guide/make and /guide/make/ko are "Make your own", and start on a board that is already powered with Basics on it.

• 05 Community walks the real site in six steps:

  • the wall
  • which patterns can go on a board (.h, Flashable now)
  • sending one pattern (↗ Send to my Patternflow → Send over Wi-Fi, no account)
  • your own deck in the dock
  • other people's decks
  • Open in Pattern Lab

  Every screen is a crop of the live site, taken logged out. A ring marks the control the step is about, and the caption quotes the UI's own words.

• 06 Pattern Lab has eleven steps, in the order the work happens:

  • open the Lab
  • name it first
  • ask an AI (Copy prompt → Paste, or Generate with your own Gemini key)
  • black and white is right (v-field + Color Ramp)
  • the knobs
  • the second prompt that makes the .h
  • ↗ Apply to my Patternflow
  • layers
  • Graphic Export
  • Director
  • giving it back

  Layers, Graphic Export and Director are steps here, not chapters.

• The board plays the reader's own Lab draft through the whole of 06. It reads patternflow_lab_project_v2 read-only and follows every save the Lab makes, whether in the window or in another tab. The real /pattern-lab opens in a window beside the board on desktop; on a phone it's a link.

Checked

• Walking both pages leaves every patternflow_lab_* key byte-identical, with no data and with a saved draft. An old v1 draft is not migrated.
• An edit in the Lab reaches the board in about 0.7 s.
• A draft that doesn't run leaves the board on its own pattern, and the tag says the draft doesn't run yet. It does not leave the board black.
• GPU captures of every step: desktop and phone, en and ko. Transition sweeps show no white flash.
• The start page is identical apart from the next-guide link, checked with a DOM diff and captures.
• npm run build passes; the four guide routes are static. tsc, eslint and vitest (123 tests) are clean.

Not checked

• Safari, Firefox and real touch devices. Screens between 1180 and 1366 px wide were only emulated.
• Apply → Send over Wi-Fi was never pressed on a real board, by design. The captions quote the modal's code.
• The stage blanks for about 20 frames when moving between /guide and /guide/make: each page mounts its own canvas.

Found along the way (not changed here)

• Deck order is lost from the dock. The dock's Send to my board → Send over Wi-Fi drops the deck's order on the board. The console's installFromUrl (firmware/patternflow/console/patterns.html) only takes .pfm and .json, so the build's catalog.txt never arrives. The guide says the order carries over for public decks and .zip only, which is true today.
• Stale wording on the community. The pattern page's Performances note still says "Director's Save-JSON"; the Director saves .pfs.
• Two Labs, two sets of drafts. "Open in Pattern Lab" on the community opens community.patternflow.work's Lab, which keeps drafts separate from patternflow.work's. The guide says so.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
pattern-flow-open	Ready	Preview	Sep 30, 2026 12:47pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
pattern-flow_origin	Ignored		Sep 30, 2026 12:47pm UTC