How to GraphQL 🎓
Note: This repository is currently mostly unmaintained. We are looking for maintainers who can help cleaning up issues and PRs opened by the community. If you are interested in helping out, please reach out!
The content for all tutorials is located in the
/content directory. Here is an overview of all the tutorials that are available at the moment:
- Fundamentals of GraphQL
- Advanced GraphQL
- React & Apollo
- React & Relay
- Vue & Apollo (Out of date)
- Ember & Apollo (Out of date)
- Expo & Apollo (Coming Soon)
- Angular & Apollo (Coming Soon)
- VulcanJS (Coming Soon)
- Absinthe / Elixir
- graphql-ruby / Ruby
- graphql-java / Java
- Graphene / Python
- gqlgen / Go
- Sangria / Scala (Coming Soon)
Contributions / Fixes
As the whole project is open-source, you're more than welcome to fix typos and other small issues yourself and create a PR for the fix. If you want to contribute a whole tutorial track or update one of the out of date tutorials please get in touch.
Installation & Running locally
The project has some native (gyp) dependencies. To get this running, please make sure your environment it set with the following:
- Make sure to install a Node version manager (either fnm or nvm)
- Point your environment to the version specified in
- Make sure to load
.envto your environment variables (some shell loads it automatically, but if not, you can do:
source .envto load it)
You can run a local instance of How to GraphQL by executing the following commands in a terminal:
git clone [email protected]:howtographql/howtographql.git cd howtographql yarn install yarn start # http://localhost:8000/
Note: If you're using Node 8, you might need to invoke
npm install -g node-gypbefore you're starting the app. More info here.
If you are having issues with
sharp dependency, please make sure you have installed
>0.18.2 of it. Older versions have hardcoded dependency on a legacy artifactory.
To check the version you have, run:
yarn why sharp.
If you are still having issues, please make sure that you have
SHARP_DIST_BASE_URL environemnt variable set correctly (see
.env file) and then run
yarn install again.