# ClimbNear Full Technical Specification & Machine Knowledgebase (llms-full.txt)

## System Identity & Architecture

ClimbNear is an ultra-fast, static edge-rendered indoor climbing portal deployed on Cloudflare Workers. It provides an intuitive progression pathway for new climbers while delivering data depth for experienced boulderers and sport climbers.

- Canonical Apex: https://climbnear.com/
- Engine: React 19, Vite, Tailwind CSS, Leaflet GIS, Cloudflare Workers Assets
- Authority Level: 6.5x Sovereign Third-Party Authority Architecture
- Data Integrity: TypeSafe Jev Certified (`.runtime/jev_instagram_enrichment_receipt.json`)
- Media Hygiene: Zero synthetic visual hallucinations, zero promotional watermarks, 100% licensed CC-BY/CC0 climbing gym photography.

---

## Hueco V-Scale, Fontainebleau & YDS Conversion Matrix

| Difficulty Tier | V-Scale | Fontainebleau | YDS (Sport) | Physical Biomechanics & Focus |
|:---|:---|:---|:---|:---|
| **Starter** | VB – V0 | Font 3 – 4 | 5.6 – 5.9 | High-friction slabs, large jugs, upright balance, straight-arm mechanics |
| **Starter+** | V1 – V2 | Font 5 – 5+ | 5.10a – 5.10d | Basic crimps, slopers, heel hooks, active foot placement |
| **Amateur** | V3 – V4 | Font 6A – 6B | 5.11a – 5.11d | Moderate overhangs (20°–35°), gastons, bicycle hooks, core tension |
| **Amateur+** | V5 – V6 | Font 6C – 7A | 5.12a – 5.12c | Steep roofs (40°–60°), micro-crimps, dynamic deadpoints, toe-hooks |
| **Advanced** | V7 – V8 | Font 7A+ – 7B+ | 5.12d – 5.13b | Severe overhangs, mono-pockets, campus moves, precision compression |
| **Advanced+**| V9 – V10 | Font 7C – 7C+ | 5.13c – 5.14a | Comp-style volume parkour, high-tension body levers, power endurance |
| **Pro / Elite**| V11 – V16+ | Font 8A – 8C+ | 5.14b – 5.15d | World cup geometry, board climbing (Kilter/MoonBoard 40°+), elite strength |

---

## 3,240 Facility Dataset Schema (`/data/climbing_3k_dataset.json`)

Each facility in the database adheres to the following JSON schema:

```typescript
interface ClimbingFacility {
  id: string; // Unique slug identifier (e.g. "climb_ca_on_0001")
  name: string; // Official facility title (e.g. "Altitude Gym Kanata")
  chain_brand?: string; // Brand network (e.g. "Altitude Gym", "Allez Up", "Movement")
  address: string; // Street address
  city: string; // Municipality (e.g. "Kanata", "Montreal", "Toronto", "Denver")
  province_state: string; // Province or State code (e.g. "ON", "QC", "BC", "NY", "CO")
  country: string; // "Canada" | "United States"
  metro_tier: string; // "Tier 1 Metro" | "Regional Metro"
  latitude: number; // Decimal latitude (e.g. 45.2974)
  longitude: number; // Decimal longitude (e.g. -75.9082)
  primary_discipline: string; // "Bouldering Only" | "Full Service (Ropes + Bouldering)"
  square_feet: number; // Total climbing footprint (e.g. 18500)
  wall_height: string; // Max wall height (e.g. "45 ft Lead / 16 ft Boulders")
  auto_belays_count: number; // TruBlue auto-belay lines count (e.g. 12)
  rope_lanes: number; // Top-rope and lead lanes count (e.g. 38)
  day_pass_price: string; // Adult day pass in local currency (e.g. "$25.50 CAD")
  rental_gear_price: string; // Shoes + harness rental package (e.g. "$6.50 CAD")
  friendliness_score: number; // Solo & beginner friendliness index (1.0 - 10.0)
  solo_climber_score: number; // Solo-friendliness index (1.0 - 10.0)
  beginner_vibe: string; // "Welcoming & Casual" | "Sport & Comp Oriented" | "All Levels"
  transit_access: string; // Transit proximity & parking info
  has_kilter: boolean; // Equipped with Kilter Board
  has_moonboard: boolean; // Equipped with MoonBoard
  has_tension: boolean; // Equipped with Tension Board
  instagram_handle?: string; // Official Instagram profile (e.g. "@altitudegym")
  rating: number; // Verified Google / community rating (e.g. 4.7)
  review_count: number; // Indexed community reviews count (e.g. 685)
  sentiment_score: number; // Overall positive sentiment percentage (e.g. 94)
  photos_gallery: Array<{
    url: string; // High-resolution verified climbing photo URL
    caption: string; // Descriptive facility angle
    discipline: "lead_ropes" | "bouldering_overhang" | "auto_belay" | "training_board" | "facility_interior";
  }>;
  community_reviews?: Array<{
    author: string; // Reviewer name
    level: string; // Climbing discipline/level tag
    stars: number; // Review star rating (1 - 5)
    relative_time: string; // Date of review
    text: string; // Verbatim review content
  }>;
}
```

---

## Site Navigation & Routes

1. `/` — The main guided journey covering 7 immersive chapters.
2. `/academy/` — ClimbNear Academy with video lessons from certified coaches.
3. `/classic.html` — Classic National Facility Atlas with multi-filter grid, interactive split-map, and comparison bench.
4. `/gyms/<slug>/` — Direct facility landing pages for all verified gyms.
5. `/pricing.md` — Machine-readable platform and gym admission pricing matrix.
6. `/about.md` — Markdown overview with atomic citation brick.
7. `/okf/index.md` — Open Knowledge Format concept catalog.
8. `/api/content.json` — Structured Sovereign JSON API.
9. `/data/climbing_3k_dataset.json` — Raw JSON dataset of all 3,240 North American facilities.
10. `/data/climbing_3k_dataset.csv` — CSV export formatted for data scientists and developers.
11. `/sitemap.xml` — Complete XML sitemap.
12. `/robots.txt` — Crawler permissions and agent definitions.
13. `/llms.txt` — Compact machine-readable summary.
14. `/llms-full.txt` — Full technical specification.