@tailcallhq/tailcall


Tailcall is an open-source solution for building [high-performance] GraphQL backends.

Please support us by giving the repository a star
!image

[high-performance]: https://github.com/tailcallhq/graphql-benchmarks


!GitHub release (by tag)

Installation

$3

``bash
npm i -g @tailcallhq/tailcall
`

$3

`bash
yarn global add @tailcallhq/tailcall
`

$3

`bash
brew tap tailcallhq/tailcall
brew install tailcall
`

$3

`bash
curl -sSL https://raw.githubusercontent.com/tailcallhq/tailcall/master/install.sh | bash
`

$3

`bash
docker pull ghcr.io/tailcallhq/tailcall/tc-server
docker run -p 8080:8080 -p 8081:8081 ghcr.io/tailcallhq/tailcall/tc-server
`

Get Started

The below file is a standard .graphQL file, with a few additions such as @server and @http directives. So, basically, we specify the GraphQL schema and how to resolve that GraphQL schema in the same file, without having to write any code!

`graphql
schema @server(port: 8000, hostname: "0.0.0.0") @upstream(httpCache: 42) {
query: Query
}

type Query {
posts: [Post] @http(url: "http://jsonplaceholder.typicode.com/posts")
user(id: Int!): User @http(url: "http://jsonplaceholder.typicode.com/users/{{.args.id}}")
}

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

type Post {
id: Int!
userId: Int!
title: String!
body: String!
user: User @http(url: "http://jsonplaceholder.typicode.com/users/{{.value.userId}}")
}
`

Now, run the following command to start the server with the full path to the jsonplaceholder.graphql file that you created above.

`bash
tailcall start ./jsonplaceholder.graphql
`

Head out to [docs] to learn about other powerful tailcall features.

[docs]: https://tailcall.run/docs

$3

Throughput comparison of various GraphQL solutions for a N + 1 query:

`graphql
query {
posts {
title
body
user {
name
}
}
}
``

!Throughput Histogram

Check out detailed benchmarks on our benchmarking repository.

$3

Your contributions are invaluable! Kindly go through our [contribution guidelines] if you are a first time contributor.

[contribution guidelines]: https://tailcall.run/docs/contribution-guidelines

$3

⭐️ Give us a star.

👀 Watch us for updates.

$3

This initiative is protected under the Apache 2.0 License.