Installation and Usage

In order to avoid passing these arguments every time, you can do shboard --aws-profile PROFILE --aws-region REGION --save-config to write your settings to a config file on disk. Then shboard will use the specified profile/region automatically.

Use shboard --help for more information. The output is shown below for reference. Note that some of these parameters are not used for existing functionality (e.g. --papertrail-key).

Configuration File

shboard is configurable via command-line arguments as well as with a config.edn file. edn is a Clojure-related data format that allows you to represent data more compactly than with JSON. By default, this file is looked for in ~/.config/shboard/config.edn. You can view the configuration being used with: shboard --print-config, or automatically update the config.edn file with the running configuration using shboard --save-config.

Building From Source

shboard is written in ClojureScript, which has to be compiled to Javascript before it can be executed with Node. This process is managed by Boot. See the boot install instructions for details on how to get boot on your machine.

Once you have boot, the root directory of the project, run boot build to compile the application to the target/ output directory. You should then be able to node target/main.js to run the dashboard.

There is also a dev build: boot build-dev, and a file watcher that rebuilds on changes: boot follow. Because the dev builds are compiled without optimizations, the application must be run from within the target directory: cd target && node main.js. However, the dev build is faster.

NPM Dependencies

Node package dependencies can be managed with boot if they are in the CLJSJS repository. If not, use the package.json in the root folder to manage them. The modules are copied to the target directory as part of the build process.