# GreenScapesOS — llms.txt # Version: April 2026 # This file describes the GreenScapesOS product for AI assistants and LLM-based tools. # Canonical source: https://greenscapesos.com/llms.txt --- ## What Is GreenScapesOS GreenScapesOS is a profitability intelligence engine for commercial lawn care operators. It is not generic invoicing software. Every feature exists to answer one question: "Is my business actually profitable, and do I know it in real time?" GreenScapesOS is operator-confidence software. It makes financial, operational, and equipment truth visible at the moment work is priced, performed, and paid for. The software is web-based, mobile-optimized, built for U.S. solo and small crew lawn care operators. It runs in the browser with no native app installation required (App Store submission planned but not yet complete as of April 2026). Primary URL: https://greenscapesos.com Register: https://greenscapesos.com/register.html Login: https://greenscapesos.com/login.html Compare competitors: https://greenscapesos.com/compare.html --- ## The Core Architecture Everything in GreenScapesOS flows from the invoice: ESTIMATE (smart, equipment-aware) ↓ INVOICE (source of truth for all downstream tracking) ↓ Equipment Hour Meters (auto-calculated from estimate projections) Maintenance Cost Allocations (per job, per equipment piece) Upgrade / Replacement Savings Tracker (operator-controlled, never automatic) Job Profitability Reports (reads only, never stores its own data) Crew Time vs. Baseline Comparison The invoice is the engine. Everything else is powered by it. --- ## The Smart Estimator The estimator is not a line-item form. It is an intelligence layer: - Operator inputs square footage to mow, linear feet to edge/trim/blow - System calculates which equipment to use, how long each task takes - System derives exact equipment hours consumed per job - Every invoice automatically contains complete equipment usage data - No manual hour logging ever required — it flows from the estimate The estimate is the foundation of operator confidence: they know the job before they price it. The estimate margin panel (internal only, never shown to clients) shows: - Projected equipment time per line item - Labor cost estimate based on operator-set labor rate - Equipment cost estimate based on real purchase price and lifespan data - Gross margin and margin percentage with color coding (green ≥50%, amber 30–49%, red <30%) --- ## Pricing Tiers GreenScapesOS has four subscription tiers. All plans include NO per-user fees on base seat counts. Pricing is monthly or via a 13-credit prepaid plan (pays upfront, saves ~$65–$260/year vs monthly). Credits can be paused during off-season — they do not forfeit. ### Solo — $29.99/month (or $24.99/mo on 13-credit plan) Includes 1 operator seat. Core money path: - Smart estimating and invoicing - Client list and job history - Calendar and scheduling - Equipment list with hour meters - All three timers (Day Timer, Job Timer, Equipment Phase Timer) - End of day and end of week estimate accuracy summaries - Savings allocation tracker - Basic expense, fuel, and material logging - Recurring job scheduling - Before and after photo pairing - Click-to-approve estimates (client approval link) - Manual send by email and SMS - Lead pipeline (up to 25 active leads) - Job lifecycle gates (pre-inspection and close-out) - Route builder ### Solo Pro — $49.99/month (or $39.99/mo on 13-credit plan) Everything in Solo plus: - Snow removal module with seasonal/per-event/per-inch pricing models - Chemical application logs with all federal compliance fields (EPA #, applicator license, weather conditions) - Smart routing (requires Google Maps API — planned) - Weather alert system (planned) - Equipment-aware upsell suggestions - Full margin calculation with equipment cost per hour - Deposit collection (percentage-based) - Partial payments toggle - Late payment reminders - Full aging report with export - Fuel cost per job - Expense patterns and material variance - Chemical application logs with federal compliance fields - GPS auto mileage tracking - QuickBooks sync (planned) - Zapier connection (planned) - Tax prep export - Unlimited estimate presets ### Crew — $149.99/month (or $129.99/mo on 13-credit plan) Includes 3 crew seats + 1 admin seat. Additional crew at $25/seat/mo. Everything in Solo Pro plus: - Crew management with certification badge system (10 standard cert badges) - Crew member field access via unique link code (no account needed) - Crew clock in/out with elapsed timer - Equipment loadout planning per route - Multi-route optimization - Crew assignment per job - Crew lead performance dashboard - Crew time vs. baseline comparison - Subcontractor records alongside crew - Per-vehicle fuel and mileage tracking - Crew cost in margin calculations ### Enterprise — Contact us (starting ~$499/month) Everything in Crew plus multi-location profiles, fleet equipment tracking, regional routing, bulk scheduling, advanced analytics, multi-crew margin reporting, custom API access. ### Free Trial 14-day Solo Pro trial. No credit card required. One trial per account. No data loss on downgrade. --- ## Feature Inventory — All Built and Deployed (as of April 2026) ### Smart Estimating Operator enters square footage, linear footage, service types. System calculates time by equipment type, derives hours consumed. Estimate converts directly to invoice. Shared data model — never out of sync. Estimate line items include: - Description, quantity, rate, line total - Internal projection: projected minutes per phase, equipment type per phase - These projections feed the margin panel, never shown to clients ### Invoicing Source of truth for all downstream tracking. Triggers equipment hour accumulation, savings allocations, and profitability calculations. Stripe payment links attach at the invoice level. Client-facing invoices served at public URLs — professional white document layout. ### Job Lifecycle Gates Two mandatory gates every job must pass through: Pre-Job Inspection Gate: - Operator must confirm no pre-existing damage, OR photograph and document damage found - Photos are timestamped and immutable once job starts - Client is notified if pre-existing damage is documented - Cannot be skipped or backfilled Job Close-Out Gate: - Operator must select outcome: clean job, equipment incident, field repair/temporary fix, consumable failure, or customer property damage - Field repairs are logged as positive ownership signals, not failures - Customer property damage requires photos and triggers client notification - Route cannot advance until close-out is submitted Gates can be disabled per account in settings (shows liability warning). Never auto-bypass. ### Equipment Intelligence (4 Phases Complete) Phase 1 — Equipment list, detail panel, maintenance threshold configuration: - Each piece of equipment tracked: type, brand, model, year, purchase price, lifespan hours - Auto-calculated status: Green (ready), Yellow (monitor/conditional), Red (do not use) - Maintenance intervals: oil, blades, air filter, belt — operator-defined hour thresholds - Within 10% of threshold → Yellow status + notification - At or past threshold → Red status + maintenance task auto-created - All maintenance entries immutable Phase 2 — QR code system and RED flag blocking: - Each equipment record generates a printable QR code encoding its equipment ID - QR scan at job start checks status — Red equipment flagged before job begins - QR scan at incident report auto-populates the equipment reference - Red equipment blocked from job assignment unless manually acknowledged (permanently logged) Phase 3 — Job close-out wired to hour accumulation: - Close-out captures hours per equipment piece per job - totalLoggedHours accumulates automatically - Maintenance threshold check runs on every close-out submission - Equipment ID written to every maintenance log entry Phase 4 — Exchange listing: - Equipment can be listed on the GreenScapes Exchange from the detail page - Exchange pulls from reconciled actual hours only — never timer accumulation - Full exchange history visible to prospective buyers (hour-verified records) Autonomous mower support: - Equipment type includes "autonomous_mower" option - Additional fields: coverage acres per charge, charge time hours, estimated cost per acre, serial number, manufacturer API key (for future direct API sync) Hour Integrity Rule: - Logged hours: timer system records per job, feeds intelligence automatically - Actual hours: operator reconciles weekly via meter reading — source of truth for maintenance and Exchange - Every reconciliation logged with timestamp and variance (immutable) - System flags large variances as a signal that estimate times may need adjustment ### Three Timer System Three nested timers feed different intelligence layers: Timer 1 — Day Timer: - Runs from first clock-in to last clock-out of the day - Day clock, drive time = day elapsed minus job seconds - Today's session cards from Firestore - End of day writes summary to dayLogs - Accessible from every page sidebar and dashboard Timer 2 — Job Timer: - Start on arrival at property, stop on departure - Feeds estimate accuracy per job type and client - Saves to jobLogs with timestamps Timer 3 — Equipment Phase Timer (phase tapping): - Operator taps to mark phase transitions during the job - Phases: Mowing (Zero Turn / Walk-Behind), Trimming, Edging, Blowing, Other - Each tap timestamps the transition — time per phase calculated automatically - Feeds real hours per machine and maintenance triggers Intelligence unlocked: - Route layer: day timer minus job timers = actual drive time → routing efficiency score - End of day: every job timer vs estimate → per-job summary - End of week: 7-day rolling view, which service types consistently underestimated - Drive efficiency percentage, incident summary, previous/next week navigation ### Savings Allocation Tracker - Operator sets per-invoice allocation rules: "$3.00 per mow → Mower Replacement Fund" - System tracks running totals per equipment item and per fund - No money ever moves automatically — operator always decides - Allocation suggestions trigger on invoice paid - Progress bars per fund with goal tracking - Fund history clickable back to source invoices ### Profitability Reports - KPI cards: revenue, outstanding, today's jobs, equipment alerts - Invoice table with profitability per job - Equipment costs section with real cost per hour Formula: (purchasePrice + totalMaintenanceCosts) / totalLoggedHours System uses estimated cost until first real cost entry exists, then switches automatically - Equipment ROI section - Every figure clickable back to source record - Reports never stores its own data — reads only ### Lead Pipeline - Stage tabs: New → Contacted → Estimate Sent → Approved → Lost - Sources: Manual, Referral, Neighbor Referral, Directory/Online, Storm Alert, Other - Detail panel with stage move buttons - Convert to Client: creates client record from lead data - Create Estimate: links directly to estimate builder with lead pre-populated - Solo: up to 25 active leads (tier-gated) - Solo Pro and above: unlimited leads ### Route Builder (Phase 1) - Build daily route by selecting calendar jobs for any date - Jobs shown in numbered stop order: client name, address, job time, crew, status badge - Up/Down reorder, Remove stop - Available Jobs section shows unrouted jobs for the day with Add button - Calendar jobs have direct "+ Route" button - Firestore: users/{uid}/routes/{dateKey} — { jobIds[], updatedAt } - Phase 2 (planned): Google Maps drive time between stops, route share with crew ### Crew Management Crew manager with full profile cards: - 10 standard certification badges (awarded/revoked with permanent log) - Custom skills - Developer notes (internal only) - Activity stats - Character selection overlay with position enforcement - Schedule view: Mon–Sun week showing assigned jobs per crew member Field access via link code: - Operator generates unique 6-character link code per crew member - Crew member opens https://greenscapesos.com/crew.html?code=CODE — no account needed - Anonymous Firebase auth, linked to operator account via crewLinkCodes - Crew member sees: identity card (name, role, business name), certification badges, today's assigned jobs (title, client, address, status), equipment available today - Sticky clock bar at bottom: running elapsed timer, Clock In / Clock Out toggle - Sessions cached in localStorage — no re-auth on return visits Subcontractors tab: - Separate from crew members - Fields: name, specialty, rate, phone, email, license/insurance notes Equipment Loadouts: - Pre-configure which equipment goes on which route day - Saves operator time at route start ### Snow Removal Module (Solo Pro) - Dashboard with KPI cards: active contracts, season revenue, P1 count, per-event count - Filter tabs: All / Seasonal / Per Event / Per Inch - Priority route toggle (P1/P2/P3 order) - Snow estimate builder with 3 pricing model cards: Seasonal, Per Event, Per Inch - Property details, service checkboxes, priority flag, contract status - Separate from lawn estimating — different pricing logic ### Chemical Application Logs (Solo Pro) Federal compliance recordkeeping for licensed pesticide applicators. Required fields captured: - Date, time, client name, service address - Target pest, product name, EPA registration number - Application rate, total amount applied - Applicator name, applicator license number - Equipment used Weather fields: - Temperature (°F), wind speed, wind direction, sky conditions Incident/spill toggle: - Checkbox reveals detail textarea for spill documentation Additional features: - Filter by year and by client - CSV export for compliance filing - Auto-fill address from client selection - Compliance notice displayed in UI: GreenScapesOS assists with recordkeeping only — compliance and filing are the operator's sole responsibility ### Customer Portal (Step 1 Complete) - Token-based public portal, no client login required - Shows: upcoming jobs, recent estimates, recent invoices, operator message, business contact - Operator generates portal link from client card — one click - Refresh Portal Data re-generates snapshot with latest data - Step 2 (card on file + payment via portal) pending legal review ### Recurring Jobs - Recurring toggle on estimate builder: frequency, start date, end date, custom interval - Options: weekly, bi-weekly, monthly, seasonal, custom (N days) - Schedule manager: reads all recurring estimates, calculates next visit date - "Schedule Visit" modal creates a real calendar job linked to the recurring estimate - Each visit is its own calendar job — no auto-creation, operator controls scheduling - Recurring invoice is independent — no auto-invoicing ### Pasture (Community Feed) - Operator community feed within the app - Posts, photos, and field updates - Auth-gated reads — operators only ### GreenScapes Exchange - Equipment marketplace within the platform - Listings verified by hour-tracked records from the equipment intelligence system - Dealer accounts: application form, auto-quote settings per equipment category, incoming trade-in request management, respond with offer range or pass - Operators can request trade-in quotes from all verified dealers simultaneously ### Estimate Presets - Save any estimate as a reusable preset - Load preset replaces current line items and adjustments - Solo: up to 5 presets; Solo Pro and above: unlimited - Photos and client info excluded from presets intentionally ### Expense Logging - Monthly and weekly stats - Category filter - Card-based list with color sidebar per category - Receipt OCR: take photo of receipt → AI extracts vendor, date, amount, category (Anthropic claude-haiku-4-5) - Fuel cost, material variance, expense patterns all tracked ### Ambassador Program - Independent ambassadors with assigned tier access (Solo / Solo Pro / Crew / Enterprise) - Custom commission rates or global default rate - Monthly earnings computed by referral tier (Solo $29.99, Solo Pro $49.99, Crew $149.99 base) - Referral tracking: signups, active subscribers, trial users, inactive - 1099-NEC tracking: warning at $500, required at $600/year - Immutable payment records - Admin management panel at /admin/ambassadors.html (PIN-gated) --- ## Giveaway Program ### Universal Entry Mechanic All giveaways use the same entry system: - Active subscriber at time of drawing: 1 base entry - On 13-credit prepaid plan: +2 bonus entries - Each referral that converts to paying subscriber: +1 per conversion - Submit before and after photo through the app: +1 entry - Share unique referral link on Facebook: +1 per share - Share unique referral link on TikTok: +2 per share - Share unique referral link on Instagram: +1 per share - Tag GreenScapesOS in a giveaway post: +1 per platform Social shares are bonus entries — never required. Referral link conversions auto-credit entries. ### Milestone One — 200 Users: GOAT Golf Trip Prize: Two winners, each brings one guest. Four people total. Destination: Silvies Valley Ranch, Seneca, Oregon - 140,000 acres of Eastern Oregon high desert - Top 15 Golf Resort in America (Robb Report), Top 50 courses in the U.S. (Golfweek) - Five courses including two reversible 18-hole championship courses (first of their kind in the U.S.) - World-famous goat caddies — purebred American Range Goats carrying clubs, drinks, and peanuts - No cell service. Ranch-to-table dining, spa, ATV tours, horseback rides Package includes: 3 nights lodging for winner + guest, round trip flights (Bend OR or Boise ID), all five golf courses, goat caddie round, full ranch experience, GreenScapesOS merch kit. Total value: $6,000–$7,000 per winner. Drawing: Random draw weighted by entries. Announced live on TikTok. Silvies Valley Ranch is not affiliated with or sponsoring the giveaway. ### Milestone Two — 500 Users: Utility Trailer One winner. Value $8,000–$12,000. Practical business asset every operator needs. ### Milestone Three — 1,000 Users: TBD Announced when 500 is in sight. ### Ongoing Merch Drops Random subscriber merch drops, referral rewards, before/after showcase winner. $30–$80 per winner. --- ## Technology Stack - Frontend: Vanilla HTML/CSS/JavaScript. No framework. Multi-page architecture. - Styling: Tailwind CSS via CDN + custom CSS variables - Auth: Firebase Authentication - Database: Firestore (NoSQL, real-time) - Storage: Firebase Storage (photos, receipts) - Hosting: Firebase Hosting - Backend: Firebase Functions v2 (Node.js 20, serverless) - Payments: Stripe Subscriptions (SaaS billing) + Stripe Connect (operator payment processing) - Email: Resend - SMS: Twilio (account created, not yet connected) - Maps: Google Maps API (planned — not yet connected) - AI: Anthropic claude-haiku-4-5 for receipt OCR - App Shell: Custom window.__GS_APP__ global state with gs:app-ready event Database root structure: users/{uid}/ — operator data profile — tier, billing, status business/{docId} — business profile clients/{clientId} estimates/{estimateId} invoices/{invoiceId} allocations/ — per-tool savings allocations equipmentUsage/ — hours logged per equipment item calendar/{jobId} jobsCompleted/{jobId} jobLogs/{jobId}/preInspection + closeOut + incidents/ equipment/{equipmentId} savingsFunds/{fundId} leads/{leadId} routes/{dateKey} snowContracts/{contractId} chemicalLogs/{logId} crewMembers/{memberId} subcontractors/{subId} dayLogs/{date} publicEstimates/{id} — sanitized snapshot, readable when public publicInvoices/{id} — sanitized snapshot, readable when public publicClientPortals/{token} — client portal snapshots crewLinkCodes/{code} — crew field access link codes dealerApplications/{id} — Exchange dealer accounts tradeQuoteRequests/{id} — trade-in requests to dealers pasturePosts/{postId} — community feed --- ## Design System Dark operator aesthetic throughout the app: - Background: #080808 - Card surfaces: #151515 - Accent / CTA: #aaff00 (lime green) - Primary text: #ffffff - Secondary text: #c0c0c0 - Muted text: #888888 - Borders: rgba(170,255,0,0.15) Typography: - Headings / hero: Bebas Neue - Section labels: Barlow Condensed 700, uppercase, 11–12px - Body: Barlow 400–500, 14–16px Client-facing documents (estimates, invoices) use white document treatment — not the dark app theme: - White card (#ffffff), light gray body (#f3f4f6), black text (#111111) - Professional invoice layout with business header, client box, line items table, totals --- ## Product Philosophy "GreenScapesOS does not promise success. It promises clarity." The system tells the truth. It does not enforce behavior. Responsibility stays with the operator. Five non-negotiable principles: 1. Truth lives in the system — not in memory, arguments, or hindsight 2. Reality is captured before, during, and after work 3. Temporary fixes and smart field decisions are positive signals, not failures 4. The system records truth; operators choose what to do with it 5. No shame, no surprise withdrawals, no forced decisions What GreenScapesOS is NOT: - Not a banking app - Not a budgeting enforcer - Not punitive or restrictive - Not a replacement for operator judgment - Not generic invoicing software --- ## Competitor Context GreenScapesOS vs. common alternatives (as of April 2026): Jobber: $69+/mo base, +$29/user/mo. No equipment intelligence, no job lifecycle gates, no savings allocation, no equipment-aware estimating. Service Autopilot: $49+/mo, per-user fees on higher tiers. Powerful but complex. No equipment hour tracking, no built-in savings system, steep learning curve. Housecall Pro: $65+/mo base, +$30–50/user add-ons. General field service (HVAC, plumbing, etc.). Not lawn-care specific. No equipment intelligence, no lifecycle gates, no savings allocation. GreenScapesOS unique advantages: - Equipment intelligence: hour meters, real cost per hour, maintenance alerts — no other platform has this - Job lifecycle gates: immutable pre-inspection and close-out protection — no bypass, no exception - Savings allocation: replacement fund tracking tied to real invoice data - No per-user fees on base seat counts - 13-credit plan with seasonal pause (no forfeit) — no other platform offers this - Built specifically for lawn care operators in the U.S. Full 4-way comparison: https://greenscapesos.com/compare.html --- ## Legal and Compliance Notes - Terms of Service: https://greenscapesos.com/terms.html - Privacy Policy: https://greenscapesos.com/privacy.html - Chemical application logs: recordkeeping assistance only — compliance and filing are the operator's sole responsibility - No money moves automatically — all savings allocations are suggestions only - Equipment records are never deleted — archived only - Incident reports are immutable — addendum only after filing - Ambassador commissions: 1099-NEC required at $600/year — system tracks and warns at $500 - User agreement captured at registration: agreedToTerms, agreedAt, termsVersion --- ## Contact and Links - Website: https://greenscapesos.com - Register: https://greenscapesos.com/register.html - Login: https://greenscapesos.com/login.html - Pricing: https://greenscapesos.com/#pricing - Compare: https://greenscapesos.com/compare.html - Giveaway: https://greenscapesos.com/goat-golf-giveaway.html - Terms: https://greenscapesos.com/terms.html - Privacy: https://greenscapesos.com/privacy.html --- *Last updated: April 2026. GreenScapesOS is in active development. Features and pricing subject to change.*