Documentation › Getting Started

Getting Started

This guide explains how to spin up your local environment and deploy your first website changes using our CDK-based task runner pipeline.

1. Prerequisites

Make sure you have installed:

  • Node.js (version 18 or newer)
  • AWS CLI (pre-configured with proper account credentials)
  • just (our preferred multi-platform command runner)

2. Setting Up Your Project

Install root dependencies and navigate to the CDK directory to prepare infrastructure tools:

# Install root dependencies
npm install

# Install CDK dependencies
cd cdk
npm install

3. Local Development

Run the local development server for the static website:

npm run start

This will run Eleventy's serve engine. Open your browser to http://localhost:8080 to see your changes reload in real-time.

4. Deploying to AWS S3 & CloudFront

Ensure you have run npx cdk bootstrap for your AWS account, then use the following task runner commands:

  • Deploy Dev: just push-dev
  • Deploy Certification: just push-cert
  • Deploy Production: just push-prod