gitter-badger/scottyjs

Deploy static websites and single page apps to AWS S3 and CloudFront with a single command

Scotty.js

Deploy static websites or folders to AWS S3 with a single command

Install

Scotty.js is available on NPM. Install it as a global dependency to be able to use scotty command anywhere:

npm install scottyjs --global

Use

Beam me up, Scotty

To deploy a static folder to AWS S3 run:

scotty {options}

or

beam-me-up {options}

Available options

• --help or -h - Print this help
• --version or -v - Print the current version
• --quiet or -q - Suppress output when executing commands (default: false)
• --website or -w - Set uploaded folder as a static website (default: false)
• --spa - Set uploaded folder as a single page app (default: false)
• --source or -s - Source of the folder that will be uploaded (default: current folder)
• --bucket or -b - Name of the S3 bucket (default: name of the current folder)
• --region or -r - AWS region where the files will be uploaded, default: saved region if exists or a list to choose one if it is not saved yet
• --force or -f - Update the bucket without asking (default: false, forced region can be overridden with -r)
• --update or -u - Update existing bucket (default: false)

Examples

Create React App application

Full tutorial: http://medium.com/@slobodan/single-command-deployment-for-single-page-apps-29941d62ef97

To deploy CRA apps simply run npm run build in your project root folder to create build version.

Then deploy build version using following command:

scotty --spa --source ./build

Or, if you want to specify bucket name run:

scotty --spa --source ./build --bucket some-bucket-name

With --spa flag, Scotty will set required redirects for your single page app, so your app can use pushState out of the box.

Test

We use Jasmine for unit and integration tests. Unless there is a very compelling reason to use something different, please continue using Jasmine for tests. The existing tests are in the spec folder. Here are some useful command shortcuts:

Run all the tests:

npm test

Run only some tests:

npm test -- filter=prefix

Get detailed hierarchical test name reporting:

npm test -- full

License

MIT -- see LICENSE