Type Graphql

Create GraphQL schema and resolvers with TypeScript, using classes and decorators!
Alternatives To Type Graphql
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Type Graphql7,847277378a day ago69May 16, 2023111mitTypeScript
Create GraphQL schema and resolvers with TypeScript, using classes and decorators!
Typegoose1,234121472 years ago50September 06, 201914mitTypeScript
Typegoose - Define Mongoose models using TypeScript classes.
Typegraphql Prisma783122 months ago77July 09, 202254mitTypeScript
Prisma generator to emit TypeGraphQL types and CRUD resolvers from your Prisma schema
Serializr7221053310 months ago35December 17, 202033mitTypeScript
Serialize and deserialize complex object graphs to and from JSON and Javascript classes
Typegql3991164 years ago22March 27, 201917mitTypeScript
Create GraphQL schema with TypeScript classes.
Morphism398582 years ago53May 03, 202022mitTypeScript
⚡ Type-safe data transformer for JavaScript, TypeScript & Node.js.
Warthog347142 years ago220January 16, 202241mitTypeScript
GraphQL API Framework with strong conventions and auto-generated schema
Routing Controllers Openapi27010249 months ago23July 24, 202141mitTypeScript
Runtime OpenAPI v3 schema generation for routing-controllers.
Joiful22811210 months ago17April 24, 202131TypeScript
TypeScript Declarative Validation for Joi
Aiohttp Apispec2051485 months ago60March 01, 202228mitPython
Build and document REST APIs with aiohttp and apispec
Alternatives To Type Graphql
Select To Compare

Alternative Project Comparisons

GraphQL Conf 2023



release website codeql npm version codecov open collective install size

Create GraphQL schema and resolvers with TypeScript, using classes and decorators!




TypeGraphQL makes developing GraphQL APIs an enjoyable process, i.e. by defining the schema using only classes and a bit of decorator magic.

So, to create types like object type or input type, we use a kind of DTO class. For example, to declare Recipe type we simply create a class and annotate it with decorators:

class Recipe {
  @Field(type => ID)
  id: string;

  title: string;

  @Field(type => [Rate])
  ratings: Rate[];

  @Field({ nullable: true })
  averageRating?: number;

And we get the corresponding part of the schema in SDL:

type Recipe {
  id: ID!
  title: String!
  ratings: [Rate!]!
  averageRating: Float

Then we can create queries, mutations and field resolvers. For this purpose, we use controller-like classes that are called "resolvers" by convention. We can also use awesome features like dependency injection and auth guards:

class RecipeResolver {
  // dependency injection
  constructor(private recipeService: RecipeService) {}

  @Query(returns => [Recipe])
  recipes() {
    return this.recipeService.findAll();

  @Authorized(Roles.Admin) // auth guard
  removeRecipe(@Arg("id") id: string): boolean {
    return this.recipeService.removeById(id);

  averageRating(@Root() recipe: Recipe) {
    return recipe.ratings.reduce((a, b) => a + b, 0) / recipe.ratings.length;

And in this simple way, we get this part of the schema in SDL:

type Query {
  recipes: [Recipe!]!

type Mutation {
  removeRecipe(id: String!): Boolean!


We all know that GraphQL is great and solves many problems we have with REST APIs, like Over-Fetching and Under-Fetching. But developing a GraphQL API in Node.js with TypeScript is sometimes a bit of a pain. Why? Let's take a look at the steps we usually have to take.

First, we create all the GraphQL types in schema.graphql using SDL. Then we create our data models using ORM classes, which represent our DB entities. Then we start to write resolvers for our queries, mutations and fields, but this forces us to first create TS interfaces for all arguments, inputs, and even object types.

Only then can we implement the resolvers using weird generic signatures and manually performing common tasks, like validation, authorization and loading dependencies:

export const getRecipesResolver: GraphQLFieldResolver<void, Context, GetRecipesArgs> = async (
) => {
  // common tasks repeatable for almost every resolver
  const repository = TypeORM.getRepository(Recipe);
  const auth = Container.get(AuthService);
  await joi.validate(getRecipesSchema, args);
  if (!auth.check(ctx.user)) {
    throw new NotAuthorizedError();

  // our business logic, e.g.:
  return repository.find({ skip: args.offset, take: args.limit });

The biggest problem is redundancy in our codebase, which makes it difficult to keep things in sync. To add a new field to our entity, we have to jump through all the files - modify an entity class, the schema, as well as the interface. The same goes for inputs or arguments. It's easy to forget to update one piece or make a mistake with a single type. Also, what if we've made a typo in the field name? The rename feature (F2) won't work correctly.

Tools like GraphQL Code Generator or graphqlgen only solve the first part - they generate the corresponding interfaces (and resolvers skeletons) for our GraphQL schema but they don't fix the schema <--> models redundancy and developer experience (F2 rename won't work, you have to remember about the codegen watch task in the background, etc.), as well as common tasks like validation, authorization, etc.

TypeGraphQL comes to address these issues, based on experience from a few years of developing GraphQL APIs in TypeScript. The main idea is to have only one source of truth by defining the schema using classes and some help from decorators. Additional features like dependency injection, validation and auth guards help with common tasks that normally we would have to handle ourselves.


The documentation, installation guide, and detailed description of the API and all of its features are available on the website.

Getting started

A full getting started guide with a simple walkthrough (tutorial) can be found at getting started docs.

Video tutorial

If you prefer video tutorials, you can watch Ben Awad's TypeGraphQL video series on YouTube.


You can also check the examples folder in this repository for more examples of usage: simple fields resolvers, DI Container support, TypeORM integration, automatic validation, etc.

The Tests folder might also give you some tips on how to get various things done.

Security contact information

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

The future

The currently released version is a stable 1.0.0 release. It is well-tested (97% coverage, ~500 test cases) and has most of the planned features already implemented. Plenty of companies and independent developers are using it in production with success.

However, there are also plans for a lot more features like better TypeORM, Prisma and DataLoader integration, custom decorators and metadata annotations support - the full list of ideas is available on the GitHub repo. You can also keep track of development's progress on the project board.

If you have any interesting feature requests, feel free to open an issue on GitHub so we can discuss that!


TypeGraphQL is an MIT-licensed open-source project. This framework is a result of the tremendous amount of work - sleepless nights, busy evenings and weekends.

It doesn't have a large company that sits behind it - its ongoing development is possible only thanks to the support of the community.


Gold Sponsors 🏆

Please ask your company to support this open source project by becoming a gold sponsor and getting a premium technical support from our core contributors.

Silver Sponsors 🥈

Please ask your company to support this open source project by becoming a silver sponsor.

Bronze Sponsors 🥉

live graphic systems lifeX aps instinctools vps server
Live Graphic Systems LifeX Aps instinctools VPS Server

become a sponsor

Members 💪


GitHub Sponsors

GitHub Sponsors

Want to help?

Want to file a bug, contribute some code, or improve the documentation? Great! Please read our guidelines for CONTRIBUTING and then check out one of our help-wanted issues.

Popular Decorators Projects
Popular Schema Projects
Popular Libraries Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Graphql Schema
Graphql Js