peter/popski-platform
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(design-guide): document vendored Tailwind Browser build #2

Merged
peter merged 1 commit from feat/vendor-tailwind-browser into main 2026-07-06 22:16:19 +00:00
Conversation 0 Commits 1 Files changed 1 +32 -5
peter commented 2026-07-06 22:07:02 +00:00
Owner
Copy link

What

The infra-side app-registry change vendoring Basecoat UI also vendors
@tailwindcss/browser@4.3.2 (self-hosted, served at /tailwind/browser.js),
because Basecoat's own CDN bundle only ships the Tailwind utility classes its
components use — not general-purpose utilities like grid, flex, gap-*,
or responsive variants, which the guide's own Layout examples rely on.
Confirmed empirically: those examples render as an unstyled single column
without it.

This docs the fix:

  • New "Tailwind utilities" section under Layout patterns, pointing at the
    vendored /tailwind/browser.js
  • Corrects the Layout intro, which previously implied Basecoat's bundle
    included general Tailwind utilities
  • Pins both package versions (basecoat-css@1.0.2, @tailwindcss/browser@4.3.2)

Test plan

  • Reviewed rendered markdown for broken links/anchors
## What The infra-side app-registry change vendoring Basecoat UI also vendors `@tailwindcss/browser@4.3.2` (self-hosted, served at `/tailwind/browser.js`), because Basecoat's own CDN bundle only ships the Tailwind utility classes its components use — not general-purpose utilities like `grid`, `flex`, `gap-*`, or responsive variants, which the guide's own Layout examples rely on. Confirmed empirically: those examples render as an unstyled single column without it. This docs the fix: - New "Tailwind utilities" section under Layout patterns, pointing at the vendored `/tailwind/browser.js` - Corrects the Layout intro, which previously implied Basecoat's bundle included general Tailwind utilities - Pins both package versions (`basecoat-css@1.0.2`, `@tailwindcss/browser@4.3.2`) ## Test plan - [ ] Reviewed rendered markdown for broken links/anchors
Basecoat's own CDN bundle only ships the Tailwind utility classes its
components use, not general-purpose utilities like grid/flex/gap-* — the
Layout section's examples need real Tailwind. Document the vendored
Tailwind Browser build at /tailwind/browser.js and pin both packages'
versions (basecoat-css@1.0.2, @tailwindcss/browser@4.3.2).
peter merged commit d718a26f0c into main 2026-07-06 22:16:19 +00:00
peter deleted branch feat/vendor-tailwind-browser 2026-07-06 22:16:20 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
peter/popski-platform!2
No description provided.