concord-consortium/S3 Deploy

Deploy an SPA to S3 using branch and version sub directories

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Feb 7, 2026
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: concord-consortium/s3-deploy-action@29ba945ba14e5f2703bf5f22e935239267f36f52 # v1.3.0

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
awsAccessKeyIdAWS access key id. Not needed if AWS credentials are already configured in the environment (e.g. via aws-actions/configure-aws-credentials).no
awsSecretAccessKeyAWS secret access key. Not needed if AWS credentials are already configured in the environment (e.g. via aws-actions/configure-aws-credentials).no
bucketS3 Bucket to deploy files toyes
prefixS3 prefix to prepend to files uploaded to S3no
noPrefixIf "true" the prefix is not used for the top level bucketno
topBranchesA JSON array of branch names (without PT number) for which the index-top.html file will be copied to the top. The file name will be [prefix]/index-[branchName].htmlno
workingDirectoryDirectory where the build command will be run. Default is the top level.no
buildbuild command to run. Default is 'npm run build'no
folderToDeploythe folder created by the build command that should be deployed. It is relative to the workingDirectory if that is set. Default is 'dist'no
maxBranchAgeIf present (and it is a valid decimal value) it will be used as the max-age parameter for the aws sync command when copying files for branch deploys. This overrides the built-in value for branch deploys.no
maxVersionAgeIf present (and it is a valid decimal value) it will be used as the max-age parameter for the aws sync command when copying files for version deploys. This overrides the built-in value for version deploys.no
githubTokenGitHub tokenno
deployRunUrlTemplated string for the URL to run the deployed files. The string can contain the following placeholder: __deployPath__no
namedescription
deployPathAn additional path added to the prefix. If it is a tag build it will be '/version/{tag-name}'. If it is a branch build it will be '/branch/{branch-name}'.
logUrlFull URL for the deployment.