Skip to main content

A CDK construct which creates a pipeline that pulls code from a source repository, builds it, then deploys to an S3 bucket (with CloudFront if a certificate is required)

Project description

SPA + CICD Website Construct

This CDK construct is used to create a static website with a CodePipeline to deploy from source code on pushes to master. The goal of this construct is to be able to point it at a git repository, give it a url, and you've got a continuously deployed static website.

This is a pre-release!

This is a quick first-draft. All the options that will likely need to be added to accomodate a large number of use-cases are still needed. If you'd like to make requests or help update this construct, please open an Issue or a PR.

What Gets Created

At the base level, the following will be built:

  • An S3 bucket for build artifacts
  • An S3 bucket for the website content
  • CICD Pipeline - CodePipeline sourced from Github, built using CodeBuild and deployed to an S3 bucket.

If a certificate is supplied or requested:

  • An ACM certificate will be provisioned via DNS if requested
  • A CloudFront Distribution pointing to the S3 bucket.


This will create the website, the deployment pipeline, and add a generated certificate (and CloudFront) for HTTPS support.

# Example automatically generated without compilation. See
CicdSpaWebsite(stack, "public-site",
        "owner": "mbonig",
        "repo": "public_site",
        "oauth_token": SecretValue.secrets_manager("github-oauth-token")
        "hosted_zone_id": "ABCDEFGHIJKLM",
        "zone_name": ""

Input Properties

property description example
url The url you'd like your website to be available at. Must be full url and must be controlled by the given HostedZone
githubSource.owner The Github repository's owner mbonig
githubSource.repo The GH repo name public_site
githubSource.branch An optional branch name. Defaults to 'master' qa
githubSource.oauthToken An ISecret pointing to an oauthToken. SecretValue.secretsManager('github-oauth-token')
hostedZone (Optional) - If provided, used to create DNS Records.
hostedZone.hostedZoneId The hostedZone ID for the 'url's domain ABCDEFGHI
hostedZone.zoneName The hostedZone's name
certificate (Optional) - If provided, creates a CloudFront Distribution with the given certificate. If 'true' is provided, then a certificate will be generated. true
buildSpec (Optional) - If provided, will override the default BuildSpec in the CodeBuild project. Accepts either a string value (the filename in the source code) or an object. The object is passed to the BuildSpec.fromObject(). If not provided, see BuildSpec. build-prod.yaml

Design Notes


If a certificate is required to provide HTTPS support then a simple S3 Bucket with website hosting will not work. This construct chooses to put a CloudFront Distribution in front of it when a certificate is required.

If that certificate already exists, it can be supplied as an ICertificate. If not, then it will be created using a DNSValidatedCertificate.

If no certificate is supplied or requested, then the site will be hosted using a public S3 Bucket with Website Hosting enabled. No CloudFront Distribution will be created in that case.

Github Sources

Github source information is provided through props for the construct.

If you'd like to see support for another type of Source action, please open an Issue or a PR.


The default buildspec is defined at DEFAULT_BUILD_SPEC. It uses a Node v12 runtime, runs an npm install and then an npm run build and assumes the static deliverables are in the dist directory.

You may override the BuildSpec with either your own object or by passing a string which will be interpreted as a filename within the source to use.


Please open Pull Requests and Issues on the Github Repo.



Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mbonig.cicd-spa-website, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size mbonig.cicd-spa-website-0.1.2.tar.gz (38.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page