Creates http endpoints for graphql server with graphiql
Switch branches/tags
Nothing to show
Clone or download
bencooling Merge pull request #6 from dmk255/master
Make example self contained
Latest commit adc5f6f Jul 11, 2017


Runs a local http server for graphiql and your graphql handler

Build Status Coverage Status serverless Npm Version


See /example directory for how easily it's done!


  1. Create a lambda function named graphql that implements a graphql server
  2. Add serverless-plugin-graphiql to serverless plugins array
  3. Run sls graphiql command from root of serverless project
  4. Visit localhost:8000/graphql in your browser to use graphiql


  • This plugin creates two http endpoints:
GET /graphql
POST /graphql
  • Once graphiql is running, you can also make requests via cli:
curl -X POST \
-H "Content-Type: application/json" \
-d '{"query": "{ hello }"}' \


--function -f   function name in serverless.yml for graphql handler, Default: graphql
--port -p       port for local http server to listen on, Default: 8000


  • Node.js > v6.0