GraphQL-API runtime on top of PouchDB

A GraphQL-API runtime on top of PouchDB created by GraphQL shorthand notation as a self contained service with CouchDB synchronization.

Objectives - evaluating for your project

Frontend-First-Driven approach without backend/database migrations
Friendly GraphQL shorthand notation spec to create typed data model definitions fast and easy
Self-contained // no infrastructure dependencies // no lock in
Customizable for seamless integration of existing resources

Usage

First install using npm:

npm install -g graphql-pouch

and then just run it!

graphql-pouch

For more information run:

graphql-pouch -h

##GraphiQL UI for development becomes standard

GraphiQL is a awesome web based tool by Facebook to let you interactively explore your data and your API. When development mode is enabled in GraphQL-Pouch, the GraphiQL interface will be automatically displayed at your GraphQL endpoint.

Example

graphql-pouch --development

Listen on port 3000
CouchDB sync URL: none
Relay enabled: true
Development mode: true
JWT-Authentication: false

Supported GraphQL schemas:
cms initialized and running - http://127.0.0.1:3000/graphql/cms

Navigate to the URL printed to your console after starting GraphQL-Pouch and use GraphiQL to fetch your data. When you want to use GraphQL-Pouch in production mode, the GraphiQL-App is ideally suited.

GraphQL and Relay

Check out the CMS example for a demo of GraphQL-Pouch, Relay and React in action.

Benefits

GraphQL-Pouch uses the joint benefits of PouchDB and GraphQL to provide a number of key benefits.

100% GraphQL compliant (supports pure GraphQL mode)
100% Relay compliant
Command Line Interface
JWT Authentication support
Custom GraphQL-Queries and Mutations via JavaScript functions
Fully documented API and GraphiQL-UI for development
Serves multiple GraphQL schemas
Using GraphQL-Pouch as a NPM-Module
Completely self contained with Master/Master Replication
Supports relationships, types, comments, pagination, and more providing by GraphQL, PouchDB and CouchDB
Serves static files for e.g. React-Application hosting

Roadmap

In the future, things that GraphQL-Pouch will include:

HTTPS Support
Mock/Fake data results
Runtime traceability using resolver timings
Role based authorization
MongoDB query language inspired subselections
DataLoader for batching and caching optimization
Subscriptions using PouchDB change notifications

and, of course:

better documentation
better validation and error messages
better debug logs
more tests
more examples

Run Tests

npm install
npm test

Development

npm run dev

Contributors

Check them out here

Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker.

License

This project is licensed under the MIT license. See the LICENSE file for more info.

Thanks

You like this GraphQL server and you want to see what coming next? Follow me on Twitter @mikebild.

Enjoy!

Credits

Thanks to Matthew Mueller for his initial work on graph.ql which laid the groundwork for the GraphQL shorthand notation parser module.