Better developer documentation

After cloning this repository and changing directory to packages/examples/graphiql-webpack/ and running npm run demo-build, the build fails with

Error: Cannot find module '@babel/core'
     babel-loader@8 requires Babel 7.x (the package '@babel/core'). If you'd like to use Babel 6.x ('babel-core'), you should install 'babel-loader@7'.

Adding @babel/core (currently version 7.7.4) to devDependencies solved the problem for me. Let me know if you want me to create a PR with this change.

[toolbear]

Success!

git clean -fxd
yarn --force && yarn build && yarn build-bundles
cd examples/graphiql-webpack
yarn run build-demo
cp dist/{index.html,main.js} $my_static_server/public/graphiql/

This was user error. I remember running yarn build-bundles per the docs, but at some point I think I started over (with git clean ...) and didn’t rerun yarn build-bundles before trying to build the webpack example.

I’m good to go. Thanks for being so responsive.

that git clean -fxd looks real handy… even though i knew what that command would do, i still managed to delete the issue templates i was working on…

Oops 😅

In my day-to-day I actually use git clean -ixd for the interactive version that lets me exclude certain patterns from removal.

[toolbear]

Lastly, kudos again for this project.

In my view, GraphiQL is a huge contributor to graphql adoption in the industry and here at Netflix. I’m working on shipping a graphql endpoint for Netflix/hollow datastores. Being able to ship a query UI & IDE alongside it is so useful.

It has already given me agility while developing the endpoint. Not only do I think users will appreciate having GraphiQL, but I think it’s an expectation now. Several other services here are already in PROD with vanilla/reference GraphiQL UIs deployed.