docs: Add CI/CD documentation and update README

- Create docs/cicd/README.md with frontend CI/CD overview
- Document all 5 GitHub Actions workflows
- Explain PR preview environment integration with backend
- Point to backend repo for comprehensive CI/CD documentation
- Update main README.md with CI/CD & Deployment section
- Reorganize PR Preview Environments as subsection of CI/CD

Author: lmcdonough

README.md

@@ -159,7 +159,20 @@ For more detailed testing information, see [docs/testing/frontend-testing-strate
 
 ---
 
-## PR Preview Environments
+## CI/CD & Deployment
+
+This project uses GitHub Actions for continuous integration, release builds, and deployment.
+
+- **Branch CI**: Automated linting, testing, and Docker builds on every push/PR
+- **Release Builds**: Multi-architecture production images triggered by GitHub releases
+- **Deployment**: Manual deployment to DigitalOcean via secure Tailscale VPN
+- **PR Previews**: Automatic preview environments for each pull request
+
+📚 **Documentation:** [docs/cicd/README.md](docs/cicd/README.md)
+
+**Note:** The frontend shares CI/CD infrastructure with the backend repository. For comprehensive documentation including PR preview workflows, see the [Backend CI/CD Documentation](https://github.com/refactor-group/refactor-platform-rs/tree/main/docs/cicd).
+
+### PR Preview Environments
 
 This repository automatically deploys **isolated preview environments** for each pull request. When you open a PR, a complete stack (backend + frontend + database) deploys to a dedicated server on our Tailnet for testing before merge.
 
@@ -170,5 +183,3 @@ This repository automatically deploys **isolated preview environments** for each
 - ✅ PR closed/merged → Environment cleans up
 
 **Access:** Requires Tailscale VPN connection. Access URLs are posted as a comment on your PR in the GitHub Web UI.
-
-For detailed information, see the [PR Preview Environments Runbook](docs/runbooks/pr-preview-environments.md).

docs/cicd/README.md

@@ -0,0 +1,80 @@
+# CI/CD Infrastructure - Frontend
+
+## Overview
+
+The Refactor Platform frontend uses GitHub Actions for continuous integration, release builds, and PR preview deployments. The CI/CD infrastructure is shared with the backend repository.
+
+**Quick Stats:**
+- **5 GitHub Actions Workflows** (CI, Release, Deploy, PR Preview x2)
+- **Docker-based Deployment** to GitHub Container Registry (GHCR)
+- **Production Platform:** DigitalOcean (accessed via Tailscale VPN)
+- **Preview Platform:** Raspberry Pi 5 (ARM64, coordinated with backend)
+
+---
+
+## Workflows
+
+### 1. Branch CI Pipeline
+**File:** `.github/workflows/build_and_push_nonproduction_images.yml`
+**Triggers:** Push to main, Pull requests to main
+
+Runs linting, testing, and builds Docker images for non-production branches.
+
+### 2. Production Release Builds
+**File:** `.github/workflows/build_and_push_production_images.yml`
+**Triggers:** GitHub releases (type: released), Manual dispatch
+
+Builds multi-architecture stable images for production deployment.
+
+### 3. Production Deployment
+**File:** `.github/workflows/deploy_to_do.yml`
+**Triggers:** Manual dispatch only
+
+Deploys to DigitalOcean via Tailscale VPN (coordinated with backend deployment).
+
+### 4. Frontend PR Preview
+**File:** `.github/workflows/pr-preview-frontend.yml` (on branch 225)
+**Triggers:** Pull request opened/synchronize/reopened (frontend changes)
+
+Calls the backend repository's reusable workflow to deploy PR preview environments.
+
+**Parameters:**
+- `repo_type: 'frontend'`
+- `pr_number`: PR number
+- `branch_name`: Frontend PR branch
+- `backend_branch`: 'main' (or temporary override)
+
+### 5. Frontend PR Cleanup
+**File:** `.github/workflows/cleanup-pr-preview-frontend.yml` (on branch 225)
+**Triggers:** Pull request closed/merged
+
+Calls the backend repository's reusable cleanup workflow.
+
+---
+
+## PR Preview Environments
+
+Frontend PRs trigger the same preview environment infrastructure as backend PRs. The workflows call reusable workflows in the backend repository:
+
+- **Deployment:** `refactor-group/refactor-platform-rs/.github/workflows/ci-deploy-pr-preview.yml`
+- **Cleanup:** `refactor-group/refactor-platform-rs/.github/workflows/cleanup-pr-preview.yml`
+
+This ensures parity between frontend and backend PR previews - both create isolated full-stack environments with unique ports.
+
+**Access:** Requires Tailscale VPN connection. Preview URLs are posted as PR comments.
+
+---
+
+## Comprehensive Documentation
+
+For complete CI/CD infrastructure documentation, including:
+- Detailed workflow specifications
+- Docker infrastructure guides
+- Database migration workflows
+- Security and secrets management
+- Troubleshooting guides
+- Gap analysis and future improvements
+
+See: **[Backend Repository CI/CD Docs](https://github.com/refactor-group/refactor-platform-rs/tree/main/docs/cicd)**
+
+The backend repository contains the authoritative documentation for the shared CI/CD infrastructure, including the reusable workflows that both repositories use for PR preview deployments.