Add Space Cloud to your JavaScript project

Follow this guide to use Space Cloud APIs in your web app or any Javascript/Node.js project.

Note: Make sure you have all the completed all prerequisites.

Step 1: Install Space Cloud API

Install via npm:

$ npm install space-api --save

Or import as a stand alone library:

<script src="https://spaceuptech.com/downloads/libraries/space-api.js"></script>

Step 2: Create a Client instance

A client instance of Space Cloud on the frontend will help you talk to space-cloud binary and perform backend operations directly from the frontend.

For ES6:

import { API } from 'space-api';

const api = new API('demo-project', 'http://localhost:8080');

For ES5/CommonJS:

const { API } = require('space-api');

const api = new API('demo-project', 'http://localhost:8080');

For stand alone:

var api = new Space.API("todo-app", "http://localhost:8080");

The API method takes the following parameters:

project-id: - Name of the project

url: - Url of the space-cloud binary

Step 3: Create a DB instance

The api instance created above will help you to directly use fileStorage and functions modules. However, to use crud, realTime and auth modules you will also need to create a db instance.

Note: You can use multiple databases in the same project. (For eg. MongoDB and MySQL)

For MongoDB:

const db = api.Mongo();

For PostgreSQL:

Note: This can also be used for any other database that is PostgreSQL compatible (For eg. CockroachDB, Yugabyte etc.)

const db = api.Postgres();

For MySQL:

Note: This can also be used for any other database that is MySQL compatible (For eg. TiDB)

const db = api.MySQL();

Next steps

Great! Since you have initialized the api and db instance you can start building apps with space-cloud. Check out these modules to explore all that you can do with space-cloud:

Have a technical question?

Edit docs!