Skip to content

docs: use renderMode async in the prerender recipe - #1714

Open
VedangP57 wants to merge 1 commit into
solidjs:v2-rebuildfrom
VedangP57:docs/prerender-async-render-mode
Open

VedangP57 wants to merge 1 commit into
solidjs:v2-rebuildfrom
VedangP57:docs/prerender-async-render-mode

Conversation

@VedangP57

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

Description(required)

The prerender recipe in "Choose a rendering mode" uses the default renderMode: "stream". A page whose data is still loading when the shell is ready is then written to dist/client with its Loading fallback in place and the content in a <template> that an inline script swaps in, so crawlers and browsers without JavaScript see the fallback.

This PR sets start: { renderMode: "async" } in the recipe and adds three lines saying why.

Checked on solid-js / @solidjs/web 2.0.3, @solidjs/vite-plugin 3.0.1, prerender-crawler 0.3.0, using the basic --ssr template with a 50 ms wait in its user query. Visible text of the written page without JavaScript:

  • default: Home Users Loading…
  • renderMode: "async": Home Users Users Ada Lovelace First programmer Next user

prettier --check, pnpm lint:tone (0 errors) and pnpm check:types pass.

Related issues & labels

🤖 Generated with Claude Code

@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 Nov 19, 2026

Copy link
Copy Markdown

👷 Deploy request for solid-docs-v2 pending review.

Visit the deploys page to approve it

Name Link
🔨 Latest commit a6bd6e7

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