Web App Deployment

ChurchApps web applications are deployed as static sites to Amazon S3 with CloudFront as the CDN. Deployments are automated through GitHub Actions, but can also be run manually when needed.

Before You Begin

• Set up the web app locally and verify it builds -- see Web Apps
• Configure AWS credentials with S3 and CloudFront access
• Know the target S3 bucket name and CloudFront distribution ID

Deployment Steps

1. Build the app -- generate the static output:

   npm run build

2. Sync to S3 -- upload the build output to the S3 bucket:

   aws s3 sync build/ s3://bucket-name

3. Invalidate CloudFront -- clear the CDN cache so users receive the latest version:

   aws cloudfront create-invalidation --distribution-id YOUR_DIST_ID --paths "/*"

Automated Deployments

GitHub Actions workflows handle deployment automatically on push to the main branch. The workflow performs all three steps above -- build, S3 sync, and CloudFront invalidation -- without manual intervention.

정보

You typically do not need to run these commands manually. Merging a pull request into main triggers the automated deployment pipeline.

팁

If you need to verify a build locally before deploying, run npm run build and inspect the output in the build/ directory. You can serve it locally with any static file server to confirm everything works.

Related Articles

• Web Apps -- Setup guides for B1Admin, B1App, and LessonsApp
• API Deployment -- Deploying the backend APIs
• Mobile Deployment -- Deploying mobile apps to app stores