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`).

docs/Changelog.md

@@ -42,3 +42,13 @@ All notable changes to the Apex Turf landing page.
 - Contact form has no backend/submission endpoint yet.
 - Phone, email, address, and social links are placeholders (none were supplied).
 - Gallery section reuses the four specialty photos in lieu of real installation photography.
+- Two specced pages/flows are not built yet: the gated Maintenance Handbook lead-magnet page, and the
+  3-step turf project/sample-request questionnaire (see `CONTENT-SPECS.md`).
+
+## [Unreleased] — documentation
+
+### Added
+- `docs/CONTENT-SPECS.md`: archived the full content of all 7 unique `pdfs/` specifications as markdown
+  (the 4 used in the build, plus the About Us spec, plus the 2 specs describing not-yet-built pages/flows —
+  the Maintenance Handbook lead magnet and the 3-step sample-request questionnaire). Saved so this content
+  isn't only reachable by re-opening the PDF binaries.

docs/README.md

@@ -18,7 +18,8 @@ dist/
         (resized from ../logos, background-transparent variants)
 docs/
 ├── README.md                 # this file
-└── Changelog.md
+├── Changelog.md
+└── CONTENT-SPECS.md          # all 7 pdfs/ specs archived as markdown (4 used, 2 not-yet-built, 1 duplicate)
 ```
 
 To preview locally: open `dist/index.html` directly in a browser, or serve the folder
@@ -37,7 +38,11 @@ three reference images is represented on one page.
 Copy, section structure, and messaging (headlines, value pillars, "Installers First, Not Salesmen", the
 Apex Guarantee, etc.) are drawn from the four sport-specific and About Us page specifications in `../pdfs/`,
 condensed from full dedicated pages into single-page sections since this build is one landing page rather
-than a multi-page site.
+than a multi-page site. The full content of all 7 PDFs (`../pdfs/` has 8 files, but two golf specs are
+identical duplicates) is archived as markdown in **`CONTENT-SPECS.md`** — including the two specs that
+describe pages *not* built here: a gated "Maintenance Handbook" lead-magnet page, and a 3-step turf
+project/sample-request questionnaire meant to replace the current one-screen quote form. Both are noted as
+follow-up work in that file.
 
 ## Page structure
 
@@ -93,3 +98,7 @@ This is a front-end-only deliverable. Before launch:
   point them at real profiles.
 - **Gallery images are stand-ins.** The showcase/gallery section reuses the four mascot photos for lack
   of real installation photography — swap in real project photos when available.
+- **Two specced pages/flows aren't built at all yet** (full details in `CONTENT-SPECS.md`):
+  1. A gated "Maintenance Handbook" PDF lead-magnet page (email-capture → PDF download).
+  2. A 3-step turf project/sample-request questionnaire meant to eventually replace the current
+     single-screen `#quoteForm`, with supplier-webhook and CRM routing.