Skip to content

docs: add Nexus to GQLoom migration guide (en, zh) - #432

Merged
xcfox merged 3 commits into
mainfrom
cursor/nexus-migration-guide-bd26
Nov 18, 2026
Merged

xcfox merged 3 commits into
mainfrom
cursor/nexus-migration-guide-bd26

Conversation

@xcfox

@xcfox xcfox commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

Add English and Chinese Nexus → GQLoom migration guides and wire them into both VitePress sidebars.

Summary

  • Add website/docs/migrations/from-nexus.md and website/zh/docs/migrations/from-nexus.md following the migration guide layout:
    • Opening sections: Why GQLoom (architecture-level comparison emphasizing GQLoom's strengths with minimal low-level detail), Overview and mental model, and Concept map (tailored specifically to Nexus APIs and plugins).
    • Full-migration rules and concrete GQLoom migration paths for every Nexus feature—including objectType, inputObjectType, enumType, unionType, nonNullDefaults / list wrapping, extendType, subscriptionType, fieldAuthorizePlugin, nexus-prisma / nexus-plugin-prisma (t.model.*, t.crud.*, computedInputs), DataLoader, interfaceType (GraphQLInterfaceType shared silk vs. z.discriminatedUnion with client adaptation notes), connectionPlugin, nullabilityGuardPlugin, queryComplexityPlugin, and custom plugins—with zero "keep Nexus" fallback rules.
    • Gotchas, SDL/request-replay verification, a 1:1 port of the official Nexus Getting Started blog API, and cleanup instructions.
  • Wire both guides into website/.vitepress/sidebar-en.js and website/.vitepress/sidebar-zh.js under Migrations / 迁移.

Verification

  • pnpm --filter website build (including Twoslash type-checking and dead-link checks across all pages)
  • pnpm --filter website check:type (tsgo --noEmit across root, home-drizzle, home-mikro)
  • pnpm run check (biome check + pnpm -r check:type) and pnpm run test --watch=false (69 test files passed, 1220 tests passed; 2 MySQL/Postgres suites skipped without local DB servers)
  • Reference port SDL parity and 5 replayed GraphQL operations verified against nexus@1.3.0 and local @gqloom/core + @gqloom/zod.
Open in Web Open in Cursor 

@xcfox
xcfox merged commit 685ada4 into main Nov 18, 2026
5 checks passed
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.

2 participants