commit 260f7c49285675adadee72b51232533f3ad3f668 Author: Daniel Kovalevich Date: Mon Mar 30 13:56:24 2026 -0400 first commit diff --git a/PLAN.md b/PLAN.md new file mode 100644 index 0000000..db649a7 --- /dev/null +++ b/PLAN.md @@ -0,0 +1,206 @@ +# Pilot POC — Oversize Load Resource Platform + +## Vision +A centralized web platform serving truck drivers, carriers, and escort/pilot vehicle operators in the oversize/overdimensional freight industry. Starts as a free information resource with soft lead-generation (escort service order form), then evolves into a revenue-generating SaaS platform. + +## Target Users +- **Truck drivers** hauling oversize loads (occasional or specialized) +- **Carriers** (trucking companies) who book oversize hauls +- **Pilot/escort vehicle operators** seeking loads and customers + +--- + +## Confirmed Modules + +### Module 1 — State-by-State Regulations Map ✅ +- Interactive US map (click a state → see its oversize permit thresholds and escort requirements) +- Data: width/height/length/weight thresholds per state for permits AND escort requirements +- Route checker: enter origin, destination, and load dimensions → see which states require permits/escorts +- **Main challenge:** Data collection (YOUR competitive advantage as a domain expert) +- **Status:** V1 POC built with mock data for all 50 states + DC + +### Module 2 — Permit Route Parser ✅ (Future — high value) +- Parse the routing section of state permits (PDF/text), geocode waypoints, generate navigable route +- Export to Google Maps, Apple Maps, Waze, InRoute via deep links or GPX/KML +- **Main challenge:** Permit format variability across 48+ states — start with 5-10 most common +- AI/LLM parsing makes this much more feasible than before — could be a killer feature + +### Module 3 — Oversize Load Board ✅ +- Carriers/drivers post loads: origin, destination, date, dimensions, escort requirements +- Escort operators subscribe (monthly/annual) to view and bid +- Niche-specific to oversize loads (nothing like this exists today) +- **Status:** V1 POC built with 12 mock listings + +### Module 4 — Escort Operator Locator Map ✅ +- Operators create profiles and drop pins on their location +- Carriers see nearby available escorts on a map +- Includes: ratings, certifications, vehicle type, availability status +- **Status:** V1 POC built with 12 mock operators + +### Module 5 — Oversize-Friendly Truck Stops & Parking ✅ +- Database of truck stops, rest areas, and parking that can accommodate oversize loads +- Include: entrance/exit dimensions, lot square footage, facilities (fuel, food, restrooms, showers) +- **5a — Satellite Imagery:** Embed satellite view showing property layout, adjacent fields, etc. +- Data collection via structured user submissions (see Module 11) + +### Module 6 — Bridge & Overpass Clearance Database ✅ +- Height/width restrictions for bridges, overpasses, tunnels +- Integrate with route planning — flag conflicts with load dimensions +- Data sources: National Bridge Inventory (public federal data), state DOTs + +### Module 7 — Permitted Route Condition Alerts ✅ +- **Important context:** Single-trip permitted loads MUST follow their permitted route — they cannot detour. Annual/blanket permit holders have more flexibility but are expected to consult state 511/DOT. +- This module alerts users about construction zones, road closures, and other disruptions ON their permitted route BEFORE they depart +- Value: Know your route is impacted so you can contact the permit authority for a route amendment or delay departure, rather than discovering the issue en route +- Aggregate road closure data from state DOT 511 APIs +- For annual/blanket permit holders: general route condition awareness for interstates and US routes + +### Module 8 — Weather & Wind Alerts for Wide Loads ✅ +- Wind speed/direction forecasts along a planned route +- Wide loads are extremely sensitive to crosswinds +- Data source: National Weather Service API (free) + +### Module 9 — Document Vault ✅ +- Secure storage for permits, insurance certs, certifications, licenses +- Accessible from the road on mobile devices +- For all user types: truck drivers, carriers, AND escort operators + +### Module 10 — Regulatory Change Alerts ✅ +- Monitor state DOT regulation changes +- Notify users via email/push notifications +- Keeps the regulations database current AND provides value to users + +### Module 11 — Data-Anchored User Contributions ✅ +- **NOT a forum** — structured information submissions anchored to specific data points +- Users can submit facts about specific things (truck stops, weigh stations, routes, regulations) +- Users can comment on existing entries to add context or updates +- Users can flag information as outdated, incorrect, or confirm it's still accurate +- All contributions are tied to a specific entity (a truck stop, a weigh station, a route segment) — no free-floating discussion +- Avoids forum drama while preserving crowdsourcing value +- Examples: + - "South entrance of [truck stop] is blocked by construction as of 3/28" + - Flag a weigh station as "open" or "closed" (like Trucker Path) + - "This parking area has ~2 acres of gravel that can fit a 16' wide load" + +### Module 12 — State-by-State Equipment Requirements ✅ +- **Escort vehicle requirements:** certification needs, vehicle specs, lighting, signage, height poles, safety equipment per state +- **Truck/trailer (carrier) requirements:** OVERSIZE LOAD signs (roof-mounted vs bumper-mounted varies by state), traffic cones, fire extinguishers, reflective triangles, road flares, first aid kits, flags, lights, etc. +- Presented alongside regulation data (extends Module 1) +- Valuable because requirements vary significantly and non-compliance = fines and delays + +### Module 13 — Weigh Station / Inspection Station Info ✅ +- Location, hours, PrePass applicability +- **Crowd-sourced open/closed status** — drivers flag stations as currently open or closed (like Trucker Path) +- User-reported wait times +- Leverages Module 11 (data-anchored contributions) for user reports + +### Module 14 — State DOT Contact Directory ✅ +- Phone numbers for every state's permit office, oversize/overweight division, state police non-emergency line +- Organized by state, easily searchable +- Critical for on-the-road situations: route amendments, permit questions, incident reporting +- Low effort to build, high practical value + +### Module 15 — Seasonal Restriction Calendar ✅ +- Visual calendar showing when seasonal restrictions apply per state +- Spring weight restrictions (common in northern states, March–May) +- Winter mountain pass closures +- Harvest season restrictions in agricultural states +- Holiday blackout periods for oversize travel +- Helps carriers and escorts plan loads weeks/months in advance + +--- + +## Future / Maybe Modules + +### Multi-Load Trip Planner ⚠️ (needs implementation thought) +- For carriers shipping multiple related loads (e.g., 3 wind turbine blades, modular building sections) +- Coordinate timing, escort assignments, staging areas +- Deferred until core platform is established + +--- + +## Modules Cut (with reasons) + +### ~~Trip Cost Estimator~~ ❌ +- Removed: Owner doesn't have knowledge of trucking fuel rates or permit costs +- Could revisit later once permit ordering service is established and rate data is available + +### ~~Permit Application Self-Service Portal~~ ❌ +- Removed: Owner wants to learn the permit ordering process and offer it as a paid service (order-on-behalf-of), NOT help carriers self-serve +- Permit ordering will be a transaction/service revenue stream, not a free tool + +### ~~Rate/Mileage Calculator for Escorts~~ ❌ +- Removed: Too many pricing variables (pickup/dropoff location, deadhead, load availability at destination, experience level, escort position — lead vs chase vs high pole, etc.) + +### ~~Load Tracking / Trip Status~~ ❌ +- Removed: Once an escort is assigned to a load, they're driving together — tracking is irrelevant. The escort and truck are at the same location until delivery or until the escort is no longer needed. +- Could be a future API/integration option for carriers' in-house operations, but not a core platform feature. + +### ~~Invoicing / Bookkeeping~~ ❌ +- Removed: Not a service or feature the owner wants to offer. + +### ~~Emergency Breakdown Procedures~~ ❌ +- Removed: Breakdowns are emergencies — no time to look up regulations. You do what you can to create a safe situation. + +--- + +## Key Industry Insights (from owner) + +### Permit Types & Routing Rules +- **Single-trip permits:** Have a specific permitted route. Driver MUST adhere to it. No detouring. +- **Annual/blanket permits:** For loads that are legally extradimensional but within certain parameters. Driver is supposed to consult state's 511 or DOT for routing advice, but many drivers skip the consultation and stick to interstate freeways and US routes/highways. +- All escorted loads have a set route that driver and escort are legally required to follow. + +### Community Dynamics +- Truck drivers are not known for online etiquette +- Open forums tend to devolve into arguments, brand loyalty drama, ego contests, and clique infighting +- Solution: Data-anchored contributions (Module 11) — get crowdsourcing benefits without moderation burden + +--- + +## Business Model + +### Free Tier (traffic/lead generation) +- Regulations map + equipment requirements (Modules 1, 12) +- Truck stop/parking database (Module 5) +- Weather/wind alerts (Module 8) +- Bridge clearance data (Module 6) +- Weigh station info (Module 13) +- Route condition alerts (Module 7) +- Data-anchored contributions (Module 11) +- Escort service order form (your direct business) + +### Subscription Tier(s) +- Load board access for escort operators (Module 3) +- Document vault (Module 9) +- Permit route parser (Module 2) +- Regulatory change alerts (Module 10) + +### Transaction/Service Revenue +- Escort service bookings (your core business via the order form) +- Permit ordering service (order-on-behalf-of — future, once you learn the process) +- Featured listings for escort operators on the locator map + +### Advertising +- Truck stop/service advertising on the parking database +- Equipment/insurance ads targeted to the industry + +--- + +## Recommended Launch Sequence +1. **Phase 1 — Foundation:** Main website + escort service order form + state regulations map + equipment requirements (Modules 1, 12) +2. **Phase 2 — Engagement:** Truck stop/parking database (Module 5) + data-anchored contributions (Module 11) + weigh stations with crowd-sourced status (Module 13) +3. **Phase 3 — Revenue:** Load board (Module 3) + escort locator map (Module 4) +4. **Phase 4 — Awareness:** Bridge clearance database (Module 6) + route condition alerts (Module 7) + weather/wind alerts (Module 8) +5. **Phase 5 — Premium:** Permit route parser (Module 2) + document vault (Module 9) + regulatory change alerts (Module 10) +6. **Phase 6 — Services:** Permit ordering service (once process is learned) + +--- + +## V1 POC Status (completed) +- ✅ Landing page with hero, features, and CTAs +- ✅ State regulations interactive map (50 states + DC, mock data) +- ✅ Escort service order form (multi-section) +- ✅ Load board with search/filter (12 mock listings) +- ✅ Escort operator locator map + list (12 mock operators) +- ✅ Shared navigation, POC banner, and footer diff --git a/README.md b/README.md new file mode 100644 index 0000000..b56a6bc --- /dev/null +++ b/README.md @@ -0,0 +1,50 @@ +# PilotEdge — Oversize Load Resource Platform (V1 POC) + +## What Is This? +A proof-of-concept web application for truck drivers, carriers, and escort/pilot vehicle operators in the oversize/overdimensional freight industry. + +> ⚠️ **All regulation data shown is SIMULATED for demonstration purposes and must be verified with actual state DOT regulations before any real-world use.** + +## How to View +1. Open `index.html` in any modern web browser (Chrome, Edge, Firefox) +2. An internet connection is required (for map tiles and the CSS library) +3. Navigate between pages using the top navigation bar + +## Pages + +### Core +| Page | File | Description | +|------|------|-------------| +| **Home** | `index.html` | Platform overview and all feature modules | +| **Regulations Map** | `regulations.html` | Interactive US map + equipment requirements by state | +| **Request Service** | `order.html` | Escort vehicle service request form | + +### Road Intelligence +| Page | File | Description | +|------|------|-------------| +| **Truck Stops** | `truckstops.html` | Oversize-friendly parking with user comments | +| **Bridge Clearances** | `bridges.html` | Height/width/weight restrictions for bridges | +| **Weigh Stations** | `weighstations.html` | Crowd-sourced open/closed status | +| **Route & Weather** | `alerts.html` | Construction, closures, and wind/weather alerts | + +### Services & Resources +| Page | File | Description | +|------|------|-------------| +| **Load Board** | `loadboard.html` | Oversize load listings needing escort services | +| **Find Escorts** | `locator.html` | Map of available escort vehicle operators | +| **DOT Contacts** | `contacts.html` | State permit office phone/email directory | +| **Seasonal Calendar** | `calendar.html` | Seasonal restrictions and closure calendar | +| **Document Vault** | `documents.html` | Store permits, insurance, certifications | + +## Tech Stack (POC) +- HTML / CSS / JavaScript (no build step required) +- [Tailwind CSS](https://tailwindcss.com/) via Play CDN +- [Leaflet.js](https://leafletjs.com/) for interactive maps via CDN +- Mock data (hardcoded — not yet connected to APIs or databases) + +## Next Steps +- Replace mock data with real, verified state regulation data +- Connect to backend APIs and a database +- Add user accounts, authentication, and profiles +- Integrate payment processing for subscriptions +- Deploy to a web hosting service (Vercel, Netlify, or similar) diff --git a/alerts.html b/alerts.html new file mode 100644 index 0000000..c02d22b --- /dev/null +++ b/alerts.html @@ -0,0 +1,418 @@ + + + + + + Route & Weather Alerts | PilotEdge + + + + + + + + +
+ + +
+
+

Route & Weather Alerts

+

Know about closures, construction, and weather conditions on your permitted route BEFORE you depart.

+
+
+ + +
+
+
+ ℹ️ +
+

Important — Single-Trip Permitted Loads

+

Single-trip permitted loads MUST follow their permitted route exactly. If a closure or construction zone is on your permitted route, contact the permit authority for a route amendment before departing. Deviating from a permitted route without authorization can result in fines, permit revocation, and liability issues.

+
+
+
+
+ + +
+ +
+ + +
+
+

Filter Alerts

+
+
+ + +
+
+ + +
+
+ + +
+ +
+
+
+ + +
+
+ + + +
+
+ + +
+
+
+
+
+ + +
+

🚧 Route Conditions

+
+ +
+ +
+ + +
+

🌦️ Weather Alerts

+
+ +
+ +
+ + + + + + + + + diff --git a/bridges.html b/bridges.html new file mode 100644 index 0000000..db47148 --- /dev/null +++ b/bridges.html @@ -0,0 +1,385 @@ + + + + + + Bridge & Overpass Clearance Database | PilotEdge + + + + + + + + +
+ + +
+
+

Bridge & Overpass Clearance Database

+

Check height and width restrictions for bridges, tunnels, and overpasses along major trucking corridors. Plan your oversize load route with confidence.

+
+
+ + +
+
+

+ ⚠️ Check Your Load +

+

Enter your load dimensions to identify bridges that may restrict your route.

+
+
+ + +
+
+ + +
+
+ +
+
+ +
+
+ + +
+
+

+ + Filter & Search +

+
+
+ + +
+
+ + +
+
+ + +
+
+
+ +
+
+
+ + +
+
+

+ + Bridge & Overpass Map +

+

Red markers indicate restricted clearances. Click a marker for details.

+
+
+
+ + +
+
+

+ + Clearance Database +

+

+
+ +
+
+ + + + + + + + + diff --git a/calendar.html b/calendar.html new file mode 100644 index 0000000..192d537 --- /dev/null +++ b/calendar.html @@ -0,0 +1,291 @@ + + + + + + Seasonal Restriction Calendar | PilotEdge + + + + + + +
+ + +
+
+

Seasonal Restriction Calendar

+

Plan around seasonal closures, weight restrictions, and travel blackouts that affect oversize load movement across the country.

+
+
+ + +
+
+
+
+ + +
+
+ + +
+ +
+
+
+ + +
+
+

12-Month Timeline

+

Colored bars show when each restriction is active. Hover for details.

+
+ +
+
+ + +
+
+ Spring Weight + Winter Closure + Wind Season + Holiday Blackout + Harvest Season +
+
+ + +
+

Restriction Details

+
+ +
+ + + + + + + + + diff --git a/contacts.html b/contacts.html new file mode 100644 index 0000000..e819b68 --- /dev/null +++ b/contacts.html @@ -0,0 +1,108 @@ + + + + + + State DOT Contacts | PilotEdge + + + + + +
+ + +
+
+

State DOT Contact Directory

+

Find permit office phone numbers, state police non-emergency lines, and online portal links for every state.

+
+
+ + +
+
+ + +
+
+ + +
+
+ +
+ +
+ + + + + + + + + diff --git a/documents.html b/documents.html new file mode 100644 index 0000000..24f6dbe --- /dev/null +++ b/documents.html @@ -0,0 +1,259 @@ + + + + + + Document Vault | PilotEdge + + + + + +
+ + +
+
+

Document Vault

+

Securely store and manage your permits, insurance certificates, and professional certifications — all in one place.

+
+
+ + +
+ + +
+ + +
+ + +
+
+
+ +
+ + + +
+
+ + +
+ + + +
+ + + + + + + + + + + + diff --git a/index.html b/index.html new file mode 100644 index 0000000..e0c3d52 --- /dev/null +++ b/index.html @@ -0,0 +1,233 @@ + + + + + + PilotEdge — Your Oversize Load Resource + + + + + + + +
+ + +
+
+
+ + Built by Industry Professionals + +
+

+ Your Complete Resource for
+ Oversize Load Hauling +

+

+ State regulations, escort vehicle services, load matching, and oversize-friendly parking — + everything truck drivers and carriers need, all in one place. +

+ +
+
+ + +
+
+
+
50
+
States Covered
+
+
+
15
+
Tools & Resources
+
+
+
24/7
+
Online Access
+
+
+
FREE
+
Core Resources
+
+
+
+ + +
+
+

Everything You Need, One Platform

+

Whether you're a truck driver, carrier, or escort operator — PilotEdge has the tools to make oversize hauling easier and safer.

+
+ + +

Core Tools

+ + + +

Road Intelligence

+ + + +

Resources & Services

+ + + +

Coming Soon

+
+
+
🧭
+

Permit Route Parser

+

Upload a state permit and get turn-by-turn navigation in your favorite map app.

+ Coming Soon +
+
+
🔔
+

Regulatory Change Alerts

+

Get notified when states update their oversize regulations and requirements.

+ Coming Soon +
+
+
+ + +
+
+
+

How It Works

+

Three simple steps for carriers and truck drivers

+
+
+
+
1
+

Check Regulations

+

Use our interactive map to see what permits and escorts your load requires in each state on your route.

+
+
+
2
+

Find or Request Escorts

+

Browse available escort operators near your route, or submit a service request with your load details.

+
+
+
3
+

Move Your Load

+

Hit the road with confidence knowing your permits, escorts, and route are all handled.

+
+
+
+
+ + +
+
+

Need an Escort Vehicle?

+

+ Whether it's a single pilot car or a full escort team, we've got you covered. + Tell us about your load and we'll handle the rest. +

+ + Request Escort Service → + +
+
+ + + + + + + diff --git a/loadboard.html b/loadboard.html new file mode 100644 index 0000000..3b378a8 --- /dev/null +++ b/loadboard.html @@ -0,0 +1,298 @@ + + + + + + Oversize Load Board | PilotEdge + + + + + +
+ + +
+
+
+

Oversize Load Board

+

Active loads needing escort/pilot vehicle services. Carriers post free — escort operators browse and bid.

+
+
+ +
+
+
+ + +
+
+
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+
+
+
+ + +
+

+
+ + +
+
+ +
+
+ + +
+
+

Escort Vehicle Operator?

+

Get unlimited load board access, instant notifications for new loads in your area, and priority bidding with a PilotEdge subscription.

+ +
+
+ + + + + + + + + + + diff --git a/locator.html b/locator.html new file mode 100644 index 0000000..71cf26c --- /dev/null +++ b/locator.html @@ -0,0 +1,301 @@ + + + + + + Find Escort Vehicles | PilotEdge + + + + + + + + +
+ + +
+
+

Find Escort Vehicles

+

Browse available pilot/escort vehicle operators near your load's departure point. Click a marker on the map or browse the list below.

+
+
+ + +
+
+
+
+ + +
+
+ + +
+
+ + +
+
+
+
+ + +
+
+ +
+
+
+
+ + +
+
+ + Available +
+
+ + On a Job +
+
+
+ + +
+
+
+ +
+
+
+
+ + + + + +
+
+
+
+

Are You an Escort Vehicle Operator?

+

Add your location to our map and get discovered by carriers and truck drivers looking for escort services in your area.

+
+
+ +
+
+
+
+ + + + + + + + diff --git a/mock-data-extended.js b/mock-data-extended.js new file mode 100644 index 0000000..e462ec3 --- /dev/null +++ b/mock-data-extended.js @@ -0,0 +1,775 @@ +// ===================================================================== +// EXTENDED MOCK DATA — Additional modules for V1 POC +// All data is SIMULATED for demonstration purposes. +// Include AFTER mock-data.js: + + + + +
+ + +
+
+

Request Escort Vehicle Service

+

Tell us about your load and route — we'll match you with available escort/pilot vehicles and get back to you promptly.

+
+
+ + +
+
+ + +
+

+ 1 + Contact Information +

+
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+
+
+ + +
+

+ 2 + Load Details +

+
+ + +
+
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+
+
+
+ + +
+
+ + +
+
+
+ + +
+

+ 3 + Route & Schedule +

+
+
+ + +
+
+ + +
+
+
+
+ + +
+
+ + +
+
+ + +
+
+
+ +
+ + + +
+
+
+ + +
+

+ 4 + Escort Requirements +

+
+
+ + +
+
+ + +
+
+
+ + +
+
+ + +
+

Fields marked with * are required. We typically respond within 2-4 hours.

+ +
+
+ + + +
+ + + + + + + diff --git a/regulations.html b/regulations.html new file mode 100644 index 0000000..3b9b202 --- /dev/null +++ b/regulations.html @@ -0,0 +1,440 @@ + + + + + + State Regulations Map | PilotEdge + + + + + + + + +
+ + +
+
+

State-by-State Regulations Map

+

Click any state marker to view oversize load permit thresholds, escort requirements, and travel restrictions.

+
+
+ + +
+
+
+
+
+ + +
+
+

Quick Route Checker

+

Enter your load dimensions and route to see which states require permits and escorts.

+ +
+
+ +
+ + +
+
+
+ +
+ + +
+
+
+ +
+ + +
+
+
+ + +
+
+ +
+
+ + +
+
+ + +
+
+ + + + +
+
+ + + + + +
+
+

State Equipment Requirements

+

Equipment your escort vehicle and truck/trailer must carry — varies by state. Select a state to see requirements.

+ +
+
+ + +
+
+

Detailed equipment data available for 12 major trucking states. More coming soon.

+
+
+ + + + +
+
+ + + + + + + + + diff --git a/truckstops.html b/truckstops.html new file mode 100644 index 0000000..45a2a17 --- /dev/null +++ b/truckstops.html @@ -0,0 +1,241 @@ + + + + + + Truck Stops & Parking | PilotEdge + + + + + + + + +
+ + +
+
+

Truck Stops & Parking for Oversize Loads

+

Find oversize-friendly truck stops, rest areas, and staging locations across the US. Community-verified with driver comments and entrance dimensions.

+
+
+ + +
+
+
+
+ + +
+
+ + +
+
+
+
+ + +
+
+
+
+
+ + +
+
+
+ + +
+
+

Know an Oversize-Friendly Location?

+

Help the community by suggesting truck stops, rest areas, or staging lots that accommodate oversize loads.

+ +
+
+ + + + + + + + + + diff --git a/weighstations.html b/weighstations.html new file mode 100644 index 0000000..f7f9f12 --- /dev/null +++ b/weighstations.html @@ -0,0 +1,266 @@ + + + + + + Weigh Stations | PilotEdge + + + + + + + + +
+ + +
+
+

Weigh Stations & Inspection Stations

+

Live crowd-sourced status — see which stations are open or closed right now.

+
+
+ + +
+
+
+ + +
+
+
+
+
+ + +
+
+
+
+ + +
+
+ + +
+
+ + +
+
+ +
+
+
+
+ + +
+
+ +
+ + + + + + + + +