Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/duyvu997/odyssey-voyage-i

graphql federation
https://github.com/duyvu997/odyssey-voyage-i

Last synced: 11 days ago
JSON representation

graphql federation

Host: GitHub
URL: https://github.com/duyvu997/odyssey-voyage-i
Owner: duyvu997
Created: 2023-04-11T16:21:16.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-04-12T01:35:26.000Z (over 1 year ago)
Last Synced: 2023-08-05T15:39:15.213Z (over 1 year ago)
Language: JavaScript
Size: 29.7 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# 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](https://apollographql.com/tutorials/voyage-part1/), Apollo's learning platform.

You can [preview the completed demo app here](https://odyssey-flyby.netlify.app/).

## 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.
1. 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
1. Navigate to `final/subgraph-locations`.
1. Run `rover subgraph publish --name locations --schema locations.graphql --routing-url http://localhost:4001`
1. Navigate to `final/subgraph-reviews`.
1. Run `rover subgraph publish --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`.
1. Run `APOLLO_KEY= 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.
1. Open another new terminal window, and navigate to `final/subgraph-locations`.
1. Run `npm install && npm start` again. This will install all packages for the `locations` subgraph, then start the subgraph at `http://localhost:4001`.
1. Open a third new terminal window, and navigate to `final/subgraph-reviews`.
1. Run `npm install && npm start` again. This will install all packages for the `reviews` subgraph, then start the subgraph at `http://localhost:4002`.
1. 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.

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

1. Get the latest reviews for the homepage.

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

1. Get details for a specific location.

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

1. Submit a review for a location.
```graphql
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](https://community.apollographql.com/tags/c/help/6/odyssey).