🌐 Static Website CI/CD on AWS S3 with GitHub Actions

This project demonstrates how to automatically deploy a static website to an Amazon S3 bucket using GitHub Actions on every push to the main branch.

---

📁 Project Structure

static-app-s3-cicd/
├── .github/
│   └── workflows/
│       └── main.yml        # GitHub Actions workflow
├── index.html              # Homepage HTML
├── styles.css              # Styling
├── script.js               # Frontend JS
└── README.md               # Project documentation

---

🚀 Features

• 📦 HTML, CSS, and JS static site
• 🔁 Automatic deployment to AWS S3
• 🔐 Uses GitHub Secrets for AWS credentials
• 🧼 Syncs with --delete to remove stale files

---

⚙️ CI/CD Workflow

The GitHub Actions workflow does the following:

1. ✅ Checks out the latest code from main
2. 🔐 Configures AWS credentials from GitHub Secrets
3. ☁️ Syncs the static site files to your S3 bucket

Workflow file: .github/workflows/main.yml

on:
  push:
    branches: [main]

---

🌩️ Prerequisites

1. AWS S3 bucket – Create one and make it public/static-site enabled

2. AWS IAM user with s3:PutObject, s3:DeleteObject, and s3:ListBucket permissions

3. GitHub Secrets – Go to Settings → Secrets and variables → Actions, and add:

   • AWS_ACCESS_KEY_ID
   • AWS_SECRET_ACCESS_KEY

---

🔧 How to Use

1. Fork or clone this repository

2. Replace contents of:

   • index.html, styles.css, and script.js with your own site

3. Update the S3 bucket name in main.yml:

aws s3 sync . s3://<your-bucket-name> --delete

4. Push to main → GitHub Actions will deploy it automatically

---

🌍 Access Your Website

After a successful push, your static site will be available at:

http://<your-bucket-name>.s3-website-<region>.amazonaws.com

Example: http://jak-aws-bucket.s3-website-us-east-1.amazonaws.com

---

🧪 Tech Stack

• HTML / CSS / JS
• AWS S3
• GitHub Actions

---

📄 License

MIT License

---

🙋‍♂️ Author

Amit Kumar 🔗 GitHub