Explore Apollo Federation and supergraph architecture in this beginner-friendly workshop. Learn to modularize your GraphQL backend by creating and using entities, publishing subgraph schemas, and leveraging tools like Rover CLI. Gain hands-on experience with federated architecture, entity creation, and subgraph interaction.

What you'll learn

• The federated architecture of a supergraph (subgraphs and the router)
• Create and publish subgraph schemas
• Use the Rover CLI to interact with your supergraph
• Create and use entities between subgraphs

Who this workshop is for

• API developers with a basic understanding of GraphQL, such as building queries and working with a schema, but not familiar with GraphQL Federation.

Workshop resources

• Workshop slides PDF
• Workshop companion
• Workshop project repo

⚠️ Before the workshop...

If you have any questions or run into any issues with the workshop prep below, scroll to the end of this page to leave a comment or send us an email at summit@apollographql.com. We're here to help!

You will need the following:

You will also need:

Clone the repo locally

1. Clone the repo.

   git clone https://github.com/apollographql-education/summit24-federation-entities.git

   Copy

2. Open it up in your code editor.

   📂 summit24-federation-entities
   ┣ 📂 subgraph-locations
   ┣ 📂 subgraph-reviews
   ┣ 📄 README.md
   ┣ 📄 router-config.yaml
   ┗ 📄 supergraph.yaml

Install dependencies in each subgraph server

1. In a new terminal window, navigate to the subgraph-locations directory.

2. Install the dependencies.

   subgraph-locations

   npm i

   Copy

3. Run the server in dev mode. Saving files will trigger the server to restart.

   subgraph-locations

   npm run dev

   Copy

4. In another terminal window, navigate to the subgraph-reviews directory.

5. Install the dependencies.

   subgraph-reviews

   npm i

   Copy

6. Run the server in dev mode. Saving files will trigger the server to restart.

   subgraph-locations

   npm run dev

   Copy

You can stop both processes for now. You're all set, see you at the workshop!