GQLens

GQLens is a demand-first GraphQL client for React and Solid. Generated accessors feed QuerySession scopes; each scope plans, caches, and fetches its own selection.

pnpm add @gqlens/core @gqlens/react
pnpm add -D @gqlens/vite graphql

Use @gqlens/solid instead of @gqlens/react for Solid.

Read next:

• Vite codegen best practices
• Yoga + Vite example
• API syntax spec
• Framework adapters
• Schema design guide

Development

pnpm install
pnpm run verify
pnpm run build

Release

GQLens keeps all @gqlens/* packages on one major.minor release line. Patch releases only need to include the packages that changed; minor and major releases should include every public package so they converge on the same next release line.

pnpm changeset
pnpm run release:version
pnpm run release:publish

Dependency catalogs

Development and runtime dependency versions are managed with pncat in the root pnpm-workspace.yaml. Run pnpm catalog:migrate to migrate declarations and pnpm install to update the lockfile. pnpm catalog:detect reports migration candidates; upstream detection does not fail the command when candidates exist. Published peer ranges remain compatibility declarations. Packages and the Yoga/Vite example share this workspace and lockfile. Each package keeps its direct dependency declarations. When these packages are explicit members of a parent workspace, that workspace supplies the same named catalogs and selects their installed versions.