Skip to content

Updated Client Side Notes for Astro #294

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AlexanderKaran merged 2 commits into from
Jul 15, 2026
+7 −5
Merged

Updated Client Side Notes for Astro #294

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
089f1ae
Updated Client Side Notes for Astro
AlexanderKaran Jul 14, 2026
efa97f8
Wording tweaks
AlexanderKaran Jul 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions packages/docs/src/content/docs/methodology.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -115,19 +115,19 @@ throughput, and load behavior for comparable production apps.
- Interaction to Next Paint is measured by clicking the first row's detail link
and waiting for the detail view.
- Benchmarks run 5 times by default and average successful metrics.
- Client-side rendered tests use each framework's normal production build
because SPA-only build modes are not supported consistently across the
compared frameworks.
- Next.js wraps the client-side rendered table in a `dynamic` import with
`ssr: false` to prevent build-time prerendering.
- TanStack Start, Nuxt, SvelteKit, and SolidStart disable SSR per route.
- React Router uses route-level `clientLoader` functions with `HydrateFallback`
so the client-rendered routes are not server-rendered.
- Astro uses client-only React islands for client-side rendered routes.
- Client-side rendered tests use each framework's normal production build
because SPA-only build modes are not supported consistently across the
compared frameworks.
- Astro's benchmark table and detail components are React islands rendered with
`client:only="react"`. Astro's `ClientRouter` is not used for this test
because it changes navigation behavior rather than making components
client-only.
client-only. Using `client:only` is often considered an anti pattern in Astro but needed to make the tests fair and measure just client side performance.
- We also chose React for Astro as its the currently the most popular. 23% of projects according to the Astro team as of writing this (15/07/2026).

### Server Side Rendered Tests

Expand Down
2 changes: 2 additions & 0 deletions packages/docs/src/content/docs/run-time.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,8 @@ import SSRRequestThroughputStatsTable from '../../components/SSRRequestThroughpu

Methodology: [Client Side Rendered Tests](/methodology/#client-side-rendered-tests).

Some frameworks have been moved off their golden path to make client side tests fair when comparing. See the methodology link above for the full details.

<ClientSideRenderedStatsTable />
<ClientSideRenderedCharts />

Expand Down
Loading