create-react-app-dist

    1.2.1 • Public • Published

    CLI tool to deploy apps, based on Create React App to AWS S3

    This tool is aimed to simplfy deployment of React static apps to AWS S3 bucket (with enabled static hosting). The deployment is based on branches, which means that it deploys currently active Git branch as a separate revision to S3. All revisions are available at the same time.

    Example

    Let's assume that we have an AWS S3 bucket react-app located in eu-north-1 region. Also we have a React application, created with Create React App and create-react-app-dist installed. As usually, when we need to implement some changes, first of all we create a new Git branch:

    git checkout -b my-awesome-changes
    

    Then we implement all the necessary changes and want to show them to our manager or pull-request reviewer. In order to do that, the app needs to be deployed somewhere. This is very easy to achieve!

    cra-dist deploy
    

    That's it! Our branch is now deployed and available at http://react-app.s3-website.eu-north-1.amazonaws.com/my-awesome-changes.html

    Installation

    Globally:

    npm install -g create-react-app-dist
    

    Locally:

    npm install --save-dev create-react-app-dist
    

    Upon the installation the tool exposes cra-dist binary that allows to run it via CLI.

    Configuration

    The first thing to do after installation in the app is to initialize configuration. It's as easy as running

    cra-dist init
    

    This command creates a configuration file at ./config/dist.js relative to your app's Git root.

    The config file contains all available configuration options with default values and documentation comments. Here's how it looks

    Although, it requires certain options, like AWS credentials and Bucket settings, to be configured via environment variables. You could define them either via .env file located in the Git root of the application, or environment settings of the server (e.g. CI server).

    The config is basically a script that configures options for each run. The script provides two arguments:

    • branch - current Git branch
    • revision - the exact revision name, based on Git branch, with all special characters replaced by -

    You can use these options to configure the deployment in runtime. E.g. You can tweak certain configuration options depending on current branch (for example, deploy to different bucket or activate the revision)

    The initial config contains general options, that aplly to all branches. These settings could be tweaked for other branches. For example, initial config overwrites settings for master branch to automatically activate any deployment from that branch.

    Deployment

    Once configuration is set up, the deployment of the current branch is as easy as:

    cra-dist deploy
    

    If you need to activate current branch (make it available as index.html or just on root of the domain), just add --activate or -a option:

    cra-dist deploy --activate
    

    This CLI parameter takes precedance over the activate config option.

    Install

    npm i create-react-app-dist

    DownloadsWeekly Downloads

    3

    Version

    1.2.1

    License

    MIT

    Unpacked Size

    13.7 kB

    Total Files

    13

    Last publish

    Collaborators

    • artursmirnov