space-cloud

README

Instant Realtime APIs on any database

Website • Docs • Support

Space Cloud is a cloud-native backend server that provides instant, realtime APIs on any database, with event triggers and unified APIs for your custom business logic.

Space Cloud helps you build modern applications without having to write any backend code in most cases.

It provides GraphQL and REST APIs which can be consumed directly by your frontend in a secure manner.

Features

View complete feature set here.

• Powerful CRUD: Flexible queries, transactions and cross-database joins
• Realtime: Make live queries to your database
• File storage: Upload/download files to scalable file stores (e.g., Amazon S3, Google Cloud Storage)
• Extensible: Unified APIs for your custom HTTP services
• Event-driven: Trigger webhooks or serverless functions on database or file storage events
• Fine-grained access control: Dynamic access control that integrates with your auth system (e.g., auth0, firebase-auth)
• Scalable: Written in Golang, it follows cloud-native practices and scales horizontally

Supported databases❤:

• MongoDB
• PostgreSQL and PostgreSQL compatible databases (For eg. CockroachDB, Yugabyte, etc.)
• MySQL and MySQL compatible databases (For eg. TiDB, MariaDB, etc.)

Table of Contents

• Quick Start
• Client-side tooling
• How it works
• Support & Troubleshooting
• Contributing
• License

Quick start

Using Docker Compose

Docker Compose is the easiest way to get started with Space Cloud. Let's see how to quickly get started with MongoDB and Space Cloud using Docker Compose.

Note: MongoDB is not a dependency of Space Cloud. Space Cloud can run with any of it's supported databases.

Prerequisites:

• Docker
• Docker Compose

1. Get the docker-compose file.

wget https://raw.githubusercontent.com/spaceuptech/space-cloud/master/install-manifests/quick-start/docker-compose/mongo/docker-compose.yaml

1. Run Space Cloud & MongoDB.

docker-compose up -d

1. Head over to http://localhost:4122/mission-control to open Mission Control and configure Space Cloud.

2. Create a project.

3. Head over to the Database section in Mission Control and edit the connection string to mongodb://mongo:27017 in the connection string.

4. Head over to the Explorer section and follow this guide to insert and read data via Space Cloud using GraphQL.

Other guides

To get started with Space Cloud without Docker compose, check out the manual guide. For production settings, check out the deployments guide.

Client-side tooling

Space Cloud exposes GraphQL and REST APIs. See setting up project guide to choose a client and set it up.

GraphQL APIs

GraphQL is the recommended way to use Space cloud, and it works with any GraphQL client. However, we recommend using Apollo Client. See awesome-graphql for a list of clients.

REST APIs

You can use the REST APIs of Space Cloud if you are more comfortable with REST.

To make it easy to consume the REST APIs in web projects, we have created a Javascript SDK for you.

How it works

Space Cloud is meant to replace any backend php, nodejs, java code you may write to create your endpoints. Instead, it exposes your database over an external API that can be consumed directly from the frontend. In other words, it allows clients to fire database queries directly.

However, it's important to note that the client does not send database (SQL) queries to Space Cloud. Instead, it sends an object describing the query to be executed. This object is first validated by Space Cloud (using security rules). Once the client is authorized to make the request, a database query is dynamically generated and executed. The results are sent directly to the concerned client.

We understand that not every app can be built using only CRUD operations. Sometimes it's necessary to write business logic. For such cases, Space Cloud allows you to access your custom HTTP servers via the same consistent APIs of Space Cloud. In this scenario, Space Cloud acts merely as an API gateway between your remote-services and the client. However, the cool part is that you can even perform joins on your remote services and database via the GraphQL API of Space Cloud

Apart from these, Space Cloud also integrates with tons of cloud technologies to give you several other features like realtime database (changes in the database are synced with all concerned clients in realtime), file storage, etc.

Support & Troubleshooting

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

• Support & feedback: Discord
• Issue & bug tracking: GitHub issues
• Follow product updates: @spaceuptech

Contributing

Space Cloud is a young project. We'd love to have you onboard if you wish to contribute. To help you get started, here are a few areas you can help us with:

• Writing the documentation
• Making sample apps in React, Angular, Android, and any other frontend tech you can think of
• Deciding the road map of the project
• Creating issues for any bugs you find
• And of course, with code for bug fixes and new enhancements

License

Space Cloud is Apache 2.0 licensed.