README.md

create-strato-dapp

This CLI utility instantiates a STRATO application. It performs the following steps

1. Setup OAuth config
2. Initialize backend skeleton
3. Initialize REACT UI
4. Setup docker packaging

Dependencies

The following tools should already be installed

1. node
2. yarn

Usage

1. Install the utility by using: npm i -g create-strato-dapp

2. Run project creation command: create-strato-dapp <project-name>

3. Enter your node's configuration information when prompted. If there is a default shown, simply hit ENTER to accept it.

4. When you have answered all of the prompts, the script will execute (it may take a couple of minutes). It will create the directory <project-name>, and initialize the STRATO dapp. After it finishes, enter the project directory and follow the included README for further instructions on deploying the app.

Configuration parameters asked when generating an application

• Your STRATO node's URL;
• Name for OAuth token cookie;
• Client ID and Client Secret for your client on OAuth server;
• OpenID discovery URL;
• Callback URLs.

Assumptions

This utility makes the following assumptions:

1. The application will execute on localhost
2. STRATO is running on a remote node with OAUTH_ENABLED and the user has OAuth details for the relevant identity server

It is possible to set up the application for a different environment by modifying the config that is generated at project-name-server/config/localhost.config.yaml.