api-echo-church

REST API endpoints for Rock RMS backend.

Getting started

First, clone this repository.

If this fails, check to make sure you have added your SSH public key to GitHub.

Note: This is a private repository. Therefore, it is not recommended to use the HTTPS URL to clone this repository. If you use HTTPS to clone, you will be required to enter your GitHub username and password every time you run a Git command that involves syncing with GitHub.

Prerequisites

Before getting started, you will need to be running a POSIX compliant operating system. Most UNIX and Linux machines will be POSIX compliant.

Note for Windows 10: If you’re on Windows, you will need Windows Subsystem for Linux (WSL). See Windows Subsystem for Linux Installation Guide for Windows 10 for more information on how to install Linux on your Windows PC.

Note for macOS: As of OS X 10.9, you will need to install Xcode command line tools in order to have development toolchain like Git. To install Xcode command line tools, type:

xcode-select --install

Alternatively, you may also download full version of Xcode from the macOS App Store here.

Node.js installation

To get started, you will need Node.js. This documentation will utilize Node Version Manager (nvm) to install Node.js on your system as it is the most convenient way to have consistent Node.js development environment.

If you don’t already have nvm installed, follow the installation instructions.

Let’s install Node.js 12.10:

$ nvm install 12.10
Downloading and installing node v12.10.0...
Downloading https://nodejs.org/dist/v12.10.0/node-v12.10.0-darwin-x64.tar.xz...
######################################################################## 100.0%
Computing checksum with sha256sum
Checksums matched!
Now using node v12.10.0 (npm v6.11.3)

Install dependencies

In the project directory root, run:

npm install

Set up environment variables

Copy .env.example to .env:

cp .env.example .env

Open .env and fill in the database connection configuration.

You should now be ready to run a dev server in your local environment!

Running development server

In production mode, you will normally be required to compile before running the API server. However, this can get tedious quickly. This project provides a convenience script to start the server in development mode:

npm run dev