Skip to content

docs(website): add the comparison page - #235

Merged
dangreen merged 6 commits into
docs/changes-since-1.2.0from
docs/comparison-page
Oct 21, 2026
Merged

dangreen merged 6 commits into
docs/changes-since-1.2.0from
docs/comparison-page

Conversation

@dangreen

@dangreen dangreen commented Sep 6, 2026

Copy link
Copy Markdown
Member

Draft. Stacked on #234: the base is chore/effect-benchmark-refresh, so this diff shows only the comparison page; GitHub retargets it to main once that PR merges.

What

New getting-started/comparison page, second item in Getting Started, with the Introduction pinned first in the sidebar.

  • Store layer: Nano Stores, Zustand, Jotai. Feature table, size table, then Nano Kit vs … for each.
  • Query layer: @nanostores/query, TanStack Query. Same structure.
  • Router layer: @nanostores/router, TanStack Router. Same structure, plus three @nano_kit/router import sets so the TanStack row compares like for like.
  • Trade-offs: what Nano Kit gives up today and what it gives back for it.

Numbers

Sizes: Vite 8.2.1 with rolldown 1.2.7, app build of one entry that imports the listed names, default minifier, ES2022, gzip level 9, versions listed in the note at the top of the page. Benchmark figures quoted in the text come from the tables refreshed in the base PR.

Every claim about another library was checked against that library's README or exports; every size claim is tied to the measured import set.

@codecov

codecov Bot commented Sep 6, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.62%. Comparing base (6f0e95d) to head (8b9c9f7).

Additional details and impacted files
@@                    Coverage Diff                    @@
##           docs/changes-since-1.2.0     #235   +/-   ##
=========================================================
  Coverage                     83.62%   83.62%           
=========================================================
  Files                           228      228           
  Lines                          4849     4849           
  Branches                       1074     1074           
=========================================================
  Hits                           4055     4055           
  Misses                          553      553           
  Partials                        241      241           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Base automatically changed from chore/effect-benchmark-refresh to main September 6, 2026 12:56
@dangreen
dangreen force-pushed the docs/comparison-page branch from 5cde938 to 99bf541 Compare September 27, 2026 08:10
@dangreen
dangreen force-pushed the docs/comparison-page branch from 99bf541 to c83f9fc Compare September 28, 2026 14:11
@dangreen
dangreen changed the base branch from main to docs/changes-since-1.2.0 September 28, 2026 14:11
@dangreen
dangreen added this pull request to stack #272 September 28, 2026 14:44
@dangreen
dangreen force-pushed the docs/comparison-page branch 2 times, most recently from 6cd587f to 59aa04e Compare October 7, 2026 16:07
@dangreen
dangreen marked this pull request as ready for review October 21, 2026 11:20
@dangreen
dangreen force-pushed the docs/comparison-page branch from 59aa04e to 74bf3fa Compare October 21, 2026 11:30
Nano Kit next to Nano Stores, Zustand, Jotai, TanStack Query, TanStack Router and the `@nanostores` packages: feature tables per layer, sizes measured with Vite 8.2.1 and rolldown 1.2.7, and a "Nano Kit vs" section for every library in the tables. The page sits right after the Introduction in Getting Started.
… link `hydratable()` in its SSR rows

Stacked on the docs update, Agent Skills shared `order: 2` with the comparison page and came first by name: it moves to 3 and keeps the Store label of the pager, which the comparison page no longer needs. The `ssr()` setting and its section are gone since #222, so the SSR hydration row and the `@nanostores/query` section link `hydratable()` instead.
The three DevTools mentions pointed at the package on GitHub while the docs had no page for it; they now link the DevTools page of the Store section.
… the fix of a revalidation in flight

The `@nano_kit/query` sets grow by 13 B minified: 10.28 and 11.32 kB, and 17.75 kB and 6.80 kB gzipped with the router. The store and router sets measure the same as before. The Rick and Morty numbers in the text follow the examples table, and the note on top dates the new measurement of the `@nano_kit/*` rows.
@dangreen
dangreen force-pushed the docs/comparison-page branch from 74bf3fa to 8b9c9f7 Compare October 21, 2026 11:46
@dangreen
dangreen merged commit b15de74 into main Oct 21, 2026
19 checks passed
@dangreen
dangreen deleted the docs/comparison-page branch October 21, 2026 11:49
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