Skip to content
Real-time GraphQL API Exploration in VS Code
TypeScript JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
DOCUMENTATION adding external server instructions Nov 23, 2019
__tests__ test folder relocated Nov 20, 2019
src removed a console log while testing. looking good Nov 23, 2019
.eslintrc small clean up updates Nov 20, 2019
.gitignore small clean up updates Nov 20, 2019
.vscodeignore small clean up updates Nov 20, 2019
LICENSE initial commit Oct 30, 2019
README.md
package-lock.json 0.16.0 Nov 23, 2019
package.json 0.16.0 Nov 23, 2019
tsconfig.json

README.md

GraphQuill

What is GraphQuill?

GraphQuill is a VS Code extension that performs GraphQL API endpoint testing within the VS Code environment. GraphQuill intends to remove the need for switching between VS Code and GraphiQL, Postman, or another API development tool.

Features

Core Features

  1. Starts your GraphQL server (if it is not already running).
NOTE: GraphQuill is compatible with local and dockerized servers and will check if the specified port has a running server on it.
GraphQuill is also compatible with **external** API's (accessed via a url in the config file).
  1. Parses GraphQL queries/mutations that are typed into the current open document in VS Code.
  2. Sends the queries/mutations to the GraphQL API.
  3. Renders the responses to the GraphQuill output channel on VS Code.

demo gif

Additional Features


Getting Started

Installation

GraphQuill can be installed from the VS Code Extensions marketplace here.

Setting up the config file

Open the command palette in VS Code (Cmd/Ctrl + Shift + P) and select "GraphQuill: Create GraphQuill Config File". A default config file will be generated. If you're using a locally-hosted server, update the entry point with your server's file path and add a port number. If you're using an external server, set the entrypoint to its URL. For more details, refer to the documentation.

GraphQuill's Mock GraphQL API

A GraphQL API that was used during GraphQuill's development has been open sourced in two repositories on Github to allow users to give GraphQuill a test drive. Below are two repositories, one that has been dockerized, and one that uses locally hosted PostgreSQL and MongoDB databases.

The dockerized version is here.

The locally hosted PostgreSQL and MongoDB databases version is here.

Write your first GraphQuill query

Search for GraphQuill from the command palette in VS Code (Cmd/Ctrl + Shift + P) and run the Activate command. If the graphQuill function is not defined, GraphQuill will inject a function definition on the top line of your file.

Anywhere in your open file, put a GraphQL query inside the graphQuill function. For example:

  graphQuill(`{
    customer (customerId: 8) {
      firstName
      lastName
      email
    }  
  }`);

  graphQuill('{ product (productId: 26) { name description weight } }');

On every save, GraphQuill will send any requests inside of the graphQuill functions to your GraphQL API and show responses in the GraphQuill Output Channel. To send another request, create a new invocation of the graphQuill function and put the new request as the argument.


Contributing and Issues

We are always looking to improve. If there are any contributions, feature requests or issues/bugs you have, please check out our documentation on contributions, feature requests or issues/bugs.

Release Notes

Created by: Alex Chao, Austin Ruby and Edward Greenberg

0.16.0 | Initial release of GraphQuill, More to come!

You can’t perform that action at this time.