# Key Largo Marine & Transit Hub — Full Technical Architecture Specification (llms-full.txt)

> Comprehensive technical specification, content taxonomy, entity graphs, and mathematical formulas for the Key Largo Marine & Transit Hub (keylargo.online).

---

## 1. System Architecture & Technical Stack

- **Framework**: Astro 5.x (Pure Static Site Generation / SSG)
- **Runtime Environment**: Cloudflare Pages Global Edge CDN
- **JavaScript Footprint**: 0kb Baseline Client-Side JS (Progressive enhancement only for interactive calculators)
- **Styling Architecture**: Pure Mathematical HSL Token Engine (`tokens.css` with 4 surface elevation tiers)
- **Viewport Ergonomics**: High-Nit Sunlight Glare Contrast (WCAG AAA >= 7:1 against 1,000-nit tropical daylight)
- **Primary Canonical Domain**: https://keylargo.online/
- **Staging / Edge Preview**: https://keylargo-online.pages.dev/

---

## 2. Structured Data Knowledge Graph & Core Entities

The site publishes unified JSON-LD knowledge graphs conforming to schema.org:
- `@type: "WebSite"` (Global identifier: `https://keylargo.online/#website`)
- `@type: "Organization"` (Publisher: Key Largo Marine Desk)
- `@type: "WebApplication"` (Interactive calculators on `/`, `/resort/`, `/west/`, `/florida/`)
- `@type: "TouristAttraction"` (Marine parks & attractions on `/john-pennekamp/`, `/things-to-do/`)
- `@type: "Guide"` (Excursion directories on `/snorkeling-diving/`, `/islamorada/`)
- `@type: "BreadcrumbList"` (Standardized 2-tier hierarchical navigation across all subpages)
- `@type: "FAQPage"` (Verified direct-answer questions beneath primary H2 sections)

---

## 3. Mathematical Formulas & Engineering Contracts

### Mile Marker Distance & Drive Time
- Formula: `Time (min) = (abs(MM_start - MM_end) / Speed_Limit_mph) * 60 + Traffic_Delay_Buffer`
- Speed Profiles: Day (45 mph avg), Night (35 mph radar zone), Congestion/Peak Weekend (25 mph crawl).

### Park Vehicle & Admission Fees (John Pennekamp)
- Formula: `Base_Vehicle_Fee ($8.00 up to 2 persons) + Addl_Passenger ($0.50/person) + Monroe_County_Surcharge ($0.50)`
- Pedestrian / Bicyclist: `$2.50 flat fee`.

### Tidal Window Tarpon Feeding (Robbie's Marina)
- Optimal feeding window: High Slack Tide ± 1.5 hours.
- Secondary feeding window: Incoming Mid-Flood Tide (elevated dissolved oxygen in marina basin).

---

## 4. Complete Route Inventory & Content Silos

| Route URL | Page Type | Primary Subject Entity | Interactive Micro-Tool |
|---|---|---|---|
| `https://keylargo.online/` | Central Hub | Key Largo (Wikidata: Q1011833) | `KeyLargoWorkbench.astro` (Transit & Bathymetry) |
| `https://keylargo.online/resort/` | Accommodation Hub | Upper Keys Lodging | `ResortComparator.astro` (Rate & Fee Estimator) |
| `https://keylargo.online/west/` | Transit Corridor Hub | Overseas Highway (US 1) | `DriveTimeNavigator.astro` (Key West Route Planner) |
| `https://keylargo.online/florida/` | Environmental Spec | Florida Keys National Marine Sanctuary | `ReefDepthMatrix.astro` (Bathymetry Soundings) |
| `https://keylargo.online/john-pennekamp/` | State Park Pillar | John Pennekamp State Park | `ParkFeeCalculator.astro` (Fee & Tour Estimator) |
| `https://keylargo.online/things-to-do/` | Regional Activities | Monroe County Attractions | `AttractionFilter.astro` (Mile Marker Filter) |
| `https://keylargo.online/snorkeling-diving/` | Aquatic Charters | Spiegel Grove & Molasses Reef | `DiveDepthMatrix.astro` (Certification Triage) |
| `https://keylargo.online/islamorada/` | Neighbor Island Hub | Village of Islands (MM 90–72) | `TarponTideCalculator.astro` (Feeding Window) |
| `https://keylargo.online/about/` | Governance & E-E-A-T | Capt. Marcus Vance USCG Desk | Review Credential Inspector |
| `https://keylargo.online/privacy-policy/` | Legal Compliance | Zero-Tracking Privacy Policy | Consent Verification Registry |
| `https://keylargo.online/terms-of-service/` | Legal Governance | Maritime Disclaimers & FTC Terms | Navigation Limitation Notice |
| `https://keylargo.online/sitemap/` | Visual Sitemap | Full 13-Route Architecture | Categorized Navigation Registry |
| `https://keylargo.online/404.html` | Fault Recovery | Edge 404 Rescue Arena | Corridor Redirection Matrix |

---

## 5. Machine Feeds & Ingestion Endpoints

- XML Sitemap: `https://keylargo.online/sitemap-index.xml`
- Google Discover Media RSS: `https://keylargo.online/rss.xml`
- Crawler Directives: `https://keylargo.online/robots.txt`
- LLM Overview: `https://keylargo.online/llms.txt`
- LLM Technical Spec: `https://keylargo.online/llms-full.txt`