The modern
GraphQL platform

Swiftly design and ship best-practice GraphQL backends atop existing data sources and APIs.

Setup the Tailcall instantly via npm and unlock the power of high-performance API orchestration.

To dive deeper into Tailcall checkout our docs for detailed tutorials. Ideal for devs at any level, it's packed with advanced tips, powerful operators and best practices.

npm i -g @tailcallhq/tailcall

graphql
yaml
json

schema
  @server(port: 8000)
  @upstream(baseURL: "http://jsonplaceholder.typicode.com") {
  query: Query
}

type Query {
  users: [User] @http(path: "/users")
  posts: [Post] @http(path: "/posts")
}

type User {
  id: Int!
  name: String!
  username: String!
  email: String!
}


type Post {
  id: Int!
  title: String!
  body: String!
  userId: Int!

  # Expand a post with user information
  user: User @http(path: "/users/{{.value.userId}}")
}

tailcall start ./app.graphql

server:
  port: 8000
upstream:
  baseURL: http://jsonplaceholder.typicode.com
schema:
  query: Query
types:
  Post:
    fields:
      body:
        type: String
        required: true
        cache: null
      id:
        type: Int
        required: true
        cache: null
      title:
        type: String
        required: true
        cache: null
      user:
        type: User
        http:
          path: /users/{{.value.userId}}
        cache: null
      userId:
        type: Int
        required: true
        cache: null
    cache: null
  Query:
    fields:
      posts:
        type: Post
        list: true
        http:
          path: /posts
        cache: null
      users:
        type: User
        list: true
        http:
          path: /users
        cache: null
    cache: null
  User:
    fields:
      email:
        type: String
        required: true
        cache: null
      id:
        type: Int
        required: true
        cache: null
      name:
        type: String
        required: true
        cache: null
      username:
        type: String
        required: true
        cache: null
    cache: null

tailcall start ./app.yaml

{
  "server": {
    "port": 8000
  },
  "upstream": {
    "baseURL": "http://jsonplaceholder.typicode.com"
  },
  "schema": {
    "query": "Query"
  },
  "types": {
    "Post": {
      "fields": {
        "body": {
          "type": "String",
          "required": true,
          "cache": null
        },
        "id": {
          "type": "Int",
          "required": true,
          "cache": null
        },
        "title": {
          "type": "String",
          "required": true,
          "cache": null
        },
        "user": {
          "type": "User",
          "http": {
            "path": "/users/{{.value.userId}}"
          },
          "cache": null
        },
        "userId": {
          "type": "Int",
          "required": true,
          "cache": null
        }
      },
      "cache": null
    },
    "Query": {
      "fields": {
        "posts": {
          "type": "Post",
          "list": true,
          "http": {
            "path": "/posts"
          },
          "cache": null
        },
        "users": {
          "type": "User",
          "list": true,
          "http": {
            "path": "/users"
          },
          "cache": null
        }
      },
      "cache": null
    },
    "User": {
      "fields": {
        "email": {
          "type": "String",
          "required": true,
          "cache": null
        },
        "id": {
          "type": "Int",
          "required": true,
          "cache": null
        },
        "name": {
          "type": "String",
          "required": true,
          "cache": null
        },
        "username": {
          "type": "String",
          "required": true,
          "cache": null
        }
      },
      "cache": null
    }
  }
}

tailcall start ./app.json

Developerslove us!

Loved by Front-end“Having a completely open-source GraphQL solution under my control is a dream. I can customize everything to fit our exact needs, with full transparency and flexibility. No more blocking on backend teams—I can iterate and build and deploy the frontend faster than ever before.”

Loved by Backend“I love that I no longer have to wrangle with GraphQL for the frontend teams. It saves me a ton of time, reduces complexity, and lets me focus on what I do best—optimizing our microservices. The clear separation of concerns has made collaboration smoother, and now with Tailcall's static verification, I can expose APIs with even more confidence.”

Loved by Ops“Switching to a battle-tested, open-source GraphQL solution has been a game-changer. It’s rock-solid, easy to manage, and scales effortlessly. I no longer worry about security gaps, and the faster iteration cycle means I can focus on bigger challenges. It's like having a superpower in my toolkit!”

Benefits