Skip to content

Rebuild the playground as the better-content intro site - #1

Merged
Invalid8 merged 1 commit into
mainfrom
playground-intro-site
Sep 7, 2026
Merged

Invalid8 merged 1 commit into
mainfrom
playground-intro-site

Conversation

@Invalid8

@Invalid8 Invalid8 commented Sep 7, 2026

Copy link
Copy Markdown
Owner

Drop the "playground" framing. The page now introduces better-content and happens to be editable, rather than presenting itself as a demo annexe.

Palette is derived from logo.svg instead of the inherited warm paper: white ground, #20242b ink, #71767f muted, and #ffe24a as the marker. Yellow is only ever a background with dark text on it, never a text colour.

Header is a three column grid so the nav sits on the true centre regardless of what the actions weigh. Actions swap between reading and editing off html.editing-on, with the keyboard shortcuts wired.

Edit affordances are scoped to hover and focus. Entering edit mode no longer tints, outlines or reflows anything.

Structure:

  • Toolbar.astro becomes SiteHeader.astro, Base.astro gains the real footer
  • PreviewFrame splits into HeroIsland, RowsIsland and NoteIsland
  • Vue and Svelte render NoteCard directly, so all three bindings show the same row
  • index.astro becomes hero plus five numbered sections
  • the adapter switch moves onto the database panel, where its effect shows

Performance: PGlite was constructed at module scope in db.ts, so 16 MB of Postgres wasm downloaded on every visit including the adapters that never touch it. Schema, DDL and client move to lib/pgliteAdapter.ts behind a dynamic import in loadAdapter(). Initial JS is now 68 KB gzipped.

Loading states carry no copy. The hero and database rows render shimmering skeletons instead of hardcoded seed text, which was flashing stale content for anyone whose rows had been edited.

The page table gains a tagline column, with ALTER TABLE in the DDL.

Drop the "playground" framing. The page now introduces better-content and
happens to be editable, rather than presenting itself as a demo annexe.

Palette is derived from logo.svg instead of the inherited warm paper: white
ground, #20242b ink, #71767f muted, and #ffe24a as the marker. Yellow is only
ever a background with dark text on it, never a text colour.

Header is a three column grid so the nav sits on the true centre regardless of
what the actions weigh. Actions swap between reading and editing off
html.editing-on, with the keyboard shortcuts wired.

Edit affordances are scoped to hover and focus. Entering edit mode no longer
tints, outlines or reflows anything.

Structure:
- Toolbar.astro becomes SiteHeader.astro, Base.astro gains the real footer
- PreviewFrame splits into HeroIsland, RowsIsland and NoteIsland
- Vue and Svelte render NoteCard directly, so all three bindings show the
  same row
- index.astro becomes hero plus five numbered sections
- the adapter switch moves onto the database panel, where its effect shows

Performance: PGlite was constructed at module scope in db.ts, so 16 MB of
Postgres wasm downloaded on every visit including the adapters that never
touch it. Schema, DDL and client move to lib/pgliteAdapter.ts behind a dynamic
import in loadAdapter(). Initial JS is now 68 KB gzipped.

Loading states carry no copy. The hero and database rows render shimmering
skeletons instead of hardcoded seed text, which was flashing stale content for
anyone whose rows had been edited.

The page table gains a tagline column, with ALTER TABLE in the DDL.
@vercel

vercel Bot commented Sep 7, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
better-content-docs Ready Ready Preview Sep 7, 2026 6:31pm UTC

@Invalid8
Invalid8 merged commit b39202d into main Sep 7, 2026
4 checks passed
@Invalid8
Invalid8 deleted the playground-intro-site branch September 7, 2026 18:33

This branch was successfully deployed

1 active deployment
Preview – better-content-docs ca85587c Deployed Sep 7, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant