Skip to content

yokubo-project/yokubo-backend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

84 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

yokubo-backend

Nodejs Backend of the Yokubo App, a project tracking tool, and the corresponding Yokubo Landing Page.

About Yokubo

With Yokubo you can track your projects, record the time you spent on them and make notes about certain metrics defined by yourself. The app automatically calculates valuable statistics and gives you insights on your overall performance.

Requirements

Dependencies

Package requirements

  • ImageMagick

Installation & Usage

Install node modules

$ yarn install

Configure environment

Create env folder

In the root directory of your project create an env folder and change into this folder

$ mkdir env && cd env
Setup test environment

Create a file named test.env

$ touch test.env

Add the following environment variables to that file

NODE_ENV=test

# HAPI server settings
SERVER_HOST=127.0.0.1
SERVER_PORT=8080

# Database settings
PGHOST=127.0.0.1
PGPORT=5432
PGUSER=postgres
PGPASSWORD=password
PGDATABASE=yokubo-test

# Logger settings
FILE_SEVERITY=error
FILE_PATH=./logs/yokubo-backend.log
CONSOLE_SEVERITY=error
[email protected]

# Assets
EXTERNAL_ASSETS_URL_HOST=http://127.0.0.1:8080

# Static pages
STATIC_WEBPAGES_URL_HOST=http://127.0.0.1:8080

# Mailing (Sparkpost)
MAIL_API_KEY=<your api key>
[email protected]

# Tests
# SEND_TEST_MAILS --> set for yarn:test cmd in package.json
[email protected]
[email protected]

# Admin user
ADMIN_USERNAME=admin
ADMIN_PWD=whatever
ADMIN_NAME=Administrator

# Legal disclosure
LEGAL_DISCLOSURE_NAME=Your name
LEGAL_DISCLOSURE_ADDRESS=Your addres
LEGAL_DISCLOSURE_PLZ=Your plz
LEGAL_DISCLOSURE_CITY=_Your city
LEGAL_DISCLOSURE_STATE=Your state
[email protected]
Setup prod env

Create a file named prod.env

$ touch prod.env

Add the following environment variables to that file

NODE_ENV=development

# HAPI server settings 
SERVER_HOST=0.0.0.0
SERVER_PORT=8080

# Database settings
PGHOST=127.0.0.1
PGPORT=5432
PGUSER=postgres
PGPASSWORD=password
PGDATABASE=yokubo

# Logger settings
FILE_SEVERITY=error
FILE_PATH=./logs/yokubo-backend.log
CONSOLE_SEVERITY=info
[email protected]

# Assets
EXTERNAL_ASSETS_URL_HOST=http://127.0.0.1:8080

# Static pages
STATIC_WEBPAGES_URL_HOST=http://127.0.0.1:8080

# Mailing (Sparkpost)
MAIL_API_KEY=<your api key>
[email protected]

# Admin user
ADMIN_USERNAME=admin
ADMIN_PWD=whatever
ADMIN_NAME=Administrator

# Legal disclosure
LEGAL_DISCLOSURE_NAME=Your name
LEGAL_DISCLOSURE_ADDRESS=Your addres
LEGAL_DISCLOSURE_PLZ=Your plz
LEGAL_DISCLOSURE_CITY=_Your city
LEGAL_DISCLOSURE_STATE=Your state
[email protected]

Transpile Typescript

$ yarn build

Setup database

$ yarn db:migrate

Run tests

$ yarn test

Start server locally

$ yarn start

License

MIT

References

yokubo-app, the corresponding React-Native app.