update memory docs

docs/CONTENT-SPECS.md

@@ -0,0 +1,156 @@
+# Source Content Specs (archived from `pdfs/`)
+
+The `pdfs/` folder holds seven page specifications for a full multi-page Apex Turf site. The landing page
+in `dist/` (per `AGENT.md`) only needed one page, built from the mockups in `website-ideas/` and condensed
+copy from four of these specs. This file archives the **essential content of all seven PDFs in markdown**
+so that content survives without needing to reopen the binaries, and so the two specs that were **not**
+used in the current build aren't lost.
+
+There were 8 files in `pdfs/`; `golf_page_specification (1).pdf` and `golf_page_specification.pdf` are
+identical duplicates, so only one is summarized below.
+
+## Used in the current landing page
+
+### Residential Landscaping (`residential_page_specification.pdf`)
+- **Goal:** Convert homeowners via premium positioning ("The King of Lawns"), family/pet needs, honest
+  maintenance expectations, drive to quote questionnaire.
+- **Nav:** Landscaping (active) | Pádel | Football | Golf | Gallery | About Us · CTA: *Get Samples & Quote*
+- **Hero:** Lion on a lush residential lawn, modern house + timber fencing.
+  - H1: *The King of Lawns: Premium Residential Turf Installations*
+  - Sub: *Transform your mud-pit, patchy lawn, or tired garden into a flawless, evergreen sanctuary —
+    engineered for family life and built to last across Spain.*
+  - CTA: *Build Your Project & Claim Free Samples*
+- **Value pillars:** Child & Family Safe · Pet-Friendly Systems · Built for Spanish Weather ·
+  **Low Maintenance, Not No Maintenance** (throw away the mower/weed killer; upkeep = brush, clear leaves,
+  occasional rinse; optional pro maintenance).
+- **Lifestyle quote:** *"Whether you have high-energy dogs tearing up the grass, kids needing a safe space
+  to play, or you just want a stunning, low-maintenance outdoor lounge area to relax and entertain in — we
+  match the exact turf model to your unique lifestyle."*
+- **Gallery prompt:** *"Want to see what this could look like in your yard? Tell us about your space
+  below."*
+- **Closing CTA:** *Ready to Upgrade Your Garden?* → *Start Questionnaire & Get Free Samples*
+
+### Pádel Court (`padel_page_specification.pdf`)
+- **Goal:** Capture club managers/court owners via resurfacing expertise, seam durability, color choice.
+- **Nav active:** Pádel · CTA: *Get Samples & Quote*
+- **Hero:** Shark launching out of a blue pádel court under stadium lights.
+  - H1: *Apex Performance: Professional Pádel Turf & Court Resurfacing*
+  - Sub: *Built for explosive footwork, rapid drainage, and intense tournament play. We don't just lay
+    turf — we engineer courts that outlast the competition.*
+  - CTA: *Request Court Audit & Samples*
+- **"Is Your Court Turf Failing Early?"**: heavy play/sliding/pivoting wears courts; balding, slipping,
+  seam-tearing surfaces need replacing.
+- **Apex Advantage:**
+  - *Proprietary Assembly System & Durability* — reinforces seams/joints where traditional installs fail.
+  - *Custom Color Ranges* — blue, black, terracotta, green, custom two-tone layouts.
+- **Tech specs:** Optimized sand infill & bounce · Rapid weather drainage (porous backing, courts playable
+  minutes after rain).
+- **Closing CTA:** *Ready to Resurface Your Court?* → *Start Questionnaire & Get Samples*
+
+### Football & Multisport (`football_page_specification.pdf`)
+- **Goal:** Attract club managers/facility operators via 5-a-side pitch engineering, multisport layouts.
+- **Nav active:** Football · CTA: *Get Samples & Quote*
+- **Hero:** Panther prowling a football pitch with pro markings.
+  - H1: *Apex Football: High-Performance Pitches & Multisport Surfaces*
+  - Sub: *Engineered for explosive speed, heavy multi-directional traction, and professional ball-roll.
+    From high-intensity 5-a-side arenas to versatile multisport complexes.*
+  - CTA: *Request Pitch Audit & Samples*
+- **"Built for the Speed of Small-Sided Football"**: handles friction/pivots/slide-tackling; optimal
+  traction and natural ball behavior.
+- **Custom Designs & Multisport Versatility**: custom layouts, integrated line markings, flexible
+  multisport zones (football + basketball + training) per facility/branding.
+- **Tech specs:** High-density wear resistance (monofilament fibers) · Shock-absorbing underlayers
+  (reduce joint impact/fatigue).
+- **Closing CTA:** *Ready to Build or Resurface Your Pitch?* → *Start Questionnaire & Get Samples*
+
+### Golf & Putting Greens (`golf_page_specification.pdf`, duplicate `(1)` removed)
+- **Goal:** Target luxury villa owners/golf enthusiasts via precision greens, Stimp-rated roll, custom
+  contours.
+- **Nav active:** Golf · CTA: *Get Samples & Quote*
+- **Hero:** Eagle beside a flawless backyard putting green.
+  - H1: *Apex Golf: Custom Putting Greens for Luxury Villas*
+  - Sub: *Bring the course to your backyard. Precision-engineered putting greens built for true roll,
+    flawless breaks, and championship performance at home.*
+  - CTA: *Request Green Design & Samples*
+- **"Your Personal Practice Facility at Home"**: custom greens tailored to villa layout, Stimp-rated roll,
+  realistic break contours, zero-maintenance year-round.
+- **Apex Golf Advantage:** True Ball Roll & Speed (texturized fibers) · Custom Contours & Breaks
+  (undulations, slopes, cup placement) · All-Weather Durability (UV-stabilized, fast sub-base drainage) ·
+  Professional Installation Standards (laser-leveled sub-base, fringe integration, flush cup fittings).
+- **Closing CTA:** *Ready to Build Your Dream Backyard Green?* → *Start Questionnaire & Get Samples*
+
+### About Us (`about_us_page_specification.pdf`)
+- **Goal:** Build trust — Apex Turf as elite installation specialists, not box-shift suppliers.
+- **Nav active:** About Us · CTA: *Get Samples & Quote*
+- **Hero:** Team on-site / brand identity visual.
+  - H1: *Master Installers. Absolute Precision. Built For Life.*
+  - Sub: *We aren't just selling rolls of grass — we are master craftsmen and professional turf specialists
+    dedicated to building surfaces that perform flawlessly and last.*
+  - CTA: *Let's Discuss Your Project*
+- **"Installers First, Not Salesmen"**: partner directly with Europe's most trusted premium turf
+  manufacturers to source the exact material each project demands (family landscaping, tournament-grade
+  pádel, 5-a-side pitch, luxury villa green).
+- **"No One-Size-Fits-All Solutions"**: no generic price lists — custom, transparent quotes per space,
+  sub-base requirements, performance goals.
+- **The Apex Guarantee:** Reliable & Trustworthy (on time, clear communication, respectful of property) ·
+  Satisfaction Guaranteed (backed by installation standards + manufacturer warranties).
+- **Closing CTA:** *Ready to Work With Professionals?* → *Start Questionnaire & Get Samples*
+
+## Not yet built — future pages
+
+These two specs describe pages/flows that are **out of scope for the current one-page landing site** and
+were not implemented. Keeping them here so the work isn't lost.
+
+### Maintenance Guide & Lead Magnet (`maintenance_guide_specification.pdf`)
+A **downloadable PDF lead magnet** ("The Official Apex Turf Care & Maintenance Handbook") offered in
+exchange for an email address — a classic lead-gen funnel, not part of the landing page itself.
+
+- **Landing page for the magnet:** Hero *"Protect Your Investment: The Official Apex Turf Care Guide"* +
+  a simple Name/Email capture form + button *Download Free Guide Instantly*.
+- **Value prop:** turf eliminates mowing/watering, but light routine care maximizes lifespan and keeps
+  fibers/performance pristine.
+- **Handbook contents (page-by-page):**
+  - *Cover & Introduction* — "The Golden Rule": low maintenance ≠ no maintenance; light upkeep prevents
+    matting and protects drainage.
+  - *Residential Lawn Care* — non-wire brooms to cross-brush high-traffic zones; clear leaves/debris with
+    flexible rakes or blowers.
+  - *Pet-Friendly Care* — routine water rinsing keeps backing/sub-base fresh; eco-friendly enzyme cleaners
+    in hot months if needed.
+  - *Sports Surfaces (Pádel & Football)* — maintain proper silica sand levels for bounce/sliding; inspect
+    high-impact zones (baselines, penalty spots).
+  - *When to Call the Professionals* — heavy mechanical rejuvenation (deep brushing, sanitizing, infill
+    replenishment, "EcoLazr" surface cleaning) as an upsell for a professional reset.
+- **CTA:** *Deploy Maintenance Lead Magnet* — automates capturing homeowner/club-manager emails.
+
+**To implement later:** a dedicated landing page + gated PDF download + email-capture integration (e.g.
+Mailchimp/ConvertKit/a serverless function), separate from the current quote form.
+
+### Turf Project & Sample Request — Multi-Step Questionnaire (`turf_questionnaire_supplier_spec.pdf`)
+A **3-step form** intended to replace the current single-screen quote form referenced by every page's
+*"Get Samples & Quote"* CTA. Captures high-intent specs, auto-routes sample fulfillment to the turf
+supplier, and logs the lead in a CRM.
+
+- **Step 1 — About Your Space:**
+  1. Area type (radio/image-select): Backyard/Garden · Front yard · Balcony/Rooftop/Terrace · Pool
+     surround · Commercial/Business space · Sports area/Play zone.
+  2. Approximate size (text input, e.g. "50m², 5×4 meters, or 'Not sure'").
+  3. Current surface condition (radio): natural grass/dirt · concrete/paving/tiling · old artificial turf ·
+     other/uneven ground.
+- **Step 2 — Lifestyle & Usage:**
+  4. Intended use (multi-select checkbox): relaxing/family lounging · children's play area · pets · dining/
+     entertaining · decorative/low-traffic.
+  5. Pets using the turf (radio): dogs · cats/other · no pets.
+  6. Expected foot traffic (radio): low · medium · high.
+- **Step 3 — Free Samples & Contact Info:**
+  7. Send free samples? (yes/no toggle).
+  8. Contact details (required): full name, email (validated), phone (validated), postal/delivery address
+     (**conditional** — only shown if Q7 = yes), preferred contact method (Phone/Email/WhatsApp).
+- **Developer/automation notes:**
+  - If Q7 = "Yes", auto-dispatch a webhook/email with name + delivery address straight to the turf
+    supplier's fulfillment system.
+  - Dual-notification: full project summary to internal CRM/sales, fulfillment-only snippet to supplier.
+  - Hide the postal-address field entirely when samples are declined, to reduce abandonment.
+
+**To implement later:** replace `dist/index.html`'s single-screen `#quoteForm` with this 3-step flow (or
+link out to a dedicated `/quote` page/tool) once a backend/CRM/supplier-webhook integration exists to
+receive it — the current form has no backend at all (see `README.md`).