graphql-hotels-example
Tired of TodoMVC? So do I.
What is it?
This is yet another example of GraphQL server.
It provides you GraphQL backend, so you can play with queries in the GraphiQL.
While implementing this example I was trying to keep backend simple but provide clear and meaningful schema.
Features
- To keep it simple this example uses in-memory storage. Initial data located in data.json file.
- GraphiQL tool enabled and it is a way to play with GraphQL.
- There is no frontend part. (But it would be good to implement example clients using Relay.
react-nativeexample in progress.)
Domain, Diagram and Schema. Small Intro.
What is our app about?
Let's imagine we are developing tourist guide program.
- There is information about
Countriesour user may plan to visit. - Each
CountrycontainsCities. - And each
Cityhas a bunch ofHotels.
Wait, what the backend without nice images? We will add Image to Country and list of Images for each City.
Now we can review the Relations Diagram.
Relations Diagram
Schema
Our schema allow us to fetch any shape of data.
For this we need to add entry points for lists and individual entity:
countries- List ofCountries. For index page of our application with countries.country(countryID)- ParticularCountryby ID. For individualCountrypage.city(cityID)- ParticularCityby ID. For individualCitypage.hotel(hotelID)- ParticularHotelby ID. For individualHotelpage.
About node entry point.
Have you noticed some kind of duplication in country, city, hotel?
For avoiding this Relay provides us ability to use one entry point for all individual entities called node:
node(ID)- WhereIDis GraphQL UUID.
For more information check this
But in this example I am going to leave all the entry points available.
How to run
-
Install dependencies:
npm install -
Run the server
npm start -
Go to http://localhost:3000/graphql to open GraphiQL.