Add GitHub Actions workflow for Docker image publishing

- Automated Docker image builds on push to main
- Multi-architecture support (amd64, arm64)
- Publish to GitHub Container Registry (GHCR)
- Build caching for faster builds
- Artifact attestation for supply chain security
- Semantic versioning support with tags
- Manual workflow dispatch option
- Updated README with CI/CD documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

README.md

@@ -48,7 +48,19 @@ Visit [http://localhost:3000](http://localhost:3000) to see the site.
 
 ## Docker Deployment
 
-Build and run with Docker:
+### Using Pre-built Image from GHCR
+
+The Docker image is automatically built and published to GitHub Container Registry on every push to main:
+
+```bash
+# Pull and run the latest image
+docker pull ghcr.io/valknarness/kit-ui:latest
+docker run -p 80:80 ghcr.io/valknarness/kit-ui:latest
+```
+
+### Build Locally
+
+Or build and run locally:
 
 ```bash
 # Build the image
@@ -58,7 +70,16 @@ docker build -t kit-landing .
 docker run -p 80:80 kit-landing
 ```
 
-Or with docker-compose (see `/home/valknar/Projects/docker-compose/kit/compose.yaml`).
+### Docker Compose
+
+For production deployment, see `/home/valknar/Projects/docker-compose/kit/compose.yaml`.
+
+### Available Tags
+
+- `latest` - Latest build from main branch
+- `main` - Main branch builds
+- `v*` - Semantic version tags (e.g., `v1.0.0`)
+- `<branch>-<sha>` - Branch-specific builds with commit SHA
 
 ## Project Structure
 
@@ -110,9 +131,49 @@ Tailwind CSS 4 uses a new CSS-first configuration approach:
 
 ## Available Tools
 
-- **Vert** - Minimalist pastebin for code snippets
+- **Vert** - Privacy-focused file converter (images, audio, documents)
 - **Paint** - Browser-based image editor
 
+## CI/CD Pipeline
+
+The project uses GitHub Actions for automated Docker image builds:
+
+### Workflow Features
+
+- ✅ **Automated builds** on push to main and tags
+- ✅ **Multi-architecture support** (linux/amd64, linux/arm64)
+- ✅ **GitHub Container Registry** (GHCR) publishing
+- ✅ **Build caching** for faster builds
+- ✅ **Artifact attestation** for supply chain security
+- ✅ **Semantic versioning** support
+
+### Triggering Builds
+
+```bash
+# Automatic build on push to main
+git push origin main
+
+# Create a versioned release
+git tag v1.0.0
+git push origin v1.0.0
+
+# Manual trigger via GitHub Actions UI
+# Go to Actions → Build and Push Docker Image → Run workflow
+```
+
+### Using the Published Image
+
+```bash
+# Latest from main branch
+docker pull ghcr.io/valknarness/kit-ui:latest
+
+# Specific version
+docker pull ghcr.io/valknarness/kit-ui:v1.0.0
+
+# Specific commit
+docker pull ghcr.io/valknarness/kit-ui:main-abc1234
+```
+
 ## Performance
 
 - Static export for fast loading