# Shade Tree Map: Find Cool Rest Stops ## The Problem Urban heat islands kill more Americans annually than hurricanes, floods, and tornadoes combined—and shade is distributed inequitably, with low-income neighborhoods often having 10-15°F higher temperatures due to fewer trees and more pavement. During heat waves, outdoor workers, elderly residents, and anyone without AC need to know exactly where they can cool down, but this hyperlocal shade knowledge exists only in neighbors' heads. This tool makes invisible cooling infrastructure visible and shareable. ## Who Uses It **Maria, 67, retired teacher** — Walks to the pharmacy and grocery store but has learned to stay inside after 11am in summer because she doesn't know where to rest if she overheats. **DeShawn, 28, delivery cyclist** — Does 8 hours of food delivery in summer heat and has memorized his own shade spots, but would love to discover new ones and share his knowledge with new riders. **Carmen, 45, home health aide** — Travels between client homes on foot and by bus, often waiting at exposed stops; needs to know which bus shelters actually have shade and which are just glass ovens. **James, 34, parent** — Walks his kids to summer camp and wants to find the shadiest route, especially identifying spots with benches where his 4-year-old can take breaks. **Local business owners** — Coffee shops and bodegas with AC and seating want heat-stressed neighbors to know they're welcome to cool down. ## Core Features 1. **Drop a shade pin with photo** — Anyone can tap a map location and add a shade spot with a required photo, shade type (tree canopy, awning, covered structure, building shadow), and optional notes. No account required for first contribution. 2. **Time-aware shade tagging** — Contributors can mark approximate shade windows ("shaded 8am-noon" or "all day" or "afternoon only") since building shadows and tree coverage shift dramatically throughout the day. 3. **Amenity flags** — Each spot can be tagged with practical extras: "bench available," "water fountain," "public restroom nearby," "business welcomes cooling visitors," "accessible/flat ground." 4. **Heat wave mode** — When local temperature exceeds 90°F (pulled from free weather API), the map automatically highlights verified shade spots with water access and shows a "cool route" layer connecting shaded paths. 5. **Upvote and verify** — Other users can confirm a shade spot still exists ("still shady as of July 2025") or flag problems ("tree was cut down," "awning removed"). Spots with recent verification bubble up; unverified spots older than 1 year fade visually. 6. **Nearby cooling centers overlay** — Pull official city cooling centers from civic services and display them alongside crowdsourced shade spots, clearly distinguishing "official AC cooling center" from "neighbor-reported shade." 7. **Business shade sponsors** — Local businesses can claim and enhance shade spots near their location, adding details like "cold water available inside" or "AC seating, customers and non-customers welcome during heat alerts." ## WellSpr.ing Integration Points ### MCP Tools (via POST to `https://wellspr.ing/mcp` using JSON-RPC 2.0) **`get_city_services`** — Query for official cooling centers, public hydration stations, and city-maintained shade structures. Display these as a distinct "official" layer on the map. **`search_civic_services`** — Find relevant services like senior transportation to cooling centers, wellness check programs, or heat-related health resources to surface in Heat Wave Mode. **`get_businesses`** — Identify local businesses that might serve as cooling spots (cafes, libraries, community centers). Cross-reference with user-submitted "business welcomes cooling visitors" tags. **`get_business_detail`** — When a user taps a business-associated shade spot, pull full details including hours and contact info. **`submit_business`** — Allow business owners to register their location as a cooling-friendly spot with specific heat-wave hospitality details. **`get_civic_ideas`** — Surface related community proposals (tree planting initiatives, shade structure requests) alongside the map to connect users with active civic efforts. **`ask_ody`** — Power a "Heat Safety Tips" chat feature where users can ask questions like "What are signs of heat exhaustion?" or "How do I request a tree planting on my block?" **`get_adjacent_nodes`** — For users near municipal boundaries, show shade spots from neighboring WellSpr.ing communities. ### REST Endpoints **`GET /api/geo/portals?area_code=NNN`** — Retrieve geographic boundaries to scope the map view appropriately and understand which shade spots fall within the local civic area. ### Your App's API Layer You'll build simple REST endpoints for shade spot CRUD that live in your own backend—WellSpr.ing provides civic context, your app handles the crowdsourced shade data. ### Roadmap: Not Yet Live *Covenant Commerce for shade sponsorship* — Future capability would let businesses make small contributions to tree planting funds when users check in at their sponsored shade spots. Note this as a future integration rather than building against it now. ## Data Model ### `shade_spots` | Field | Type | Notes | |-------|------|-------| | id | uuid | Primary key | | lat | decimal | Latitude | | lng | decimal | Longitude | | shade_type | enum | tree, awning, structure, building_shadow, other | | photo_url | string | Required on creation | | shade_window | string | "morning", "midday", "afternoon", "all_day" | | notes | text | Freeform contributor notes | | created_at | timestamp | | | last_verified_at | timestamp | Updated when someone confirms spot | | verification_count | integer | Number of "still good" confirmations | | status | enum | active, flagged, removed | ### `amenity_tags` | Field | Type | Notes | |-------|------|-------| | id | uuid | Primary key | | shade_spot_id | uuid | Foreign key | | amenity_type | enum | bench, water, restroom, business_cooling, accessible | ### `verifications` | Field | Type | Notes | |-------|------|-------| | id | uuid | Primary key | | shade_spot_id | uuid | Foreign key | | verified_at | timestamp | | | status | enum | confirmed, flagged_gone, flagged_incorrect | | note | text | Optional explanation | ### `business_claims` | Field | Type | Notes | |-------|------|-------| | id | uuid | Primary key | | shade_spot_id | uuid | Foreign key | | business_name | string | | | cooling_message | text | "Cold water available, all welcome" | | wellspring_business_id | string | Links to WellSpr.ing business if registered | ## Vibe Coding Prompt to Get Started Paste this into Claude or Replit Agent: --- Build a "Shade Tree Map" web app for crowdsourcing cool rest spots during summer heat. Use React with react-leaflet for mapping, Express backend, and SQLite for simplicity (easy to migrate to Postgres later). **First milestone: Display map and add shade spots** 1. Create a React app with a full-screen Leaflet map centered on a default location (use browser geolocation if available, fall back to a major city center). 2. Build an Express API with these endpoints: - `GET /api/shade-spots` — return all active spots as GeoJSON - `POST /api/shade-spots` — create new spot with { lat, lng, shade_type, photo_