docs: align chapter 8 with wheels-basecoat 3.0.0 INSTALL.md (F16)#2409
Merged
docs: align chapter 8 with wheels-basecoat 3.0.0 INSTALL.md (F16)#2409
Conversation
The chapter was written against wheels-basecoat 1.0.2 — a CSS-only
distribution where users had to download basecoat.min.css from jsdelivr
themselves. The live registry now serves 3.0.0, which ships its full
CSS+JS bundle inside the package at vendor/wheels-basecoat/assets/. A
fresh-VM tutorial follower currently gets 3.0.0 installed and is then
told (by the chapter) to download a separate copy from a CDN — works,
but produces a setup that doesn't match the package's own INSTALL.md.
Aligned the chapter to the INSTALL.md pattern (which the package ships
inside vendor/ for users to read):
- "Serve the basecoat CSS asset" → "Publish the basecoat assets"
- curl/jsdelivr step → `cp -r vendor/wheels-basecoat/assets/basecoat
public/assets/basecoat`
- Layout helper goes from `basecoatIncludes(basecoatCSSPath="...")`
(explicit override) to `basecoatIncludes()` (reads bundled defaults)
- Asset URL changes from `/assets/basecoat.min.css` to
`/assets/basecoat/basecoat.min.css` — reflected in troubleshooting
- Sample install output and example package.json snippet are now
version-agnostic so future basecoat releases don't drift the chapter
- Added a callout pointing readers at vendor/wheels-basecoat/INSTALL.md
for whichever version they have, since post-3.0 majors may diverge
The CLI activation message (`Run wheels stop && wheels start ...`) was
already corrected in #2399 — the chapter now matches.
F16 from the 2026-05-01 fresh-VM tutorial run.
Co-authored-by: Claude Opus 4.7 (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
1 participant
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.
Summary
Chapter 8 was written for
wheels-basecoat@1.0.2(CSS-only, user downloadsbasecoat.min.cssfrom jsdelivr themselves). The live registry now serves3.0.0, which ships its full CSS+JS bundle atvendor/wheels-basecoat/assets/basecoat/. A fresh-VM tutorial follower currently gets 3.0.0 installed and is then told to do a redundant CDN download — works, but produces a setup that doesn't match the package's own INSTALL.md.Aligned the chapter to the INSTALL.md pattern:
cp -r vendor/wheels-basecoat/assets/basecoat public/assets/basecoatbasecoatIncludes(basecoatCSSPath="...")→basecoatIncludes()(reads bundled defaults)/assets/basecoat.min.css→/assets/basecoat/basecoat.min.css(also reflected in the troubleshooting section)package.jsonsnippet are now version-agnostic so future basecoat releases don't drift the chapter againvendor/wheels-basecoat/INSTALL.mdfor whichever version they have — post-3.0 majors may divergeThe CLI activation message was already corrected in #2399; the chapter now matches.
Source
F16 from the 2026-05-01 fresh-VM tutorial run.
Test plan
wheels-basecoat@3.0.0: package installs,cp -rstep succeeds,basecoatIncludes()resolves, post show view renders with basecoat classespackages-index.png) — should be unaffected since chapter changes don't reach the package detail page🤖 Generated with Claude Code