Turbo Federation

This is a combination of official starter Turborepo, NextJs and Apollo Supergraph (Federation) demo.

What's inside?

This turborepo uses pnpm as a packages manager. It is not only turbo charged with turbo but it also has integrated supergraph subgraph demo of Apollo.

Althought it is not a complete example with nice file names and integrated rover etc, I hope this could give you an insight to start building your own super Turbo Federated Graphql apps.

It includes the following packages/apps:

Apps and Packages

• docs: a Next.js app
• web: another Next.js app uses apollo gateway that combines all the subgraphs and serve them in one supergraph
• accounts: another Next.js app uses apollo subgraph to create subgraphs for accounts
• inventory: another Next.js app uses apollo subgraph to create subgraphs for inventory
• products: another Next.js app uses apollo subgraph to create subgraphs for products
• reviews: another Next.js app uses apollo subgraph to create subgraphs for reviews
• ui: a stub React component library shared by both web and docs applications
• config: eslint configurations (includes eslint-config-next and eslint-config-prettier)
• tsconfig: tsconfig.jsons used throughout the monorepo

Each package/app is 100% TypeScript.

Utilities

This turborepo has some additional tools already setup for you:

• TypeScript for static type checking
• ESLint for code linting
• Jest test runner for all things JavaScript
• Prettier for code formatting

Setup

This repository is using (PNPM) package manager to manage your monorepo .

create .env.local file in apps/web directory insert the variables below

ACCOUNTS_GRAPHQL_ENDPOINT=http://localhost:3002/api/graphql
REVIEWS_GRAPHQL_ENDPOINT=http://localhost:3005/api/graphql
INVENTORY_GRAPHQL_ENDPOINT=http://localhost:3003/api/graphql
PRODUCTS_GRAPHQL_ENDPOINT=http://localhost:3004/api/graphql

Build

To build all apps and packages, run the following command:

cd turbo-federation
pnpm run build

Develop

To develop all apps and packages, run the following command:

cd turbo-federation
pnpm run dev

To test everything is running perfectly try this query locally on localhost:3000/api/graphql or checkout the production gateway on Apollo Studio: Turbo Federation Demo

query Query {
  topProducts(first: 5) {
    inStock
    name
    price
    reviews {
      author {
        name
        username
      }
      body
    }
    shippingEstimate
    weight
  }
  me {
    name
    username
    reviews {
      product {
        name
      }
      body
    }
  }
}

Remote Caching

Turborepo can use a technique known as Remote Caching (Beta) to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.

By default, Turborepo will cache locally. To enable Remote Caching (Beta) you will need an account with Vercel. If you don't have an account you can create one, then enter the following commands:

cd turbo-federation
pnpx turbo login

This will authenticate the Turborepo CLI with your Vercel account.

Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your turborepo:

pnpx turbo link

Useful Links

Learn more about the power of Turborepo:

• Pipelines
• Caching
• Remote Caching (Beta)
• Scoped Tasks
• Configuration Options
• CLI Usage