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

Add Basecoat UI design guide as default component library #1

Merged
peter merged 1 commit from add-basecoat-design-guide into main 2026-07-05 14:38:34 +00:00
Conversation 0 Commits 1 Files changed 4 +358 -1
peter commented 2026-07-05 14:34:36 +00:00
Owner
Copy link

Summary

Adds a UI/UX design guide that establishes Basecoat UI as the default component library for all apps on apps.pop.ski. Basecoat UI is vendored at apps.pop.ski/basecoat/ — no external CDN dependency.

Changes

File Change
references/design-guide.md New — canonical design guide with integration instructions, starter template, component patterns, layout conventions, typography/colors, and deviation policy
references/create-app.md Replace bare-bones index.html template with Basecoat UI starter template; add link to design guide
SKILL.md Add ## Design section; add design-guide.md row to References table
README.md Add design-guide.md entry to Contents list

Design guide contents

  • Integration — vendored CSS/JS at apps.pop.ski/basecoat/ (offline on tailnet, no CDN outage risk)
  • Starter template — complete index.html with header, nav, card component
  • Component patterns — buttons, forms, cards, alerts, dialogs
  • Layout patterns — app shell, responsive grid, sidebar
  • Typography and colors — Geist Sans/Mono fonts, CSS variable theming, 8 theme packs
  • When to deviate — acceptable cases (custom viz, games, embeds) and responsible practices

Validation

  • All internal markdown links resolve to existing files
  • The index.html template in create-app.md matches the starter template in design-guide.md
  • Design guide appears in all three cross-reference locations (SKILL.md, README.md, create-app.md)
  • No external CDN URLs — all Basecoat assets reference apps.pop.ski/basecoat/

This PR was created by an AI agent (OpenHands) on behalf of peter.

## Summary Adds a UI/UX design guide that establishes **Basecoat UI** as the default component library for all apps on `apps.pop.ski`. Basecoat UI is vendored at `apps.pop.ski/basecoat/` — no external CDN dependency. ## Changes | File | Change | |------|--------| | `references/design-guide.md` | **New** — canonical design guide with integration instructions, starter template, component patterns, layout conventions, typography/colors, and deviation policy | | `references/create-app.md` | Replace bare-bones `index.html` template with Basecoat UI starter template; add link to design guide | | `SKILL.md` | Add `## Design` section; add `design-guide.md` row to References table | | `README.md` | Add `design-guide.md` entry to Contents list | ## Design guide contents - **Integration** — vendored CSS/JS at `apps.pop.ski/basecoat/` (offline on tailnet, no CDN outage risk) - **Starter template** — complete `index.html` with header, nav, card component - **Component patterns** — buttons, forms, cards, alerts, dialogs - **Layout patterns** — app shell, responsive grid, sidebar - **Typography and colors** — Geist Sans/Mono fonts, CSS variable theming, 8 theme packs - **When to deviate** — acceptable cases (custom viz, games, embeds) and responsible practices ## Validation - [x] All internal markdown links resolve to existing files - [x] The `index.html` template in `create-app.md` matches the starter template in `design-guide.md` - [x] Design guide appears in all three cross-reference locations (SKILL.md, README.md, create-app.md) - [x] No external CDN URLs — all Basecoat assets reference `apps.pop.ski/basecoat/` --- *This PR was created by an AI agent (OpenHands) on behalf of peter.*
- Create references/design-guide.md with integration instructions,
  starter template, component patterns, layout conventions, typography
  and color guidance, and deviation policy
- Update references/create-app.md Step 3 template from bare HTML to
  Basecoat UI starter template with design-guide link
- Add Design section and design-guide.md row to SKILL.md References table
- Add design-guide.md entry to README.md Contents list
- Basecoat UI is vendored at apps.pop.ski/basecoat/ (not external CDN)

Co-authored-by: openhands <openhands@all-hands.dev>
peter merged commit 918fd56afe into main 2026-07-05 14:38:34 +00:00
peter deleted branch add-basecoat-design-guide 2026-07-05 14:38:34 +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!1
No description provided.