This project is based on the
Node API and Client Boilerplate.
Required node version is 9.11.2.
The client app is bootstrapped with Create React App
and Bootstrap 3.3 framework and theme.
Copy .env.dist to .env and change the values of the environment variables if needed.
REACT_APP_SITE_NAME=React App Boilerplate
REACT_APP_API_BASE_URL=http://localhost:7770
REACT_APP_API_SIGN_IN_URL=http://localhost:7770/sign-in
REACT_APP_API_SIGN_OUT_URL=http://localhost:7770/sign-out
REACT_APP_API_VERIFY_TOKEN_URL=http://localhost:7770/verify-token
REACT_APP_API_SESSIONS_URL=http://localhost:7770/sessions
REACT_APP_API_USERS_URL=http://localhost:7770/users
REACT_APP_HASH=sha1hash1.sha1hash2.sha1hash3
NOTE: Generate random hashes and concatenate the hashes with “.”. The same hashes should also be used in the API app. The more hashes, the better.
Copy ./src/Config.dist folder to Config and change the configurations if needed.
yarn
yarn start
Note: See Bash Commands section for Docker.
To generate the ./client/src/Assets/Styles/Style.css,
open another terminal console then on the root directory of the project,
run the following command:
yarn run watch-css
The command above works only in Mac with the fsevents module installed.
Run the command below as an alternative:
yarn run build-css
Note: You must run the command above manually everytime you made changes to .scss files.
All the *.scss files shall be compiled to *.css but only the Style.css is included in the repository.
Access the app at http://localhost:7771.
Download and install the Docker Community Edition.
Note: See Bash Commands section for Docker.
The yarn run watch-css command should be running on a separate terminal console for client app.
On the root directory of the project, run the following commands:
Note: To view the Docker containers, open another terminal console then enter docker ps.
| Command | Description |
|---|---|
bin/install |
Build the Docker container and start the app |
bin/reinstall |
Rebuild the Docker container with the current branch and start the app |
bin/start |
Start the client app service |
bin/stop |
Stop the client app service |
bin/console <container ID or Name> |
Access the terminal console of the container |
| Command | Description |
|---|---|
bin/css/watch |
Watch and compile *.scss files on file changes (for Mac users only) |
bin/css/build |
Manually compile *.scss files |
- Node Express API Mockup Data Boilerplate – non-database API server powered by Express
- Node Express API Boilerplate – API server powered by Express and PostgreSQL database
- Rails API Boilerplate – API server powered by Ruby on Rails and PostgreSQL database
With the Node Express API Mockup Data Boilerplate
or the Node Express API Boilerplate app,
use the following credentials to test different API responses. Default password for all accounts is password.
| Name | Description | |
|---|---|---|
| Super Admin User | superadmin@email.com |
Has wildcard access |
| Admin User | admin@email.com |
Has wildcard access but Admin › Users › Delete is excluded |
| Common User | user@email.com |
Can access My Profile, Admin › Dashboard, Users, Users › View, and Settings |
| Referrer User | referrer@email.com |
When redirect is set without the domain, e.i. /admin/dashboard, user shall be redirected to internal page if no location path (referrer) found on the Sign In page |
| Redirect User | redirect@email.com |
When redirect is set with complete URL, e.i. https://github.com/anthub-services, user shall be redirected to external page if no location path (referrer) found on the Sign In page |
| Blocked User | blocked@email.com |
User is signed in but the account is blocked |
| Unauthorized User | <any invalid email> |
Simply enter wrong email and/or password |
The following boilerplates can be used to install and run the API and client boilerplates in a Docker container.