Run the 2.0 docs site on Solid 2 and add interactive tutorials by ryansolid · Pull Request #1670 · solidjs/solid-docs

ryansolid · 2026-10-27T16:56:43Z

I have read the Contribution guide
This PR references an issue (except for typos, broken links, or other minor problems)

Description(required)

Spike, do not merge. This moves the v2-rebuild site from solid-js 1.9 with SolidStart onto Solid 2. The goal is to host interactive tutorials on the docs site and to find bugs in the Solid 2 ecosystem along the way.

Stack:

solid-js and @solidjs/web 2.0.0-rc.18, @solidjs/router 2.0.0-next.42, @solidjs/meta 1.0.0-next.2
@kobalte/core 2.0.0-alpha.4
SolidBase from Solid 2: port to solid-js 2 + @solidjs/vite-plugin start mode (SSG, router 2, meta 1.0) kobaltedev/solidbase#174. It uses @solidjs/vite-plugin start mode with its own prerender, so SolidStart, Nitro and the entry files are gone, and the site deploys from dist/client.

Code changes:

Solid 2 API renames throughout: Errored, Loading, onSettled, omit/merge, class arrays, For keyed={false}, split effects, and async createMemo.
solid-heroicons and solid-list only support Solid 1. They are replaced with ~icons/heroicons/* and a small local createList.
The noindex _headers file for non-production hosts is now written by a small Vite plugin.

Temporary pieces (to swap out before any merge):

spike/ vendors two local builds: SolidBase Lifecycles [API Reference] #174 and fix(convention): map group-prefixed index files like (0)index to their directory filesystem-routing#36. Without Add missing exports to AddBook #36, the (0)index pages map to /index, so / and the section index pages 404.
minimumReleaseAge is set to 0 so Kobalte alpha.4 and seroval 1.7 can install.

Verified locally:

All 273 pages prerender, and the production build hydrates cleanly with no console errors.
Click-tested sidebar tabs, navigation (including back), the theme selector, code tabs, mobile nav, and search (against a mocked Orama response).
check:types and check:lint pass.

Notes:

The remaining dev warnings come from effects inside Kobalte alpha.4 (Tabs and Dialog).
Hydration hazard: a primitive called only under if (!isServer) shifts hydration ids for everything after it, so every page mismatched until I fixed that call.

Related issues & labels

Suggested label(s) (optional): spike

Generated by Claude Code

…rt mode) Replace SolidStart + Nitro with @solidjs/vite-plugin start mode and SolidBase's own prerender; port the osmium theme to Solid 2 APIs (Errored, Loading, onSettled, omit/merge, class arrays, For keyed={false}, clientOnly from @solidjs/web), swap solid-heroicons and solid-list for ~icons/heroicons and a local list helper. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

- Track route changes in the sidebar tab with a derived signal (drops useBeforeLeave). - Stop destructuring useLocale() (its getters are memos). - untrack initial/fixed reads in TabGroup and search rows; untrack preload in the effect. - Vendor the SolidBase #174 and filesystem-routing #36 builds under spike/. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

bolt-new-by-stackblitz · 2026-10-27T16:56:47Z

Run & review this pull request in StackBlitz Codeflow.

netlify · 2026-10-27T16:57:01Z

✅ Deploy Preview for solid-docs-v2 ready!

Name	Link
🔨 Latest commit	`f10ecac`
🔍 Latest deploy log	https://app.netlify.com/projects/solid-docs-v2/deploys/6ae3a87592e352bf7f7a2775
😎 Deploy Preview	https://deploy-preview-1670--solid-docs-v2.netlify.app
📱 Preview on mobile	Toggle 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.

socket-security · 2026-10-27T16:57:25Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Package	Supply Chain Security	Quality	Maintenance	License
@solid-primitives/marker@0.2.2 ⏵ 2.0.0-next.4		⁺¹	⁺⁶
solid-repl@1.0.1
@iconify-json/heroicons@1.2.3
@kobalte/solidbase@0.6.13 ⏵ 2.0.0	⁺¹²	⁺¹	^-3
@solidjs/web@2.0.0-rc.20
@kobalte/core@0.13.12 ⏵ 2.0.0-alpha.4		⁺³	⁺¹²	⁺²⁰
@solid-primitives/platform@0.2.1 ⏵ 1.0.0-next.4	⁺¹⁴	⁺¹	⁺⁷
@solid-primitives/context@0.3.2 ⏵ 2.0.0-next.4	⁺¹	⁺¹	⁺²
@solidjs/meta@0.29.4 ⏵ 1.0.0-next.2	⁺¹		⁺¹⁰
@solid-primitives/storage@4.4.0 ⏵ 5.0.0-next.7	⁺¹		^-1
@solid-primitives/event-listener@2.4.6 ⏵ 3.0.0-next.9			⁺¹
solid-js@1.9.14 ⏵ 2.0.0-rc.20		^-5	⁺¹
@solidjs/vite-plugin@3.0.0-next.51
@solidjs/router@1.0.0 ⏵ 2.0.0-next.42	⁺¹		⁺²

View full report

socket-security · 2026-10-27T16:57:27Z

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Priority	Alert (click "▶" to expand/collapse)	Action
	Low adoption: npm `@solid-primitives/a11y` Location: Package overview From: pnpm-lock.yaml → `npm/@kobalte/core@2.0.0-alpha.4` → `npm/@solid-primitives/a11y@1.0.0-next.3` ℹ Read more on: This package \| This alert \| What are unpopular packages? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at `support@socket.dev`. Suggestion: Unpopular packages may have less maintenance and contain other problems. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment `@SocketSecurity ignore npm/@solid-primitives/a11y@1.0.0-next.3`. You can also ignore all packages with `@SocketSecurity ignore-all`. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.	Warn
	Low adoption: npm `@solid-primitives/controlled-signal` Location: Package overview From: pnpm-lock.yaml → `npm/@kobalte/core@2.0.0-alpha.4` → `npm/@solid-primitives/controlled-signal@1.0.0-next.3` ℹ Read more on: This package \| This alert \| What are unpopular packages? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at `support@socket.dev`. Suggestion: Unpopular packages may have less maintenance and contain other problems. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment `@SocketSecurity ignore npm/@solid-primitives/controlled-signal@1.0.0-next.3`. You can also ignore all packages with `@SocketSecurity ignore-all`. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.	Warn
	Low adoption: npm `@solid-primitives/focus` Location: Package overview From: pnpm-lock.yaml → `npm/@kobalte/core@2.0.0-alpha.4` → `npm/@solid-primitives/focus@1.0.0-next.4` ℹ Read more on: This package \| This alert \| What are unpopular packages? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at `support@socket.dev`. Suggestion: Unpopular packages may have less maintenance and contain other problems. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment `@SocketSecurity ignore npm/@solid-primitives/focus@1.0.0-next.4`. You can also ignore all packages with `@SocketSecurity ignore-all`. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.	Warn

View full report

Dev's 42-lesson Solid 2 curriculum (devagrawal09/solid-site codex/solid-v2) rendered with the playground's solid-repl (solid-playground#201, vendored build under spike/). - Lesson text loads as lazy() components and the files as plain data, so the prerendered page hydrates without refetching. - solidjs.com lesson ids redirect through a generated _redirects file. - The REPL workers skip re-minification: minifying the prebuilt TypeScript worker again breaks its initialization order. - Header gets a Tutorial link; the layout goes full-bleed under /tutorial. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

- Router 2 preloads links only when asked; restore SolidStart's hover/focus preload with intentPreload(). Page chunks match the Solid 1 build. - The REPL's Panda layers were declared after Tailwind's, so its reset beat Tailwind utilities (the Solve button and docs pages lost their padding once the tutorial loaded). Declare the layer order up front. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

SolidBase 2.0.0 (kobaltedev/solidbase#174) replaces the vendored build. It pins @solidjs/router 2.0.0-next.37, so an override keeps the site on one router copy (next.42). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

Introduction (JSX and components before signals), Components, Stores, Async, Mutations, then Effects and the DOM. Each starter shows a visible problem the lesson's API fixes. New lessons: projections, streams, optimistic stores, until. Former lesson ids alias to their new lesson. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

…console shows The REPL only opens the entry file, so lesson files like card.jsx stayed hidden, also after Solve. Remount the REPL per lesson and on Solve/Reset with a layout that opens all files. The playground console (chobitsu) does not forward console.count, so the memos and projections lessons log with console.log instead; projections now reports how many rows re-checked per click. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

States load, cities load for the selected state, and the selected city derives from the city list. Shows async writable derived state, a held update that never tears the selection line, and isPending on the dependent control. Course is now 35 lessons. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

esm.sh serves production builds unless a URL asks for dev, so lessons that point at a dev warning (props, loading, optimistic stores) showed nothing. The REPL wrapper now seeds a pinned import map with the dev builds of solid-js, solid-js/internal and @solidjs/web. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

solid-js/internal imports "solid-js" itself. Without marking it external, esm.sh bundled its own copy, so the page ran two Solid runtimes and the dev build warned about multiple instances. The playground's default import map has the same gap. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

Drops the vendored solid-repl tarball and the import-map workaround now that the playground externalizes solid-js and serves dev builds itself. Pins one Solid runtime for the site and its Solid 2 libraries. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

Picks up the fix for the action + refresh + isPending loop (#4349), which the Actions lesson's solution hit on rc.19. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

solid-repl resolves extensionless imports to jsx tabs only, so the .js helper files in two lessons failed to import. From #1672. Co-authored-by: Brenley Dueck <brenleydueck@gmail.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

SolidBase marks dark mode with data-theme, but the REPL's dark styles need a .dark class on an ancestor, so its panels stayed light. From #1671. Co-authored-by: Brenley Dueck <brenleydueck@gmail.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

claude added 3 commits October 27, 2026 15:48

spike: prettier

b7812ae

ryansolid self-assigned this Oct 27, 2026

autofix-ci Bot and others added 9 commits October 27, 2026 16:57

ci: apply automated fixes

e93231d

ci: apply automated fixes

0600dcf

spike: prettier the lockfile

30e0101

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

spike: use published filesystem-routing 0.4.2

98115f8

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

spike: narrower lesson pane, stack the editor over the preview

dc79d82

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

spike: restore the lesson pane width now the editor stacks

4c8814f

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

brenelz mentioned this pull request Oct 27, 2026

[spike] Give the tutorial REPL its dark theme #1671

Closed

1 of 2 tasks

claude added 4 commits October 27, 2026 22:11

brenelz mentioned this pull request Oct 28, 2026

[spike] Fix ./server and ./api imports in two tutorial lessons #1672

Closed

ryansolid mentioned this pull request Oct 28, 2026

docs: from(), onFlush, hydration handoff, broadcast and other 2.0 gaps since rc.15 #1674

Merged

claude added 3 commits October 28, 2026 04:29

tutorial: bump Solid to rc.20

3d0dbca

Picks up the fix for the action + refresh + isPending loop (#4349), which the Actions lesson's solution hit on rc.19. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWPLXmEUSKddsQSHkzN

ryansolid marked this pull request as ready for review October 29, 2026 20:09

ryansolid changed the title ~~[spike] Run the 2.0 docs site on Solid 2~~ Run the 2.0 docs site on Solid 2 and add interactive tutorials Oct 29, 2026

ryansolid merged commit e7f3d56 into v2-rebuild Oct 29, 2026
7 of 8 checks passed

ryansolid deleted the claude/project-thread-fpqdr5 branch October 29, 2026 20:11

Navigation Menu

Repository navigation

Run the 2.0 docs site on Solid 2 and add interactive tutorials - #1670

Run the 2.0 docs site on Solid 2 and add interactive tutorials#1670
ryansolid merged 21 commits into
v2-rebuildfrom
claude/project-thread-fpqdr5

ryansolid commented Oct 27, 2026

Uh oh!

bolt-new-by-stackblitz Bot commented Oct 27, 2026

Uh oh!

netlify Bot commented Oct 27, 2026 •

edited

Loading

Uh oh!

socket-security Bot commented Oct 27, 2026 •

edited

Loading

Uh oh!

socket-security Bot commented Oct 27, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ryansolid commented Oct 27, 2026

Description(required)

Related issues & labels

Uh oh!

bolt-new-by-stackblitz Bot commented Oct 27, 2026

Uh oh!

netlify Bot commented Oct 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for solid-docs-v2 ready!

Uh oh!

socket-security Bot commented Oct 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

socket-security Bot commented Oct 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

netlify Bot commented Oct 27, 2026 •

edited

Loading

socket-security Bot commented Oct 27, 2026 •

edited

Loading

socket-security Bot commented Oct 27, 2026 •

edited

Loading