Repository navigation
Conversation
Adds Building apps > Server components, marked as an experimental preview: writing and mounting a server component (query form, dynamicComponent, serverRouteComponent), client components in slots (Slot, slot args, JSX args, $key, asyncArg, behavior on server markup), and keeping server markup fresh (revalidation and single-flight, HTTP caching, liveQuery, broadcast, prerendered). Links the new pages from the glossary, the durable generation guide and the server functions reference index. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0117BoWLiifuXgUvKNu9na8H
|
|
✅ Deploy Preview for solid-docs-v2 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Ryan · project thread
Description(required)
Adds a Building apps › Server components section for the experimental server components preview. Every page carries the experimental framing, and the first page has a caution callout saying the API and wire format are outside Solid 2.0's stability guarantees. Not for merge yet.
New pages:
/building-apps/server-components): enabling withserverFunctions: { components: true }, thequery(async (id) => { "use server"; …; return (props) => <jsx/> }, key)form, mounting withdynamicComponent, what the arguments and props mean, changing the arguments,serverRouteComponent, the trade-offs, and common problems./building-apps/server-components/client-components-in-slots):Slot<Props>, occurrences, reactive slot props, an optimistic toggle in a slot, JSX arguments that wrap server markup, the rule about placing slots as elements rather than calls,$keyon occurrences and on elements,asyncArg, and the three ways to add behavior to server markup./building-apps/server-components/keeping-fresh): revalidation after form mutations (aria-busy), single-flight throughserverFunctions.configure+createFlightDataCollector, HTTP caching throughrespond(),liveQuerylive server components,liveQuery(broadcast(fn))and its capture rule, andprerendered()from@solidjs/prerender.Smaller edits: a glossary entry for Server component, and links from the durable generation callout and the server-functions reference index.
Sources are the
nextbranch of solidjs/solid: RFC 10 (live,broadcast), RFC 11,documentation/server-components/,packages/web/skills/server-components/SKILL.md, the frames typings, the router'sserverRouteComponenttypings (2.0.0-next.44), the@solidjs/prerender0.3.0 README, and thenotes,todos-server,hackernews,chatandserver-dbmonexamples.Checks:
pnpm lint:tonereports no errors.check:examplesreports no errors for the new pages when run against the published rc.21 packages, router next.44 and vite-plugin next.51 (no local checkouts). The examples have not been run in an app; they follow the repo examples, with stand-ins (database,renderMarkdown,inventory,orders) named as such. Per WRITING.md, a maintainer needs to own and run the examples before merge.Related issues & labels
Generated by Claude Code