# Content Development Guide

Supporting material for populating executionspace.com with real content. Pair this with
`COPY-DECK.md` (the approved copy) and the design comps in `/comps/`.

---

## Brand facts (use these, verbatim where possible)

| | |
|-|-|
| Name | Execution Space |
| What it is | Digital commerce consultancy / agency — Shopify builds, ecom strategy & execution. **Marketing/portfolio site, not an ecommerce store.** |
| Positioning line (live) | "Experience that Transforms." · eyebrow: "Digital Commerce Consultancy" |
| Hero treatment (comps) | `ecom.exe` — "ecom" white, ".exe" yellow |
| Subheads in play | "Seamless execution for your digital commerce needs" · "We lead with strategy, embed with your team, and see the work through." |
| Venture of | Little Rocket (`littlerocket.io`) |
| Primary contact | hello@executionspace.com |

### Voice
Direct, confident, execution-focused. "We don't just advise / think outside the box — we
execute / inspire new possibilities." Trust · Approach · Results is the core narrative spine
(see copy deck). Avoid hype without substance; every claim should ladder to a tangible outcome.

### Design tokens (production truth)
- Font: **Figtree** (Google Fonts). Mono accents: DM Mono.
- Yellow: **`#FFCD05`** (the live site & `es-tokens.css` use this; an older Milton brief cites
  `#FFD600` — defer to `#FFCD05`).
- Dark sections: `#1A1A1A` / `#2B2B2B`. Body text: `#0A0A0A` on white, `#F3F3F3` on dark.
- Full token set: `_components/es-tokens.css` and `docs/THEME-GUIDE.md`.

---

## ⚠️ Real vs. placeholder (important)

Some design comps contain **demo content that is NOT approved and must not ship**:

| Placeholder in comps | Reality |
|----------------------|---------|
| Clients **Allbirds, Stüssy, Ridge** (`comps/homepage.html` "Our Work") | ❌ Demo only. Real case studies are **LFL Group, BRNT Designs, Superette, Redecan, Porte Mode**. |
| Hero stats **$2B+ / 40+ / 8yr** | ❌ Unverified placeholders. Do not publish stats until Erik confirms real figures. |
| `site-onepager.html` "execution gap" copy + **67% / 9-in-10 / 3×** stats | ❌ Off-brand experiment with fabricated stats. Not approved. |
| Comp Turnstile sitekey `0x4AAAAAAABFXqEWnm_qy_Gb` / field `token` | ❌ Use the **production** worker contract instead (below). |

### Production contact-form contract (live, working)
- Endpoint: `https://es-contact.execution-space.workers.dev/`
- Turnstile sitekey: `0x4AAAAAACoLn8uTFd09zfKA`
- POST JSON body: `{ name, email, message, turnstileToken }` — the field **must** be
  `turnstileToken` (the Worker reads that exact key). Creates a Freshdesk ticket.
- Full copy-deck form has more fields (First/Last, Company, Phone, Consent); the live worker
  currently accepts name/email/message — extend the worker if the full field set is needed.

---

## Per-page content status

| Page | Copy source | Status |
|------|-------------|--------|
| Home — hero | Copy deck (3 slider concepts) or live "Experience that Transforms" | ✅ Approved copy exists |
| Home — approach | Copy deck → Trust/Approach/Results | ✅ |
| Home — services | Copy deck → Technology/Strategy/Design/Marketing | ✅ |
| Home — work highlights | Real case studies | ⚠️ Erik to supply highlight blurbs + assets |
| Services (detail) | Copy deck → long-form service copy (in master Doc) | ✅ copy / ⚠️ pull long-form from Doc |
| Case studies | Master Case Studies sheet + per-client Docs | ⚠️ Needs formatting into comp template |
| About / Profile | — | 🔜 v2 release |
| Contact | Copy deck fields | ✅ / ⚠️ worker field parity |
| Programs | Digital Transformation · Growth/Strategy · IT Partner | ✅ stubs |
| Blog / Posts | Categories: Process/Service/Solution/Update | 🔜 needs articles |

---

## Open content decisions for Erik
1. **Hero direction:** keep live "Experience that Transforms." or adopt copy-deck slider
   (Digital Transformation / Powering Growth / Partners in IT) or the comp's `ecom.exe`?
2. **Stats:** provide real, citable figures or omit the stats band.
3. **Case study highlights:** which 2–3 to feature on the homepage, with one-line results.
4. **Contact fields:** ship the full 7-field form (extend the worker) or keep name/email/message?

---

## Resource links
See `COPY-DECK.md` → "Source resources" for the master Google Doc, Material spreadsheets,
case-study template, and Figma boards.