Skip to content

Latest commit

 

History

History
99 lines (62 loc) · 2.62 KB

installation.md

File metadata and controls

99 lines (62 loc) · 2.62 KB
Raw

Installing the Spark development environment

This is a step-by-step guide to getting you up and running with Spark so you can start developing as soon as possible.

Preconditions

Getting the source files

  • Fork the project on GitHub (this can be done in the GitHub web interface)
  • clone your forked repo
git clone https://github.com/<YOUR_GITHUB_USER>/Spark.git

To be able to sync with Midburn repository you should add it as a remote:

git remote add midburn https://github.com/Midburn/Spark.git

Installing Node

Optional - It is recommended to use nvm to get the correct node version. (If you are not planning to use nvm, just skip these commands).

We have a .nvmrc file which will be detected automatically, so you will get the correct node version.

cd spark
nvm install
nvm use

Installing Node modules

cd spark
npm install
npm install -g nodemon knex bower

Installing bower dependencies

Bower provides web static files dependencies

bower install

Setting up the database

Local development environment uses Sqlite do doesn't require any special DB setup.

The database file is located (by default) at spark/dev.sqlite3

We use Knex to run and manage the migrations.

knex migrate:latest

See /docs/database.md for more details about our database setup.

Light the spark

Fire up the server after installation, with nodemon to monitor changes and re-run the server:

nodemon server.js

and navigate to http://localhost:3000.

Note nodemon should take care of refreshing the server when you make changes.

Creating an admin account

After lighting the spark, if this is the first time or if you have recreated the DB browse to the development console at http://localhost:3000/dev and select Create admin user.

This will create a user: a, password: a

Configure your environment

All the configurations are set in the config file in the /config folder.

To override this configurations to match your development environment:

  1. Create a file named /config/local-evelopment.json
  2. Open the file and copy all the settings you wish to override from /config/default.json

Notes:

  • You only need to copy the settings you need to override, not all the settings.
  • The file format should be the same as /config/default.json