Website Deploy

Website Deploy Skill

You are running the /grc-portfolio:deploy skill. Your job is to build the website and deploy it to the AWS infrastructure created by /grc-portfolio:infra.

Step 1: Locate and Validate Config

Find site-config.json:

• Check $ARGUMENTS for a project directory path
• Check the current working directory
• Ask the user if not found

Read it and validate that status.infraDeployed === true. If not, tell the user to run /grc-portfolio:infra first.

Also validate that status.buildComplete === true. If not, tell the user to run /grc-portfolio:build first.

Extract needed values:

• aws.bucketName
• aws.distributionId
• aws.profile
• aws.contactApiEndpoint (if contact form enabled)
• aws.cloudFrontUrl
• aws.domain (if custom domain)

Step 2: Set Environment Variables (if contact form)

If features.contactForm is true and aws.contactApiEndpoint is set, ensure .env in the project directory contains:

VITE_CONTACT_API_ENDPOINT=<aws.contactApiEndpoint>

Update the file non-destructively — do not overwrite an existing .env:

1. If .env does not exist, create it with just this line.
2. If .env exists and already has a VITE_CONTACT_API_ENDPOINT= line, replace only that line.
3. If .env exists but does not contain VITE_CONTACT_API_ENDPOINT=, append the line.

Preserve any other variables the user has set (e.g. VITE_GA_ID, analytics keys, feature flags).

Step 3: Build the Site

cd <projectDir>
npm run build

Verify the dist/ directory was created and contains files.

If the build fails, diagnose and fix the issue.

Step 4: Deploy to AWS

Use the toolkit's deploy script:

$TOOLKIT_DIR/scripts/deploy.sh <aws.bucketName> <aws.distributionId> <aws.profile>

Run this from the project directory (it expects dist/ in the current working directory).

Step 5: Verify Deployment

Wait a moment for CloudFront to propagate, then tell the user their site is live.

Provide the URL:

• If custom domain: https://<aws.domain>
• Otherwise: https://<aws.cloudFrontUrl>

Step 6: Update Config

Update site-config.json:

• Set status.siteDeployed = true

Step 7: Summary

Tell the user:

• The site is deployed and live
• Provide the live URL
• Note that CloudFront cache invalidation takes 1-2 minutes to fully propagate
• Suggest running /grc-portfolio:repo to create a GitHub repo (if not done)
• Suggest running /grc-portfolio:cicd to set up automatic deployments on push

Variables

• $TOOLKIT_DIR = read from site-config.json toolkitDir field
• $ARGUMENTS = arguments passed after /deploy (expected: project directory path)