snowtooth's Introduction

Snowtooth GraphQL API 🏔

Snowtooth Mountain is a fake ski resort, but that shouldn't prevent it from having a real GraphQL API.

You write queries at the project website using GraphQL Playground: http://snowtooth.moonhighway.com. To view a list of all of the available queries, mutations, and subscriptions, click the Schema tab on the right side of the screen.

Running the Project Locally 🚡

To run the project locally, follow these instructions:

Basic Setup

Download/clone the repo.
Run npm install or yarn to install the dependencies.
View GraphQL Playground running on http://localhost:4000.

Adding Apollo Engine

Want to integrate with Apollo Engine? Follow these instructions:

Create a free Apollo Engine account.
Get an Apollo Engine Key.
Create a .env file and put it at the root of the project.
In the .env file, add the following line:

ENGINE_API_KEY=<your-apollo-engine-key>

Then shred on some lift and trail data from the greatest fake ski resort on Earth! ⛷

Caveats 🚠

This is a demo app to allow students of Moon Highway or GraphQL Workshop courses to start working with GraphQL. It updates the database (JSON files) each time someone sends a mutation, so some inconsistencies may appear if multiple people are running mutations at the same time.

snowtooth's Issues

Clear Errors

We should throw clear errors from resolvers and add an error handling lesson to this api.

Incorporate Apollo Engine

We need to know who is using this repo and how much it is being used.

TODO

Hook production repo up to Apollo Engine
Incorporate Apollo Engine schema diffing on all pull requests

running without Apollo Engine causes an error

Error message:

[nodemon] starting 'babel-node -r node_modules/dotenv/config ./src' /moonhighway/snowtooth/node_modules/apollo-server-core/dist/ApolloServer.js:51 else if (typeof engine === 'object' && engine.apiKey) { ^TypeError: Cannot read property 'apiKey' of null

Simple fix, if not using Apollo Engine, is to comment out the engine value in new ApolloServer call in index.js, shown below

const server = new ApolloServer({ typeDefs, resolvers, context, // engine: process.env.ENGINE_API_KEY // ? { apiKey: process.env.ENGINE_API_KEY } // : null });

Thanks for the awesome hooks tutorial, very well done

moonhighway / snowtooth Goto Github PK

snowtooth's Introduction

Snowtooth GraphQL API 🏔

Running the Project Locally 🚡

Basic Setup

Adding Apollo Engine

Caveats 🚠

snowtooth's People

Contributors

Stargazers

Watchers

Forkers

snowtooth's Issues

TODO

Recommend Projects

Recommend Topics

Recommend Org