Skip to content

docs: Solid Meta v1 documentation for the 1.0 release - #1616

Open
ryansolid wants to merge 3 commits into
mainfrom
docs/meta-v1
Open

docs: Solid Meta v1 documentation for the 1.0 release#1616
ryansolid wants to merge 3 commits into
mainfrom
docs/meta-v1

Conversation

@ryansolid

Copy link
Copy Markdown
Member

Summary

Adds versioned documentation for @solidjs/meta 1.0, which pairs with Solid 2.0 and was rebuilt as a thin, provider-less layer over the core useHead head registry in @solidjs/web.

Follows the same pattern as the SolidStart v2 docs:

  • New content under src/routes/solid-meta/v1/:
    • Overview with a "Solid Meta 1.0 is for Solid 2.0" callout and version support matrix
    • Getting started (provider-less usage, dedupe/restore semantics, key, automatic SSR)
    • Migrating from 0.x guide (MetaProvider removal, server plumbing removal, new dedupe semantics, useHead shape, removed features)
    • Reference pages for Title, Meta, Link, Stylesheet, Style, Script, Base, plus the new <Head> group component and the useHead escape hatch
  • vite.config.ts: adds a v1 value to the version axis, includes meta for ["latest", "v1"], filters v1 out of the latest Meta sidebar, and adds a sidebar override for /solid-meta/v1 — Meta pages now get a Latest/v1 version switcher like Solid and Start
  • Adds a reciprocal note on the latest (0.29.x) Meta overview pointing Solid 2.0 users at the v1 docs

Test plan

  • vite dev renders /solid-meta/v1 with its own Learn/Reference sidebar
  • Version switcher on Meta pages shows Latest/v1 and navigates between them
  • All 9 reference pages render; internal links use /solid-meta/v1/... paths
  • Latest Meta docs unaffected apart from the new cross-link note

Made with Cursor

Solid Meta 1.0 (for Solid 2.0) is provider-less and built on the core
useHead registry, so its docs get a versioned section following the
same pattern as SolidStart v2: content under src/routes/solid-meta/v1
with a v1 entry on the version axis, its own sidebar, and a Latest/v1
switcher on Meta pages. Covers getting started, a 0.x migration guide,
and reference pages for all components including the new <Head> groups,
<Script>, and the useHead escape hatch, with cross-links between the
0.x and 1.x overviews.

Co-authored-by: Cursor <cursoragent@cursor.com>
@bolt-new-by-stackblitz

Copy link
Copy Markdown

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@netlify

netlify Bot commented Aug 5, 2026

Copy link
Copy Markdown

Deploy Preview for solid-docs ready!

Name Link
🔨 Latest commit 6581190
🔍 Latest deploy log https://app.netlify.com/projects/solid-docs/deploys/6a7395a020585d0008edc349
😎 Deploy Preview https://deploy-preview-1616--solid-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

autofix-ci Bot and others added 2 commits August 5, 2026 19:20
@solidjs/meta 1.0 no longer re-exports useHead, so the meta v1 reference
documents components only; the migration guide now points useHead callers
at the core import from @solidjs/web.

Co-authored-by: Cursor <cursoragent@cursor.com>
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