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:

1. Open a new terminal window, and navigate to the client folder.
2. 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

1. Run rover config auth to set the APOLLO_KEY value
2. Navigate to final/subgraph-locations.
3. Run rover subgraph publish <APOLLO_GRAPH_REF> --name locations --schema locations.graphql --routing-url http://localhost:4001
4. Navigate to final/subgraph-reviews.
5. 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:

1. Open a new terminal window, and navigate to final/router.
2. 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.
3. Open another new terminal window, and navigate to final/subgraph-locations.
4. Run npm install && npm start again. This will install all packages for the locations subgraph, then start the subgraph at http://localhost:4001.
5. Open a third new terminal window, and navigate to final/subgraph-reviews.
6. Run npm install && npm start again. This will install all packages for the reviews subgraph, then start the subgraph at http://localhost:4002.
7. 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

1. Get all locations for the homepage.

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

2. Get the latest reviews for the homepage.

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

3. Get details for a specific location.

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

4. 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.