Skip to content

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

Draft
dangreen wants to merge 4 commits into
docs/changes-since-1.2.0from
docs/comparison-page
Draft

dangreen wants to merge 4 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 85.79%. Comparing base (52a147b) to head (c510505).

Additional details and impacted files
@@                    Coverage Diff                    @@
##           docs/changes-since-1.2.0     #235   +/-   ##
=========================================================
  Coverage                     85.79%   85.79%           
=========================================================
  Files                           166      166           
  Lines                          3766     3766           
  Branches                        871      871           
=========================================================
  Hits                           3231     3231           
  Misses                          358      358           
  Partials                        177      177           

☔ 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
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.
@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
… 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.
@dangreen
dangreen added this pull request to stack #272 September 28, 2026 14:44

This branch has not been deployed

No deployments
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