Blazing fast, instant realtime GraphQL APIs on your DB with fine grained access control, also trigger webhooks on database events.
Go to file
Vamshi Surabhi 8afa6b6fa0
Merge pull request #129 from rakeshkky/issue-106
add _is_null operator (closes #106)
2018-07-13 15:07:11 +05:30
.circleci testing console tests in the ci (#83) 2018-07-11 17:32:29 +05:30
assets add images to assets, update readme (#118) 2018-07-12 01:14:08 +05:30
cli inserts into schema_migration only once per version (fix #127) (#128) 2018-07-12 19:54:46 +05:30
console show indicative comments on graphiql if no tables are present (#120) 2018-07-12 00:54:14 +05:30
scripts only deploy dev|release branches (#76) 2018-07-10 11:52:13 +00:00
server server: add _is_null operator, closes #106 2018-07-12 19:33:02 +05:30
.gitignore console: more tests (#35) 2018-07-04 18:27:56 +05:30
code-of-conduct.md update readme and code of conduct (#108) 2018-07-11 17:37:49 +05:30
CONTRIBUTING.md add contributing guidelines for server (#104) 2018-07-11 16:04:29 +05:30
LICENSE Add A-GPL license 2018-07-09 19:30:43 +05:30
README.md update badges 2018-07-12 19:10:15 +05:30

Hasura GraphQL Engine

Docs CircleCI

Hasura GraphQL Engine Banner

Hasura GraphQL Engine is a performant GraphQL server that provides ready-to-use GraphQL API over Postgres by auto-generating GraphQL schema and corresponding resolvers.

  • Make powerful queries: built-in filtering, pagination, and pattern search arguments and operators
  • Works with existing database: point it to an existing Postgres database to instantly get a ready-to-use GraphQL API
  • Fine-grained access control: dynamic access control that integrates with your Auth
  • Light-weight & performant: ~15MB docker image; ~50MB RAM @ 1000 req/s; multi-core aware
  • Dev friendly: admin UI & Rails-inspired schema migrations
  • Postgres ❤️: supports Postgres types (PostGIS/geo-location, etc.), turns views to graphs, trigger stored functions or procedures with mutations

Quickstart - Setup on Heroku

no credit-card required; sign-up may be required

  1. Click on the following button to deploy GraphQL Engine on Heroku and provision the free Postgres add-on:

    Deploy

  2. Open the admin console

    Visit https://<app-name>.herokuapp.com (replace <app-name> with your app name) to open the admin console.

  3. Make your first GraphQL query

    Create test tables and instantly run your first query. Follow this simple guide.

Other deployment methods

For Docker-based deployment and advanced configuration options, see deployment guides here.

Architecture

The Hasura GraphQL Engine fronts a Postgres database instance and can serve as an API Gateway for all data requests from client apps. It can be configured to work with your existing Auth middleware to handle access control to data using field-level rules with dynamic variables.

The GraphQL Engine is a standalone, multi-core aware component that can be scaled vertically and horizontally.

Hasura GraphQL Engine architecture

You can also place the engine behind a central GraphQL proxy that fronts multiple GraphQL APIs via schema stitching.

GraphQL Engine schema-stitched architecture

Client-side tooling

GraphQL Engine provides an HTTP API. This means you can use any client-side tool or library to query the endpoint. To fully leverage GraphQL, it is recommended that you use GraphQL specific client-side tooling like Apollo Client, Relay, etc. See awesome-graphql for a list of such tools.

Community

Please join our amazing community of developers and contributors on Discord.

Support & Troubleshooting

The documentation and community will help you troubleshoot most issues. However, if you have encountered a bug or need to get in touch with us, you can contact us using one of the following channels:

We are committed to fostering an open and welcoming environment in the community. Please see the Code of Conduct.

Contributing

Check out our contributing guide for more details.

License

GraphQL Engine is available under the GNU Affero General Public License v3 (AGPL-3.0). Why AGPL?.

Commercial licenses are available on request. Please feel free to contact us at build@hasura.io or using Intercom chat.