docs: README with deploy workflow

cd28405f6fecbea1a12778af5613a7c5a1a18152 · 2026-04-23 11:15:26 -0700 · Steve Abrams
Files touched

A README.md
Diff

commit cd28405f6fecbea1a12778af5613a7c5a1a18152
Author: Steve Abrams <steveabramsdesigns@gmail.com>
Date:   Thu Apr 23 11:15:26 2026 -0700

    docs: README with deploy workflow
---
 README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..38b7f21
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+# Forza
+
+Website mockups for **forza.legal** — a boutique Costa Rica law, tax &amp; outsourcing firm.
+
+## Live site
+**https://forza.agentabrams.com** (once SSL is provisioned)
+
+## Source of truth
+**Kamatera server** (`45.61.58.125`) is canonical. Git workflow:
+
+```
+local (~/Projects/Forza)
+        │
+        │  git push origin main
+        ▼
+Kamatera bare repo (/root/git/Forza.git)
+        │
+        │  post-receive hook
+        ▼
+/var/www/forza.agentabrams.com  ← nginx serves
+```
+
+Any edit anywhere must be committed &amp; pushed to Kamatera to become live.
+Local working copy is ephemeral — clone from Kamatera if lost:
+
+```bash
+git clone ssh://root@45.61.58.125/root/git/Forza.git ~/Projects/Forza
+```
+
+## Structure
+
+```
+Forza/
+├── index.html                      # Theme comparison landing page
+├── theme-1-alliott-global/         # Theme 1: white + cobalt, Inter sans
+├── theme-2-bilingual-split/        # Theme 2: EN/ES dual-column hero
+└── theme-3-costa-rica-modern/      # Theme 3 (WINNER): Pacific blue + jade + Fraunces
+    ├── index.html                  # Homepage
+    ├── shared.css                  # Shared tokens + nav + footer
+    ├── contact/                    # /contact/
+    ├── about/                      # /about/ (planned)
+    └── services-legal/             # /services/legal/ (planned)
+```
+
+## Design tooling
+- **Figma**: [Forza Figma file](https://www.figma.com/design/Nw1KSLDuAjo53uQQI11u8p) — captures live in file via Figma MCP
+- **Paper**: local design drafts
+- Design work happens locally in Figma/Paper → translated to HTML → pushed to Kamatera
+
+## Deploy workflow
+
+```bash
+cd ~/Projects/Forza
+# edit files...
+git add -A && git commit -m "describe change"
+git push origin main           # auto-deploys via post-receive hook
+```
+
+## Infrastructure
+- **Server**: Kamatera `45.61.58.125` (n8nserver1, Ubuntu 22.04)
+- **DNS**: agentabrams.com on GoDaddy — `forza` A record → 45.61.58.125
+- **nginx vhost**: `/etc/nginx/sites-enabled/forza.agentabrams.com`
+- **SSL**: Let's Encrypt via certbot (provisioned after DNS propagates)
← 2817022 Initial: 3 theme mockups + contact page · back to Forza · feat: Contact, About, Services/Legal pages (Theme 3) 2b3e042 →