Repo brief: pmndrs/valtio

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T01:51:35.333Z · commit 0face2ba533a

Verdict

Healthy — Healthy across all four use cases

• Last commit today
• 13 active contributors
• Distributed ownership (top contributor 42% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

Valtio is a lightweight state management library that wraps JavaScript objects in JavaScript Proxies to create reactive, auto-tracking state. It enables mutations to be applied directly to the proxy object (like state.count++) and automatically notifies subscribers of changes, supporting both React (via useSnapshot) and vanilla JavaScript applications. Monorepo structure under src/ with three main entry points: src/index.ts (base exports), src/react.ts (React integration), and src/vanilla.ts (vanilla JS). Utilities are split into src/react/utils/ and src/vanilla/utils/ (containing proxy helpers like deepProxy.ts, proxyMap.ts, proxySet.ts, and devtools integration). Build…

Start here

Read these in order:

• src/vanilla.ts — Foundation: doesn't import anything internally and is imported by 9 other files. Read first to learn the vocabulary.
• examples/todo-with-proxyMap/src/store.ts — Foundation: imported by 4, no internal dependencies of its own.
• src/react.ts — Built on the foundation; imported by 2 downstream files.
• src/vanilla/utils/proxyMap.ts — Built on the foundation; imported by 2 downstream files.
• src/vanilla/utils/deepProxy.ts — Layer 2 — application-level code that wires the lower layers together.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/pmndrs/valtio.git
cd valtio
pnpm install
pnpm run build
pnpm run test

Note: This monorepo uses pnpm (evidenced by pnpm-workspace.yaml and pnpm-lock.yaml) rather than npm or yarn.

Daily commands:

pnpm run build

For development with watch mode: pnpm run build-watch. For tests: pnpm run test. For code quality checks: pnpm run fix:lint and pnpm run fix:format (using Prettier and ESLint with config in eslint.config.mjs).

Key cautions & unknowns

• TypeScript 4.5+ is required (enforced via typesVersions in package.json fallback to ts_version_4.5_and_above_is_required.d.ts). The snapshot returned by useSnapshot is a deeply readonly proxy for safety, but this can…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.