diff --git a/docs/CONTENT-SPECS.md b/docs/CONTENT-SPECS.md new file mode 100644 index 0000000..82934c7 --- /dev/null +++ b/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`). diff --git a/docs/Changelog.md b/docs/Changelog.md index fa57c75..752e011 100644 --- a/docs/Changelog.md +++ b/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. diff --git a/docs/README.md b/docs/README.md index 07ec793..e110379 100644 --- a/docs/README.md +++ b/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.