super-graph/docs/README.md

77 lines
3.1 KiB
Markdown
Raw Normal View History

2019-04-04 06:52:52 +02:00
---
2019-08-02 16:07:50 +02:00
layout: HomeLayout
2019-04-04 06:52:52 +02:00
home: true
2019-09-30 07:25:23 +02:00
heroText: "Super Graph"
2019-08-02 16:07:50 +02:00
heroImage: /super-graph-web-ui-half.png
heroImageMobile: /super-graph-web-ui.png
2019-09-30 07:25:23 +02:00
tagline: Build web products faster. Instant APIs for your apps
longTagline: Get an instant high performance GraphQL API for Postgres. No code needed. GraphQL is automatically transformed into efficient database queries.
actionText: Get Started, Free, Open Source →
2019-04-04 06:52:52 +02:00
actionLink: /guide
2019-09-30 07:25:23 +02:00
description: Super Graph can automatically learn a Postgres database and instantly serve it as a fast and secured GraphQL API. It comes with tools to create a new app and manage it's database. You get it all, a very productive developer and a highly scalable app backend. It's designed to work well on serverless platforms by Google, AWS, Microsoft, etc. The goal is to save you a ton of time and money so you can focus on you're apps core value.
2019-04-04 06:52:52 +02:00
features:
- title: Simple
details: Easy config file, quick to deploy, No code needed. It just works.
- title: High Performance
2019-07-29 07:13:33 +02:00
details: Compiles your GraphQL into a fast SQL query in realtime.
2019-08-02 16:07:50 +02:00
- title: Ruby-on-Rails
details: Can read Rails cookies and supports rails database conventions.
- title: Serverless
2019-09-30 07:25:23 +02:00
details: Instant startup for scale to zero environments like Google Cloud Run, App Engine, AWS Lambda
- title: Go Lang
details: Go is a language created at Google to build fast and secure web services.
2019-08-02 16:07:50 +02:00
- title: Free and Open Source
details: Not a VC funded startup. Not even a startup just good old open source code
2019-09-30 07:25:23 +02:00
2019-04-04 06:52:52 +02:00
footer: MIT Licensed | Copyright © 2018-present Vikram Rangnekar
---
## Try the demo
2019-04-13 15:12:41 +02:00
```bash
# download super graph source
git clone https://github.com/dosco/super-graph.git
# setup the demo rails app & database and run it
./demo start
# signin to the demo app (user1@demo.com / 123456)
open http://localhost:3000
# try the super graph web ui
open http://localhost:8080
```
## Try a query
2019-04-04 06:52:52 +02:00
2019-05-13 01:27:26 +02:00
```graphql
query {
2019-04-04 06:52:52 +02:00
users {
id
email
picture : avatar
products(limit: 2, where: { price: { gt: 10 } }) {
id
name
description
}
}
}
```
## Why Super Graph?
2019-04-04 06:52:52 +02:00
After working on several product though my career I found building CRUD APIs (Create, Update, Delete, List, Show) to be a big part of the job. 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-04-04 06:52:52 +02: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-04-04 06:52:52 +02: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-04-04 06:52:52 +02:00
2019-05-13 01:27:26 +02:00
## Say hello
[twitter.com/dosco](https://twitter.com/dosco)