Voyage I: Federation from Day One

Welcome to FlyBy, the companion app of Odyssey Voyage I! You can find the course lessons and instructions in Odyssey, Apollo's learning platform.

You can preview the completed demo app here.

How to use this repo

The course will walk you step by step through how to implement the features you see in the demo app. This codebase is the starting point of your journey!

Backend

You will work in three main folders:

router
subgraph-locations
subgraph-reviews

The course will help you set up and run each of these servers.

Frontend

The repo also includes a client folder, which includes the frontend for the FlyBy app. You won't need to edit the code in this directory.

To run the client:

Open a new terminal window, and navigate to the client folder.
Run npm install & npm start. This will install all packages in the client and start the application in localhost:3000.

`final` folder

The repo also includes a final folder, to show what your code should look like once you've finished the course. You can use it to check your work if you get stuck.

Publish the subgraph schemas to Apollo Studio

Run rover config auth to set the APOLLO_KEY value
Navigate to final/subgraph-locations.
Run rover subgraph publish <APOLLO_GRAPH_REF> --name locations --schema locations.graphql --routing-url http://localhost:4001
Navigate to final/subgraph-reviews.
Run rover subgraph publish <APOLLO_GRAPH_REF> --name reviews --schema locations.reviews --routing-url http://localhost:4001

To run the servers in the final folder:

Open a new terminal window, and navigate to final/router.
Run APOLLO_KEY=<APOLLO_KEY> APOLLO_GRAPH_REF=<APOLLO_GRAPH_REF> ./router --config config.yaml. This will start the router at http://127.0.0.1:4000/ and allow access from localhost:3000 for the client.
Open another new terminal window, and navigate to final/subgraph-locations.
Run npm install && npm start again. This will install all packages for the locations subgraph, then start the subgraph at http://localhost:4001.
Open a third new terminal window, and navigate to final/subgraph-reviews.
Run npm install && npm start again. This will install all packages for the reviews subgraph, then start the subgraph at http://localhost:4002.
In a web browser, open Apollo Studio Sandbox for http://localhost:4000. You should be able to run queries against your gateway server. Some test queries are included in the following section.

Queries

Get all locations for the homepage.

query getAllLocations {
  locations {
    id
    name
    photo
    description
    overallRating
  }
}

Get the latest reviews for the homepage.

query LatestReviews {
  latestReviews {
    comment
    rating
    location {
      name
      description
    }
  }
}

Get details for a specific location.

query getLocationDetails {
  location(id: "loc-1") {
    id
    name
    description
    photo
    overallRating
    reviews {
      comment
      rating
    }
  }
}

Submit a review for a location.

mutation submitReview {
  submitReview(
    review: {
      comment: "Wow, such a great planet!"
      rating: 5
      locationId: "1"
    }
  ) {
    code
    success
    message
    review {
      id
      comment
      rating
    }
  }
}

Getting Help

For any issues or problems concerning the course content, please refer to the Odyssey topic in our community forums.

silavsale/flyby-graphql-federation-apollo