Migrations

Each major Pothos release has a migration guide covering its breaking changes and the options you can set to keep the previous behavior. Pick the guide for the version you are upgrading from:

• 3.* to (4.0)
• GiraphQL (2.*) to Pothos (3.0)
• 1.* to 2.0

Migrating to Pothos from other GraphQL libraries

Official migration tooling is still in progress. For now, a few third-party tools can help with incremental migration from common setups.

• Nexus to Pothos codemod

  This third-party codemod transforms nexus types, queries, and mutations into their Pothos equivalents. It still needs some manual adjustments to get everything working correctly, but it does much of the mechanical work.

• Pothos Generator

  This is an undocumented CLI that converts a schema into valid Pothos code. Resolvers are all placeholders that throw, so it is most useful for generating input types rather than a complete migration.