# Pool Pro Presence — Full Site Documentation

## Overview

Pool Pro Presence builds and manages websites and digital presence for U.S. pool service professionals (cleaners, builders, repair, renovators, openings/closings, pool covers, commercial accounts) so homeowners find them and call them first — not the competition.

**Positioning line**: *Your web presence. Owned. Optimized. Always working.*

**Core principle**: We sell the absence of a problem (no more lost calls, no more DIY disasters, no more outdated listings, no more tech overwhelm). We do not sell "websites" or "website management" as a commodity.

**Lead-with-pain rule**: Every page, hero, ad, and email starts from a pain the pool pro is feeling — *not* from features.

**Brand origin**: John, the founder and dedicated webmaster, has 30+ years in web development. His family sold pool covers for 20 years; he watched good pool pros lose work because their site looked like 1998 — or didn't exist at all. Pool Pro Presence exists so that doesn't keep happening.

**Operating mode**: AI-assisted, human-supervised. Online-first business serving the U.S. nationally. Spanish (`/es/`) mirrors the English product ladder and main marketing pages (home, pricing, audit, starter-kit, full-presence, about, contact, demo-gallery, market-analyzer).

**Website**: https://www.poolpropresence.com
**Public email**: hello@PoolProPresence.com (HTML-entity encoded on-page to resist scraping)
**Member email**: members@PoolProPresence.com
**Social**: X, LinkedIn, Facebook, Reddit (tracked vanity links via `/x/`, `/linkedin/`, `/facebook/`, `/reddit/`)

---

## The Product Ladder (4 offers)

The full ladder is **Free Audit -> Starter Kit -> Web Presence ($149/mo) -> Web Presence + Directories ($298/mo)**. A separate, limited-beta track adds **Beta (free month)** above the ladder for qualified referrals. Every visitor must be able to find their right rung from any page.

### 1. Free Web Presence Audit (lead magnet) — `/audit/`

- **Public name**: Free Web Presence Audit for Pool Pros
- **Price**: Free
- **Audience**: Pool pros not yet ready to buy; skeptical / comparison-shopping traffic; cold ad / SEO traffic
- **Promise**: A no-cost written report on how the pool pro's current web presence is performing — what's working, where the holes are, and the specific actions Pool Pro Presence would take to fix them
- **Capture form**: Full name, email, business website URL (optional if no site yet), city/state, primary service
- **Delivery**: Manually produced written report, emailed within 5 business days
- **Primary CTA**: Get My Free Audit
- **Secondary CTA on the page**: Web Presence ($149/mo)
- **No call required**; ALTCHA + honeypot + timestamp anti-bot

### 2. Pool Pro Presence Starter Kit — `/starter-kit/`

- **Price**: $697 one-time
- **Audience**: Pool pros who want a real site but do not want a subscription — often DIY/Wix/Squarespace converts who want a clean handoff
- **Deliverable**: A custom-built, mobile-first, conversion-focused website — the deliverables of Month 1 of the monthly service, with no ongoing involvement
- **Includes**: Custom design (no templates), local-SEO foundations baked in (titles/meta/sitemap/structured data/mobile speed), conversion-focused copy, all source files, clear handoff instructions, 30-day fix-it window for honest defects
- **Hosting**: Customer hosts wherever they want; temporary hosting bridge can be arranged on request
- **Order form**: Full name, email, business name, city/state, primary service, current site URL (optional), notes
- **Primary CTA**: Order My Starter Kit — $697
- **Honest caveat surfaced on the page**: If the pro wants ongoing changes/SEO/marketing/directory work, the monthly plan is the better fit

### 3. Web Presence — `/pricing/` (and homepage)

- **Price**: $149/month or $1,788/year
- **Promise**: Their full web presence handled end-to-end so they can focus on pools
- **Includes**: Custom-built website (no templates), **forever hosting** (hosting included as long as they're a member -- until they cancel; no separate hosting line item), **Site Parking** (park your site to pause monthly billing for as long as they want; site stays live; when they need updates again they pay for a month of service at their tier), security + maintenance, local SEO, unlimited Trello-driven change requests (one active at a time, most ship in 48 hours / often same-day), monthly call/lead snapshot, dedicated webmaster (John)
- **Excludes**: Direct management of Google Business Profile and major directories (those live on the $298/mo tier)
- **Primary CTA**: Get Your Site — $149/mo (links to members portal)
- **Secondary CTA**: Get My Free Audit
- **Guarantee**: 100% money-back guarantee for the first 30 days. No setup fees. No long-term contracts.

### 4. Beta — `/beta/` (free month trial, limited spots)

- **Access**: Requires an access code (request via form or already have one)
- **Offer**: One free month of Web Presence — custom site, site parking, email forwarding, unlimited changes, hosting. In exchange: honest feedback at 30 days and a referral if earned.
- **Promise**: A real test run with no strings — if it's not working, they keep what we built and walk away.
- **Code friction**: Codes are limited; requests reviewed in order. Existing code holders skip directly to the member portal.
- **Form**: Full name, email, zip, one-sentence description of current web situation. ALTCHA + honeypot + timestamp anti-bot. Processed via the same Appwrite Function as contact/audit/starter-kit.
- **What they get during the free month**: custom-built site, site parking, email forwarding, unlimited change requests via Trello, forever hosting, active local SEO
- **After 30 days**: seamless transition to $149/mo or $298/mo; or site parks automatically (30-day grace), then stays parked until they resume with a month of service
- **Primary CTA**: Request My Access Code
- **Secondary CTA**: Go to Member Portal (for those who already have a code)

### 5. Web Presence + Directories — `/full-presence/`

- **Price**: $298/month
- **Promise**: One provider, one invoice, for the entire web presence — including the places homeowners cross-check
- **Includes**: Everything in $149/mo Web Presence (including forever hosting and Site Parking), plus end-to-end management of:
  - Google Business Profile (claim/verify/optimize/post/photos/Q&A)
  - BBB, Yelp
  - A rotation of major directories per quarter (Angi, Nextdoor, Houzz where appropriate, Thumbtack, etc.)
  - Quarterly directory audit and report
- **Primary CTA**: Get Web Presence + Directories — $298/mo
- **Audit nudge** in footer band of the page

---

## Free Tool (separate funnel)

### Pool Pro Market Analyzer — `/market-analyzer/` (and `/es/market-analyzer/`)

A U.S. city or 5-digit ZIP code input returns:
- **Pool Pro Opportunity Score** (0--100): overall market attractiveness
- **Market snapshot**: pool density, search demand, competition level, dominant player indicators
- **Seasonal demand curve**: 12-month relative demand chart

A gated form (name + email) delivers a full competitor breakdown by email. Powered by Appwrite (job queue + worker). The audit is the primary lead magnet for the paid ladder; the Market Analyzer is its own intelligence-tool funnel.

Backend dependencies: Appwrite project, `marketAnalysisJobs` table, `marketAnalyzerLeads` table, `market-analyzer-worker` repo.

---

## Pages

### Home — `/` (and `/es/`)

- **Hero (pain-first)**: "Right now, a homeowner is calling someone else." — if your site is buried, slow, or stale, it wasn't you. We build and manage pool pro websites and the directories homeowners cross-check.
- **Lead Magnet Band** linking to `/audit/`
- **Why Pool Pros Choose Us** (benefit grid)
- **How It Works** (3-step flow)
- **Pricing teaser** — $149/mo plan highlighted (forever hosting, Site Parking), with "Not the right fit?" cards linking to `/audit/`, `/starter-kit/`, and `/full-presence/`, plus a link to the full `/pricing/` comparison
- **Testimonials**, **FAQ**, final **CTA**: Get Your Site — $149/mo (primary), Get My Free Audit (secondary)

### Pricing — `/pricing/`

- **Hero**: "Pick the rung that fits."
- **Audit band** at the very top
- **3-tier comparison grid**: Starter Kit ($697 one-time), Web Presence ($149/mo, "Most pool pros pick this"; lists forever hosting + Site Parking), Web Presence + Directories ($298/mo)
- "Why monthly?" rationale (includes Site Parking for seasonal pros), FAQ (including Site Parking + forever hosting), 30-day money-back guarantee badge

### Audit — `/audit/`

Pain-first hero, what we audit (site / Google Business Profile / directories), what lands in the inbox (written report within 5 business days), inline capture form, "why we know where to look" (pool-cover family story), FAQs, secondary CTA to `$149/mo`.

### Starter Kit — `/starter-kit/`

Hero: "A real pool pro website. One time. Yours." — pain section ("Tired of a DIY page that's costing you calls"), what's in the box, honest caveat ("when this is *not* the right fit"), 3-step "how it works", inline order form, FAQs, upsell CTA to monthly plans.

### Full Presence — `/full-presence/`

Hero: "Your website is one place homeowners look. There are five others." — pain ("A great website isn't enough anymore"), what 'we own your directories' actually means, "Plus everything from $149 plan", $149 vs. $298 comparison table, "Why pool pros pick this tier", FAQs, audit nudge.

### About — `/about/`

- **Hero**: "My family sold pool covers for 20 years."
- **The story**: founder's personal connection to the pool industry (pool cover family, watching good pros lose work because their web presence didn't show up)
- **What's different about Pool Pro Presence** (6 cards): "We grew up around pools," "We work live, not in mockups," "AI-assisted, human-supervised," etc.
- **CTAs**: primary `/audit/`, secondary `/demo-gallery/`

### Contact — `/contact/`

- **Two doors**: existing members use Trello (board access via `members@PoolProPresence.com`); new pool pros pick from three options — Free Audit, free 15-minute call (`https://cal.com/jbarba4/15min`), or contact form / `hello@PoolProPresence.com`
- **Contact form**: name, email, phone (optional), service interest (Free Audit / Starter Kit / Web Presence $149 / Web Presence + Directories $298 / switching providers / pricing questions / other), message; ALTCHA + honeypot + timestamp anti-bot; processed via Appwrite Function
- **Hours**: M--F 9 AM--5 PM EST live; weekends/evenings monitored, replies within 1 business day; year-round work including off-season

### Demo Gallery — `/demo-gallery/`

Showcase of example sites built for pool pros. Real client sites are surfaced first with a **"Live site"** badge; fictional segment demos are grouped by segment with a **"Fictional demo"** badge to keep the distinction honest. Each card supports desktop/mobile preview toggle. Built from `_data/demoGallery.json`. Final CTA band: Get Your Site — $149/mo (primary), Get My Free Audit (secondary).

### Case Studies — `/case-studies/`, `/case-studies/rogue-pool-covers/`, `/case-studies/superior-pool-covers/`

Existing client case studies (real businesses, real outcomes).

### Spanish Pages — `/es/` family

Parity with English for the product ladder: `/es/`, `/es/pricing/`, `/es/audit/`, `/es/starter-kit/`, `/es/full-presence/`, plus `/es/about/`, `/es/contact/`, `/es/demo-gallery/`, `/es/market-analyzer/`. Forms that post to the same backend as contact use `form_type: contact` (including the audit capture). Starter Kit primary CTA uses the checkout URL from site data (`starter_kit_checkout_url` in `website/src/_data/site.json`). Footer legal links point to `https://members.poolpropresence.com/privacy` and `https://members.poolpropresence.com/terms`.

---

## Cross-Page CTA Hierarchy

Every page has **one primary CTA** and at most one secondary CTA.

| Page | Primary CTA | Secondary CTA |
|---|---|---|
| `/` | Get Your Site — $149/mo | Get My Free Audit |
| `/audit/` | Get My Free Audit | — |
| `/starter-kit/` | Order My Starter Kit — $697 | — |
| `/pricing/` | Get Your Site — $149/mo | Get My Free Audit |
| `/beta/` | Request My Access Code | Go to Member Portal |
| `/full-presence/` | Get Web Presence + Directories — $298/mo | — |
| `/about/` | Get My Free Audit | See example sites |
| `/demo-gallery/` | Get Your Site — $149/mo | Get My Free Audit |
| `/contact/` | Book Free Consultation / Get My Free Audit (new) | — (members use Trello) |
| `/market-analyzer/` | (existing tool flow — separate) | Get My Free Audit |

---

## Universal Trust & Guarantee Statements

- **30-day money-back guarantee** (monthly plans). No setup fees. Cancel anytime.
- **Webmaster credibility**: "Built by John — 30+ years in web development, family sold pool covers for 20 years."
- **AI-assisted, human-supervised**: never hidden, never the centerpiece — benefits (speed, lower price, accuracy) are emphasized.

## Forbidden Claims

We do not promise:
- "We'll get you to #1 on Google."
- "We'll guarantee X new leads/jobs per month."
- Specific revenue increase percentages.
- "Set it and forget it" with no involvement on either side.
- Anything that contradicts what's actually shipping in the product.

---

## Technical Stack

- **Static Site Generator**: Eleventy (11ty)
- **Templating**: Nunjucks (.njk)
- **CSS**: Basecoat (component layer) + Tailwind CDN + custom CSS variables (`--ppp-*`) in `styles.css`
- **JavaScript**: Alpine.js + vanilla JS for interactions
- **Form handling**: Generic `setupAltchaForm()` helper in `script.js` powers the contact, audit, starter-kit, and beta forms (ALTCHA invisible PoW captcha + honeypot + timestamp + Appwrite Function backend)
- **Analytics**: Matomo Tag Manager (`analytics.activebusinesscore.com`)
- **Member Portal**: Ghost (headless CMS for member site)
- **Project Management**: Trello (async collaboration with members)
- **Scheduling**: Calendly (consultation bookings)
- **Domain/Hosting**: Bunny CDN
- **Backend**: Appwrite (form processing, market analyzer job queue and worker)
- **Email transport**: Mailgun or equivalent transactional email

---

## Brand Elements

- **Business name**: Pool Pro Presence
- **Positioning line**: "Your web presence. Owned. Optimized. Always working."
- **Old taglines retired**: "Stop losing jobs to the competition — before you even get to bid." (still acceptable as a hook in ads/social, but no longer the canonical positioning line.)
- **Primary CTA class**: `.main-cta`
- **Email encoding**: HTML entity encoding on-page (e.g., `hello...`)
- **Color system**: CSS custom properties (`--ppp-*`)
- **Logo**: `/images/poolpropresence_logo.png`
- **Social short links**: `/x/`, `/linkedin/`, `/facebook/`, `/reddit/` (301 redirects via `social-redirect.njk` and `_data/socialRedirects.json`)

---

## SEO Files

- `sitemap.xml` — all public pages, last-modified dates
- `robots.txt` — allows crawlers, references sitemap
- `llms.txt` — concise AI-ready summary (business overview, tools, offerings, contact)
- `llms-full.txt` — this file; comprehensive documentation of all pages, features, and technical stack

## Robots.txt References

```
User-agent: *
Allow: /
Sitemap: https://www.poolpropresence.com/sitemap.xml
```

---

## Social Links (Vanity Short URLs via Redirect)

- `/x/` -> `https://x.com/PoolProPresence`
- `/linkedin/` -> `https://linkedin.com/company/pool-pro-presence`
- `/facebook/` -> `https://facebook.com/pool-pro-presence`
- `/reddit/` -> destination from `socialRedirects.json`

---

## Matomo Analytics (on every page)

```html
<!-- Matomo Tag Manager -->
<script>
    var _mtm = window._mtm = window._mtm || [];
    _mtm.push({'mtm.startTime': (new Date().getTime()), 'event': 'mtm.Start'});
    (function() {
      var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
      g.async=true; g.src='https://analytics.activebusinesscore.com/js/container_sHtypXpy.js'; s.parentNode.insertBefore(g,s);
    })();
</script>
<!-- End Matomo Tag Manager -->
```

---

## Key User Flows

### Free Audit Flow

1. User lands on `/audit/` (or homepage / pricing band)
2. Submits the audit form (name, email, business URL, city/state, primary service)
3. ALTCHA + honeypot + timestamp validate
4. Appwrite Function logs the request and routes notification
5. John (or assisted by AI) manually produces a written audit report
6. Report is emailed to the pool pro within 5 business days
7. Optional: pool pro books a 15-minute call or signs up for a paid plan

### Starter Kit Flow

1. User lands on `/starter-kit/`
2. Submits the order form (name, email, business name, city/state, primary service, current URL, notes)
3. We email a secure payment link and intake worksheet within 1 business day
4. Once paid + intake returned, we build the site over ~2--3 weeks
5. Final delivery: handoff package (source files, instructions), 30-day fix-it window opens

### Sign-up Flow (Web Presence / Web Presence + Directories)

1. User clicks the primary CTA on any page -> `https://members.poolpropresence.com/#/portal`
2. Completes onboarding survey
3. Pool Pro Presence builds custom site within ~5 days
4. Site launches; member receives confirmation
5. Member manages requests via Trello; monthly snapshot delivered by email. **Forever hosting** while they're a member; **Site Parking** optional -- park the site to pause monthly billing, resume with a month of service when they need changes.
6. (For $298 tier) directory work begins in parallel; quarterly audit and report follows

### Contact Form Flow

1. User fills contact form at `/contact/`
2. Honeypot + timestamp + ALTCHA validate submission
3. Appwrite Function processes and routes the message
4. User sees inline success/error message (no page reload)
5. Reply within 1 business day from `hello@PoolProPresence.com`

### Market Analyzer Flow (separate tool funnel)

1. User enters city or ZIP at `/market-analyzer/`
2. Appwrite job queued; worker fetches market data
3. Results returned (score + snapshot + seasonal chart)
4. Optional: user enters name + email for full competitor report delivered by email