learn-graphql
Looking for more interactive tutorials like this? Go to nodeschool.io.
Get help
Having issues with learn-graphql? Get help troubleshooting in the nodeschool discussions repo, or on gitter:
Install Node.js
Make sure Node.js is installed on your computer.
Install it from nodejs.org/download
On Windows and using v4 or v5 of Node.js? Make sure you are using at least 5.1.0, which provides a fix for a bug on Windows where you can't choose items in the menu.
Install learn-graphql with npm
Open your terminal and run this command:
npm install --global learn-graphql
The --global option installs this module globally so that you can run it as a command in your terminal.
Having issues with installation?
If you get an EACCESS error, the simplest way to fix this is to rerun the command, prefixed with sudo:
sudo npm install --global javascripting
You can also fix the permissions so that you don't have to use sudo. Take a look at this npm documentation:
https://docs.npmjs.com/getting-started/fixing-npm-permissions
Run the workshop
Open your terminal and run the following command:
learn-graphql
You'll see the menu:
TODO screenshot
Navigate the menu with the up & down arrow keys.
Choose a challenge by hitting enter.
Take a look at this gif that shows the first challenge:
TODO gif
You can use any editor you like.
atom or brackets are both good options.
Need help with an exercise?
Open an issue in the nodeschool/discussions repo: https://github.com/nodeschool/discussions
Include the name learn-graphql and the name of the challenge you're working on in the title of the issue.
Get Involved
Found an issue, is the documentation lacking in some areas? You can help out https://github.com/bmullan91/learn-graphql
TODO
- More challenges
- Arguments
- Custom Object types
- Resolver methods and async demo with promises
- Linking types and resolving them
- DataLoader as a caching mechanism
Development
To test and and run an exercise directly (when you've cloned the repo or installed locally) replace learn-graphql with node index.js.
If you're building a new exercise and want to test it run:
node index.js verify exercises/<exercise-name>/solution/solution.js