HarperDB Studio

The comprehensive management suite for HarperDB.

What’s in the box

Third party software (click to review each library's licensing)
- ReactJS site scaffold via Create React App
- react-router for navigation
- pullstate for global state management

Follow these steps to run a local version of HarperDB Studio.

In your terminal, clone the UI scaffold, enter the directory, and install dependencies.
```
git clone https://github.com/harperdb/hdbms.git
cd hdbms
yarn
```
Create your local config file.
- Create a copy of the file /src/config/index.example.js, renaming it index.js.
- update the stripe_public_key and/or other variables in that file as desired
- save the file
- Never commit /src/config/index.js to GitHub!
Generate https certificates for local development

Install mkcert tool (OS X)
```
brew install mkcert
brew install nss (if you need Firefox)
```
Install mkcert tool (Windows)
```
scoop bucket add extras
scoop install mkcert
```
Setup mkcert on your machine (creates a CA)
```
mkcert -install
```
Create .cert directory if it doesn't exist
```
mkdir -p .cert
```
Generate the certificate (ran from the root of this project)
```
mkcert -key-file ./.cert/key.pem -cert-file ./.cert/cert.pem "localhost"
```
NOTE: If you use Firefox, restart it to get the cert to take effect.
Start the project.
```
yarn start
```
Visit the project at https://localhost:3000.
- The development web server uses a self-signed certificate, and you may see a warning about the site being insecure. In your local development environment, it is safe to click "Advanced" > "proceed to site anyway."