Install Gravity

Finally, time for the fun part – let's get your new application running!

1. Clone The Repos

Create a new folder for your project and clone all the repos you were invited to into the project root, eg.
git clone
git clone
git clone
git clone
You should now have a folder structure with a server subfolder, mission control and at least one client folder depending on which plan you purchased.
  • server
  • client-react-web
  • client-react-native
  • mission-control

2. Install Packages

Open up a new terminal window and navigate to the folder where you saved Gravity, go into the server folder and run the following command:
npm run setup
Gravity will also rename the client folders to client and app and install the packages for the server and client(s).
If you experience any issues during this process; you can run a manual install using the following commands.
npm install
npm link
cd client
npm install
// optional
cd app
npm install

3. Setup Wizard

Once installation has completed, Gravity will start the server and client and open a new browser window with the homepage, please navigate to http://localhost:3000/setup.
You'll be presented with the Gravity welcome screen. Follow the instructions on screen to connect to your database, create a master account and then connect your Stripe and Mailgun accounts.
If you have any problems during setup, you can manually config your application in the /config folder.
If you're using MongoDB, you will need to run the seed file manually:
node seeds/mongo
Once you have completed these steps, you must restart your node server.
Use the following command to run both the server and client. Use this from now on any time you want to run your application.
npm run dev
Your browser window will open automatically and you can click on signup and create an account.

4. Clean Up

You MUST remove the setup files from your install after setup. Failing to do so, will let anyone access the setup process.
You can use the cleanup script to automate this for you:
npm run cleanup
If you want to remove the files manually:
  • /client/src/views/setup folder
  • /server/controller/setupController
  • /server/model/setup
  • remove the setup import from /server/api/index.js
  • the setup route import in /client/src/app.js
It's recommended that you run npm audit in each installation folder to ensure third-party packages are up to date and secure.