diff --git a/CLAUDE.md b/CLAUDE.md
index 1ab0535..bd743d0 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,8 +1,13 @@
 # CLAUDE.md
 
+## Important Rules
+
+- **Always update `CLAUDE.md` and `README.md`** when making changes that affect project structure, commands, deployment, tooling, or conventions. Keep them in sync.
+- Do not include co-author lines or "Generated by" attributions in commit messages.
+
 ## Project Overview
 
-Lofty is a 501(c)(4) social welfare organization connecting creative professionals with the progressive movement. This repo is the **pre-launch landing page** — a single-page static site to collect email signups.
+The Lofty Project is a 501(c)(4) connecting creative talent with leftist organizing. This repo is the **pre-launch landing page** — a single-page static site with interest signup links.
 
 **Stack:** Astro 5 (static output), TypeScript, Bun 1.3+
 
@@ -11,10 +16,13 @@ Lofty is a 501(c)(4) social welfare organization connecting creative professiona
 ```
 src/
   layouts/Layout.astro   # HTML shell, meta tags, Typekit fonts, design tokens, CSS reset
-  pages/index.astro      # All page sections (hero, pillars, signup form, footer), scoped CSS, client JS
+  pages/index.astro      # All page sections (hero, pillars, signup, footer), scoped CSS, client JS
 public/
   favicon.svg            # Stylized "L" mark
+  hero-bg.webp/.jpg      # Hero background image (WebP + JPEG fallback)
 astro.config.mjs         # Static output, site URL, dev toolbar disabled
+wrangler.toml            # Cloudflare Pages deployment config
+.gitea/workflows/        # CI/CD via Gitea Actions
 ```
 
 Two-file architecture: `Layout.astro` (global concerns) + `index.astro` (all content). No component files — single page with no reuse opportunity.
@@ -27,6 +35,16 @@ bun run build     # Static build to dist/
 bun run preview   # Preview production build
 ```
 
+## Deployment
+
+Deploys to **Cloudflare Pages** via Gitea Actions on push to `main`.
+
+```bash
+bun run deploy    # Build + deploy to Cloudflare Pages (manual)
+```
+
+Config lives in `wrangler.toml`. CI requires `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` as Gitea secrets.
+
 ## Linting & Formatting
 
 Uses **Biome** for both linting and formatting.
@@ -53,8 +71,6 @@ Format: `type(scope): subject`
 bun run commit    # Guided commit via commitizen (cz-git)
 ```
 
-Do not include co-author lines or "Generated by" attributions in commit messages.
-
 ## Git Hooks (Lefthook)
 
 - **pre-commit:** Biome check on staged files
@@ -63,19 +79,17 @@ Do not include co-author lines or "Generated by" attributions in commit messages
 
 ## Design Tokens
 
-Colors, typography, and spacing are defined as CSS custom properties in `Layout.astro`:
+Colors, typography, spacing, and easing are defined as CSS custom properties in `Layout.astro`:
 
 - **Colors:** cream (#F5F0EB), dusty-rose (#C48B8B), slate-blue (#8A9BB5), navy (#1A1F2E)
 - **Fonts:** `neue-haas-grotesk-display` (body, weight 500), `meno-text` (display/headings) via Typekit
 - **Spacing/type:** Fluid scales using `clamp()`
-
-## Environment Variables
-
-- `PUBLIC_SIGNUP_ENDPOINT` — Form submission endpoint (defaults to `/api/signup`). See `.env.example`.
+- **Easing:** `--ease-out-quart` (hover), `--ease-in-out` (layout/entrance animations)
 
 ## Key Patterns
 
 - All scroll animations use `.reveal` class + IntersectionObserver (threshold 0.1, -40px root margin)
-- Hero animations are CSS-only with staggered delays via `--i` custom property
+- Hero animations: line-by-line blur-in reveal with staggered delays, quartic ease-out
+- Hover interactions use `--ease-out-quart`, layout/entrance animations use `--ease-in-out`
 - `prefers-reduced-motion` is detected via inline script and disables all animations via `.reduce-motion` class
-- Form handler uses progressive enhancement — works as standard POST without JS
+- Hero background image uses blur + desaturation + cream overlay for glassmorphic effect
diff --git a/README.md b/README.md
index ea608f8..34cb8e0 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,16 @@ bun run build     # Static build to dist/
 bun run preview   # Preview production build
 ```
 
+## Deployment
+
+Deploys to Cloudflare Pages via Gitea Actions on push to `main`. To deploy manually:
+
+```sh
+bun run deploy    # Build + deploy to Cloudflare Pages
+```
+
+Requires `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` (set as Gitea secrets for CI, or via `wrangler login` locally).
+
 ## Linting & Formatting
 
 ```sh
diff --git a/package.json b/package.json
index 391a992..466170b 100644
--- a/package.json
+++ b/package.json
@@ -12,6 +12,7 @@
         "format": "biome format --write .",
         "format:check": "biome format .",
         "commit": "cz",
+        "deploy": "astro build && wrangler pages deploy",
         "prepare": "lefthook install"
     },
     "dependencies": {