super-graph/README.md

48 lines
2.4 KiB
Markdown
Raw Normal View History

2019-04-18 15:27:36 +02:00
<a href="https://supergraph.dev"><img src="https://supergraph.dev/logo.svg" width="100" height="100" align="right" /></a>
2019-04-18 05:35:08 +02:00
# Super Graph - Instant GraphQL API for Rails
2019-03-24 14:57:29 +01:00
2019-04-18 05:35:08 +02:00
![MIT license](https://img.shields.io/github/license/dosco/super-graph.svg)
![Docker build](https://img.shields.io/docker/cloud/build/dosco/super-graph.svg)
![Cloud native](https://img.shields.io/badge/cloud--native-enabled-blue.svg)
2019-03-24 14:57:29 +01:00
2019-04-18 05:35:08 +02:00
Get an high-performance GraphQL API for your Rails app in seconds without writing a line of code. Super Graph will auto-learn your database structure and relationships. Built in support for Rails authentication and JWT tokens.
2019-03-24 14:57:29 +01:00
2019-04-04 06:53:24 +02:00
![Super Graph Web UI](docs/.vuepress/public/super-graph-web-ui.png?raw=true "Super Graph Web UI for web developers")
2019-03-30 06:11:30 +01:00
## Why I built Super Graph?
2019-03-24 14:57:29 +01:00
Honestly, cause it was more fun than my real work. After working on several product though my career I found myself hating building CRUD APIs (Create, Update, Delete, List, Show). It was always the same thing figure out what the UI needs then build an endpoint for it, if related data is needed than join with another table. I didn't want to write that code anymore I wanted the computer to just do it.
2019-03-24 14:57:29 +01:00
I always liked GraphQL it sounded friendly, but it still required me to write all the same database query code. Sure the API was nicer but it took a lot of work sometime even more than a simple REST API would have. I wanted a GraphQL server that just worked the second you deployed it without having to write a line of code.
2019-03-24 14:57:29 +01:00
And so after a lot of coffee and some Avocado toasts __Super Graph was born, a GraphQL server that just works, is high performance and easy to deploy__. I hope you find it as useful as I do and there's a lot more coming so hit that :star: to stay in the loop.
2019-03-24 14:57:29 +01:00
## Features
2019-04-07 07:12:11 +02:00
- Works with Rails database schemas
- Automatically learns schemas and relationships
2019-03-24 14:57:29 +01:00
- Belongs-To, One-To-Many and Many-To-Many table relationships
2019-04-07 07:12:11 +02:00
- Full text search and Aggregations
- Rails Auth supported (Redis, Memcache, Cookie)
- JWT tokens supported (Auth0, etc)
- Highly optimized and fast Postgres SQL queries
- Configure with a simple config file
- High performance GO codebase
2019-03-24 14:57:29 +01:00
- Tiny docker image and low memory requirements
2019-04-11 07:39:59 +02:00
## Documentation
[supergraph.dev](https://supergraph.dev)
2019-03-24 14:57:29 +01:00
## Contact me
[twitter.com/dosco](https://twitter.com/dosco)
## License
[MIT](http://opensource.org/licenses/MIT)
Copyright (c) 2019-present Vikram Rangnekar