Type-safe · v4.0

Schemas that grow with your code.

Pothos is a plugin-based GraphQL schema builder for TypeScript. Define your types once and they flow into every resolver without codegen or decorators. At the scale of Airbnb, Netflix, and your weekend project.

Read the guide MIT · open source

schema/user.tsTypeScript

1import SchemaBuilder from '@pothos/core';
2 
3const builder = new SchemaBuilder<{ Context: Context }>();
4 
5// Type the object by its backing model.
6const User = builder.objectRef<{ id: string; name: string }>('User');
7 
8User.implement({
9  fields: (t) => ({
10    id:   t.exposeID('id'),
11    name: t.exposeString('name'),
12    // user and ctx arrive typed — no annotations.
13    posts: t.field({
14      type: [Post],
15      resolve: (user, _args, ctx) => loadPosts(user.id, ctx),
16    }),
17  }),
18});

Where the types come from.

You write two type annotations here: your context on the builder, and the model backing User. In the last resolver, user and ctx are typed from those, without annotations of their own.

0codegen steps

1peer dependency (graphql)

18first-party plugins

The plugin garden