Repository navigation
[DONE] 웹 가이드 펌웨어 굽기·와이파이를 BOOT+RST 기본으로 고치고, 메인 README·문서를 정리한다 - #7
Merged
patternflow-bot merged 19 commits intoOct 12, 2026
Merged
Conversation
…witch username to mbchars.
mbchars.py puts the remix's printed parts together from its STLs (no assembled file exists): the three front sections where the joint bars' 36 mm insert pitch puts their lug holes, the covers on the sixteen inserts, the USB retainer on its boss and the stands on the bottom edge, each step checked against the README (410.28 x 176.16 x 42 mm), the board's encoder grid, the 320 x 160 mm panel and boolean overlaps. assemble.mjs learns ledTurn (the panel lies the long way here) and knobLook (the official knob, printed white), and lib/looks.mjs pla_orange, the 3MF's own #F46B16. The other three models rebuild byte-identical; the new one is 380 KB. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QGBYm64PnfneJq2ZDJ8Gs7
…horizontal desktop one The card is the remix README's own facts and photos (resized to 1200 px), the preview shows the device in the case, and the switch is four tabs, two by two on a phone. A case too wide for the view at the one scale (this one, 41 cm across on a desktop's tall canvas) is drawn smaller by as little as keeps it clear of the arrows; every case still fits at the one scale on a phone, and the three upright ones on a desktop. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QGBYm64PnfneJq2ZDJ8Gs7
…review case Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QGBYm64PnfneJq2ZDJ8Gs7
…al-desktop hardware+web: mbchars' horizontal desktop case as the third remix, and the fourth case in /build's 3D preview (supersedes engmung#488)
Found by accident, with the PCBs ordered ten minutes later; the 3D printer came a month on, bought for the case, and the case was the first thing it printed. Moscow was given, so the pin is on the city. The blurb stops at the printer. The maker's note about making the patterns with AI is left out on purpose, and there are no pronouns for the maker: the message does not say. Three photos: a pixel-art Mount Fuji beside a modular synth, a pixel-art frog pond seen from above, and a cat plush in front of the panel. groups.test.ts pins the number of countries on the real map; Russia is new, so 11 becomes 12. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
On the Build tab the name on the case's tab (Official, Besoiobiy, SimonePDA, mbchars) stands over the device, on the build map's dark highlight. It follows the pick at once, as the tab does, and reads Official for a case whose model did not load. The knob hint moves under it while it is up. Changelog also gets the line for the arrows. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ZuperZuche's build joins the map; the 3D preview names whose case it is
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
…n't come, and ends on the panel's own network Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
…e same flash order; /flash goes to the Flash chapter Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
…t, the story tightened Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
…that list what exists, stale wording gone Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
…s pass Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
…other flash surfaces (removed in the next commit) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
patternflow-bot
changed the title
…ay intact (removed in the next commit) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
patternflow-bot
marked this pull request as ready for review
October 12, 2026 09:54
patternflow-bot
deleted the
claude/patternflow-docs-build-guide-d73smq
branch
October 12, 2026 10:05
This was referenced Oct 12, 2026
Merged
patternflow-bot
added a commit
that referenced
this pull request
Oct 12, 2026
…으로 (기록용, 머지하지 않음) (#10) * Add horizontal desktop printed enclosure and assembly instructions. Switch username to mbchars. * tools: case-models builds mbchars' horizontal desktop case mbchars.py puts the remix's printed parts together from its STLs (no assembled file exists): the three front sections where the joint bars' 36 mm insert pitch puts their lug holes, the covers on the sixteen inserts, the USB retainer on its boss and the stands on the bottom edge, each step checked against the README (410.28 x 176.16 x 42 mm), the board's encoder grid, the 320 x 160 mm panel and boolean overlaps. assemble.mjs learns ledTurn (the panel lies the long way here) and knobLook (the official knob, printed white), and lib/looks.mjs pla_orange, the 3MF's own #F46B16. The other three models rebuild byte-identical; the new one is 380 KB. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QGBYm64PnfneJq2ZDJ8Gs7 * web: /build's case switch and 3D preview get a fourth case, mbchars' horizontal desktop one The card is the remix README's own facts and photos (resized to 1200 px), the preview shows the device in the case, and the switch is four tabs, two by two on a phone. A case too wide for the view at the one scale (this one, 41 cm across on a desktop's tall canvas) is drawn smaller by as little as keeps it clear of the arrows; every case still fits at the one scale on a phone, and the three upright ones on a desktop. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QGBYm64PnfneJq2ZDJ8Gs7 * docs: changelog for mbchars' horizontal desktop case and the fourth preview case Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QGBYm64PnfneJq2ZDJ8Gs7 * web: ZuperZuche's build joins the map - the first print, from Moscow Found by accident, with the PCBs ordered ten minutes later; the 3D printer came a month on, bought for the case, and the case was the first thing it printed. Moscow was given, so the pin is on the city. The blurb stops at the printer. The maker's note about making the patterns with AI is left out on purpose, and there are no pronouns for the maker: the message does not say. Three photos: a pixel-art Mount Fuji beside a modular synth, a pixel-art frog pond seen from above, and a cat plush in front of the panel. groups.test.ts pins the number of countries on the real map; Russia is new, so 11 becomes 12. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com> * web: the 3D preview names whose case it is, in the build map's label On the Build tab the name on the case's tab (Official, Besoiobiy, SimonePDA, mbchars) stands over the device, on the build map's dark highlight. It follows the pick at once, as the tab does, and reads Official for a case whose model did not load. The knob hint moves under it while it is up. Changelog also gets the line for the arrows. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> * web, docs: the first flash starts in download mode, /flash goes to the guide's Flash chapter, and the README is new from its first screen The Play guide's 01 Flash (and /ko) puts hold BOOT, tap RST before Flash Patternflow on every first flash, assumes the Wi-Fi step after "Installation complete!" usually does not come (RST, Flash Patternflow again, Connect to Wi-Fi), and ends on the panel's own patternflow-xxxx network at 192.168.4.1 for when that does not take; the device simulator draws the NETWORK screen's hotspot. The Build guide's flash card, the Pattern tab's notes and the breadboard page give the same order. The bare /flash, which the device's Update page and every release's FLASHING.md point at, redirects to /guide/play#flash; /flash/manifest.json and /flash/bin/* are untouched. flash.test.ts pins the card order and anchors. The README opens with a one-line definition, the hero, the photosensitivity warning, four doors (Build, Play, Make patterns, Add sound) and First light; the story, community, facts and editions follow, shorter. The docs that give the first flash (firmware/README.md, PATTERN_GUIDE.md, SUPPORT.md, docs/assembly/) say the same order, the indexes list the guide pages, the three case remixes and the bundles that exist, and stale wording (the custom slots, "variant", the dead /flash page) is gone. CONTRIBUTING.md gets a row for the interactive guide's copy, and the pull request template asks for the row and the link check. From #7 (caaf2c1). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VaFtEmtx2AkdH1wnbQpV3Z * docs: the README opens with the fixed lines and three ways in, and First light follows the build The opening is L1 + L2 + L3 from docs/manifesto.md (Paik moves to Where it began, in L5's own words), with Play one in your browser, Build one and Get one assembled under the badges. First light moves below the build, gains the steps it was missing (unplug before seating, Origin as the sign of success, Format storage on the first Basics install) and states the J4 rule as data never power on the DevKit's ports. Stale lines are corrected against the repo: sound and MQTT shipped in editions, MIDI arrived in 3.9.0, 3.10.5 fixed four requests, and the photosensitivity warning is the manifesto's full text. From #8 (bfc4b22). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VaFtEmtx2AkdH1wnbQpV3Z * docs: BUILD_GUIDE flashes in the Play guide's order, and the README's campaign is still open BUILD_GUIDE §8.1 now goes download mode first (hold BOOT, tap RST), Flash Patternflow, the Wi-Fi as a second go after RST, the DevKit seated with the power bank unplugged, then the panel's own patternflow-xxxx network (K2 shows its name before the hotspot is up), then the Basics pack: the Play guide's 01 Flash card for card. §7 no longer seats the DevKit before it has firmware, so it is Wiring, and 7.4 names the step that powers up. The README's First light points at §8 again, and Crowd Supply reads as it stands: past its goal, open until 15 October; the 200% figure stays in the dated timeline. Besoiobiy's case README cites the renumbered steps. From #9 (16eca1b). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VaFtEmtx2AkdH1wnbQpV3Z --------- Co-authored-by: Mykyta Bilous <belousnikita@gmail.com> Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: Lee Seunghun <122682380+engmung@users.noreply.github.com>
engmung
pushed a commit
to engmung/Patternflow
that referenced
this pull request
Oct 12, 2026
…e guide's Flash chapter, and the README is new from its first screen The Play guide's 01 Flash (and /ko) puts hold BOOT, tap RST before Flash Patternflow on every first flash, assumes the Wi-Fi step after "Installation complete!" usually does not come (RST, Flash Patternflow again, Connect to Wi-Fi), and ends on the panel's own patternflow-xxxx network at 192.168.4.1 for when that does not take; the device simulator draws the NETWORK screen's hotspot. The Build guide's flash card, the Pattern tab's notes and the breadboard page give the same order. The bare /flash, which the device's Update page and every release's FLASHING.md point at, redirects to /guide/play#flash; /flash/manifest.json and /flash/bin/* are untouched. flash.test.ts pins the card order and anchors. The README opens with a one-line definition, the hero, the photosensitivity warning, four doors (Build, Play, Make patterns, Add sound) and First light; the story, community, facts and editions follow, shorter. The docs that give the first flash (firmware/README.md, PATTERN_GUIDE.md, SUPPORT.md, docs/assembly/) say the same order, the indexes list the guide pages, the three case remixes and the bundles that exist, and stale wording (the custom slots, "variant", the dead /flash page) is gone. CONTRIBUTING.md gets a row for the interactive guide's copy, and the pull request template asks for the row and the link check. From Patternflow-lab#7 (caaf2c1). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VaFtEmtx2AkdH1wnbQpV3Z
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
4 participants
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.
dev / https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x
원래 레포 main 최신을 받은 위에서, 빌드 가이드가 굽기를 맡기는 웹 가이드 01 굽기 장을 처음부터 BOOT 누른 채 RST 로 시작하게 바꾸고, 와이파이 단계는 보통 안 나온다고 보고 RST 한 번 → 다시 Flash → Connect to Wi-Fi, 그래도 안 되면 패널이 직접 띄우는 네트워크(patternflow-xxxx) 순서로 적었습니다. 머지하면 그 장과 Pattern 탭·빌드 가이드·브레드보드 페이지가 이 순서로 바뀌고, 메인 README 가 새 첫 화면이 되고, 문서 30여 개가 지금 사실에 맞게 정리됩니다.
위 셋: en
#flash-4다운로드 모드가 첫 단계 ·#flash-6와이파이는 보통 안 나온다고 보고 「Usually: after RST」 경로가 먼저 ·#flash-8패널 화면에 HOTSPOT 과 이름.체크리스트
.claude/settings.json은 남김What
연주 가이드 01 굽기 (
/guide/play,/guide/play/ko) — 빌드 가이드/guide/build의 06 굽기 카드가 새 DevKit 을 여기(#flash-2)로 보냅니다.deviceSim.setHotspot)같은 순서로 맞춘 곳: 빌드 가이드 06 굽기 카드(en·ko)와 첫 불빛 카드, Pattern 탭 「Got the hardware?」 두 줄,
/build/breadboard「Flash the firmware first」./flash→/guide/play#flash리다이렉트 (web/next.config.ts): 페이지가 없는데 기기 Update 페이지(「flash it over USB at patternflow.work/flash」)와 릴리스 FLASHING.md 가 사람들을 거기로 보내고 있었습니다(404)./flash/manifest.json·/flash/bin/*는 그대로.메인 README: 한 줄 정의 → 히어로 → 광과민 경고 → 문 네 개(Build / Play / Make patterns / Add sound, 각 가이드 + 글 가이드) → First light 6단계(J4 전원만, 다운로드 모드 먼저, 와이파이는 보통 두 번째에, 핫스팟, Basics) → 이야기·커뮤니티·사실·에디션. 긴 참고 자료는 지우지 않고
<details>로 접음.문서 정리 (34개): 첫 굽기를 적은 문서(
firmware/README.md·PATTERN_GUIDE.md·SUPPORT.md·docs/assembly/)를 같은 순서로, 색인(docs/README.md·docs/REPOSITORY.md·hardware·remixes·web/README.md·web/ARCHITECTURE.md)에 가이드 페이지·리믹스 3개·legacy_lasercut/·번들을 올리고, 지금은 틀린 말(NETWORK 화면의 옛 줄, custom 슬롯, variant, 없는/flash페이지, MIDI edition→bundle 등) 정리. CHANGELOG [Unreleased] 에 Web 2줄·Docs 2줄.나눈 방식
공통 기반(원래 레포 merge, 01 굽기 장의 새 순서와 고정 앵커 #flash-1~4)을 먼저 못 박고 워크플로로 넷이 동시에 했습니다. 같은 파일은 한 에이전트만 고쳤고, 각 영역마다 검토 에이전트가 사실(펌웨어 코드)·규칙·테스트를 다시 확인해 고쳤습니다(8명). 모은 뒤 전체 빌드·검사·스크린샷은 제가 돌렸습니다.
copy.ts·scenes.ts·Extras.tsx·FlasherShots.tsx·KitFx.tsx·deviceSim.ts, 같은 파일이라 한 에이전트)copy/build.ts·PatternPanel.tsx·브레드보드 페이지)Tested
이 포크는 GitHub Actions 실행 기록이 0건이라(워크플로가 돌지 않음) PR 체크가 없습니다. 같은 명령을 최종 코드에서 로컬로 돌렸습니다.
cd web && npm run lint→ 0 errors (12 warnings, 원래 있던no-img-element)npm run typecheck→ 통과npm run build→ 통과 (BUILD_EXIT=0)npm run check:ci→ 전부 통과, vitestTest Files 35 passed (35) · Tests 478 passed (478)(새flash.test.ts가 8단계 순서·앵커를,deviceSim.test.ts가 핫스팟 화면을 고정)python3 .github/scripts/check_links.py→all 619 relative links resolvepython3 firmware/toolchain/check_boundaries.py→boundary holds·check_versions.py→versions agree: core v3.11.0, audio v0.7.0, performance v0.4.0curl→/flash307 →/guide/play#flash,/flash/manifest.json200next start+ headless Chromium(1280×800)으로 en·ko 를 차례로 스크롤해 찍음. 이 샌드박스는 gstatic.com(3D 모델 디코더)·unpkg.com(Flash 버튼 스크립트)이 정책으로 막혀 있어, 같은 라이브러리를 로컬 패키지(three 의 Draco 디코더, esp-web-tools 10.4.0)로 대신 내려 렌더했습니다. 소프트웨어 GL 이라 무대가 느리게 따라옵니다.ko
#flash-4·#flash-6·#flash-8:en
#flash-5Flash 버튼과 설치 화면 · 빌드 가이드 06 굽기 카드 · Pattern 탭 「Got the hardware?」 · 브레드보드 페이지 「Flash the firmware first」:실행법:
cd web && npm ci && npm run build && npx next start→/guide/play#flash-4(ko 는/guide/play/ko#flash-4)부터#flash-8까지 스크롤,/guide/build#firmware-1,/pattern,/build/breadboard,/flash.가정
/guide/build(2026-10-01 의 3D 빌드 가이드)로 봤습니다. 이 가이드는 DevKit 굽기를 자기 안에서 하지 않고 연주 가이드 01 굽기 장으로 보내므로, 굽기·와이파이 절차는 그 장에서 고치고 빌드 가이드 카드는 같은 순서로 요약했습니다.BUILD_GUIDE.md·BUILD_GUIDE_v2.md는 손대지 않았습니다. 그래서 BUILD_GUIDE §8.1 은 아직 BOOT+RST 를 「포트가 안 보일 때」로 적고 있어 웹·README 와 순서가 다릅니다 — 맞추려면 따로 말씀 주세요. 다른 리드미·문서는 「문서정리」 요청이라 고쳤습니다..github/pr-evidence/pr-7/에 올렸다가 다음 커밋에서 뺐습니다(PR [DONE] hardware+web: mbchars' horizontal desktop case (upstream #488) is the fourth case in the /build 3D preview #5 와 같은 방식, 그림은 a2235af 에 남음). 처음 올린 긴 이름(9a16156)은 MCP 도구가 긴 그림 주소에 백틱을 붙여서 짧은 이름으로 다시 올렸습니다.hardware/case/README.md·BUILD_GUIDE §4 의 「330 mm 케이스 USB 구멍은 굽기용」(기판에서 빼서 굽는다는 말과 어긋남),docs/rest-api.md의 「1.5 (unreleased)」(계약 문서),docs/LICENSE-SUMMARY.md의 CC BY-SA 대상 범위,web/src/app/editions/editions-data.ts의 오래된 주석.🤖 Generated with Claude Code
https://claude.ai/code/session_01UR5JReUYxYKzedyvcLM84x