arc deploy

Deploy an Architect project to AWS by creating or updating a CloudFormation stack with resources declared in the project manifest.

CloudFormation stack names are created from the name specified in the @app pragma and are unique to an AWS region. Changing the project name or region will create a new CF stack.


arc deploy [--production|--static|--direct]


  • [--debug, -d] Displays debug (and verbose) logging.
  • [--direct path/to/function] Overwrite staging Lambda with local source. A faster way to deploy and test small changes to individual functions without redeploying an entire stack.
  • [--dry-run] Creates a CloudFormation template but does not deploy it. A dry-run allows you to check the CloudFormation and SAM output before deploying the actual stack.
  • [--fast, -f] Deploy the stack, but do not hold the process open to determine whether the deployment succeeded or failed within AWS
  • [--name, -n] Deploy a custom named staging stack.
  • [--no-hydrate] Do not automatically run npm, bundle, or pip
  • [--production, -p] Deploys a CloudFormation stack to a production stack.
  • [--prune] Remove assets not present in the local static folder.
  • [--static, -s] Deploys only the files in the static folder.
  • [--tags, -t] Adds resource tags to the CloudFormation stack.
    • The required tag format is key=value, e.g. --tags key1=value1 key2=value2
  • [--verbose, -v] Displays verbose logging.

Local preferences: @create

When deploying, Architect can automatically scaffold resources (via arc init) found in the application’s manifest that do not yet exist. Options are set with @create in local preferences.

  • autocreate - Set to true to enable automatic creation of boilerplate Lambda handlers and static assets if they do not exist.
  • templates - Specify templates for automatic resource scaffolding.
    • <pragma name> path/to/template.ext
    • Does not enable autocreate
autocreate true
  http path/to/template/http.js
  events path/to/template/


Deploy a staging stack

arc deploy

Deploy a production stack

arc deploy --production

Deploy a named environment

arc deploy --name my-stack

💁 Named stacks use staging environment variables set with arc env -e staging --add.

Deploy static assets to S3

arc deploy --static

Deploy code directly to the staging Lambda

arc deploy --direct src/http/get-index

Run deploy without deploying

This is useful for testing @macros; it will still generate sam.json.

arc deploy --dry-run