Important AWS Secrets Required

Before deploying, add these secrets to your GitHub repository:

Lambda Setup (One-Time)

Before the first deployment, create the Lambda function:

cd client/infrastructure

# Create placeholder zip
echo "" | zip placeholder.zip -

# Initialize and apply Terraform
terraform init
terraform apply

This creates:

• Lambda function: pixora-nextjs-ssr
• IAM role with S3 and CloudWatch permissions
• Lambda Function URL for CloudFront origin

CloudFront Configuration

After Lambda is created, configure CloudFront behaviors:

1. Default behavior → Lambda Function URL origin
2. /_next/static/* → S3 origin (static assets)
3. /api/* → EKS backend origin

Local Development

npm install
npm run dev

Build

# Standard Next.js build
npm run build

# OpenNext build for AWS
npm run build:open-next

Deployment

Deployments are automated via GitHub Actions when pushing to main branch. Manual deployment:

npm run build:open-next

# Deploy Lambda
cd .open-next/server-function
zip -r ../../lambda.zip .
aws lambda update-function-code \
  --function-name pixora-nextjs-ssr \
  --zip-file fileb://../../lambda.zip

# Deploy static assets
aws s3 sync .open-next/assets s3://imageopt-website-329599656829-us-east-1/_next

work ci/cd