DOC v3.3 GENERATED 2026-05-15 SOURCE everly_meta.roadmap +8 PROJECTS RECOVERED

EVERLY IOS
ROADMAP

The whole-system build plan. Each item now carries its phase explanation and the actual tool stack — current and planned.

ACTIVE BUILD
Q2 2026
SAN ANTONIO TX
In Progress
9
Active builds
Planned
24
Committed backlog
Marketing
6
B2B + B2C tracks (P5)
Recovered
8
Missing projects added back
Foundation Live
8
n8n, Supabase, FleetSharp, MCPs
§ 01

Active roadmap

Each card shows what the phase actually does + the tools driving it. Olive chips = currently in use. Dashed chips = planned/required.

P1HIGHEST
ROI First revenue-touching flow. Unlocks billing automation.
Invoicing flow
In Progress

What it does: When a CD (job complete) hits the calendar, parse the address into a JC lookup, pull plan code + community pricing, build a QBO invoice draft, send it to WhatsApp for one-tap approval, then ship the invoice. POs are only consulted for adders/EPOs/CIs — base scope comes from the Plan Catalog.

▸ TOOL STACK
Google Calendar Apps Script QBO API n8n WhatsApp Business Supabase Discord (alerts)
flowP1
P2REVIEW
V1 Template-driven response to Google reviews.
Google Review Responder v1
In Progress

What it does: Gmail watches for Google Business Profile review notification emails (GBP API is blocked for posting, so we parse the inbox instead). Extract reviewer name + star rating, pick one of ~10 template variants, post via the Gmail-mirrored Q&A or copy-to-clipboard for manual paste. Tracks every review in a Supabase table for measurement.

▸ TOOL STACK
Gmail (watcher) n8n Supabase GBP API (blocked)
flowP2
P3REVIEW
V2 AI-generated custom replies in your brand voice.
Google Review Responder v2
Planned

What it does: Same intake as v1, but instead of picking a template, n8n calls the Anthropic API with the review text + Everly brand voice prompt, generates a custom reply, and routes it through Discord for one-tap approve/edit. Adds per-review personalization without manual writing time.

▸ TOOL STACK
n8n Supabase Anthropic API Discord (approval)
flowP3
P4DATA +
FLEET +
SCRAPERS Foundation data — homes, visits, supplier prices, JC sync.
Daily truck visit attribution
In Progress

What it does: FleetSharp records every geofence entry/exit per truck. A nightly n8n flow pulls visits, joins them to public.homes by geofence ID, and writes categorized rows to fleet.job_visits (QA / warranty / service / unscheduled). Unlocks real labor hours per home + per builder.

▸ TOOL STACK
FleetSharp API n8n Supabase
flowP4
Supplier price scrapers
In Progress

What it does: Node.js scrapers (suppliers.mjs + sync-sheet.mjs) hit authenticated supplier portals (Hughes/Hajoca SupplyWeb, SupplyHouse, Reece, Ferguson) via Firecrawl browser profiles, pull current prices for tracked SKUs, and write them into MATERIAL INFO. run-logger.mjs appends per-run records to a RUN LOG tab. Open: scheduling cadence not yet resolved.

▸ TOOL STACK
Node.js Firecrawl Google Sheets API GitHub cron / GH Action / n8n
dataP4
JC system + Apps Script automation
In Progress

What it does: Apps Script bound to the EVERLY JOB SCHEDULE calendar walks events → MATERIALS NEEDED → ORDERED MATERIALS → COMPLETED JOBS → BUILDER COMPLETION STATUS. JCPricing.gs looks up SKUs in MATERIALS V2.0 column N (BEST PRICE W/TAX) by PART#. Handles phase codes (CI / RI / TO / TR / TRF) and EPO wrappers.

▸ TOOL STACK
Google Apps Script Google Calendar Google Sheets Gmail (PO ingest)
flowP4
Job Costing v1 home cleanup
In Progress

What it does: Berny fills correct lat/lng for ~132 problem-geocoded homes in the Berny v3 sheet. n8n webhook ingests fixes → updates public.homes → triggers FleetSharp geofence recreation. Restores accurate geofence-to-home matching.

▸ TOOL STACK
Google Sheets n8n webhook Supabase FleetSharp API
cleanupP4
Backfill community_name
In Progress

What it does: ~330 rows in public.homes lack community_name. Backfill from OPEN/CLOSED JOBS spreadsheet (where reliable) and from parsed BuildPro PO emails (most durable source — every PO names the community explicitly).

▸ TOOL STACK
Supabase SQL Gmail parser Google Sheets
cleanupP4
Cross-device sync fix
Planned

What it does: Move ~/Documents/Claude/Projects/EVERLY IOS/ from local-only to Google Drive Desktop sync so files are reachable from any device. Removes the "I'm not at my laptop" blocker.

▸ TOOL STACK
Google Drive Desktop
cleanupP4
Maintenance tracker
Planned

What it does: Auto-fill maintenance schedules per vehicle based on FleetSharp mileage + time triggers (oil change at 5k, tires at 50k, etc.). Reminders push to Discord. Foundation for fleet maintenance compliance and IFTA later.

▸ TOOL STACK
FleetSharp API n8n schedule Google Sheets Discord
flowP4
P5COMPLIANCE
+ DATA
+ MARKETING Risk reduction, data unification, customer engagement.
COMPLIANCE & DATA
Compliance tracker
Planned

What it does: Central registry of all renewal-driven obligations — TX state plumbing license, GL/auto/WC insurance certs, vehicle registration, OSHA training, Perry Tier III. Each row has expiry date + responsible person. n8n cron checks daily, alerts 60/30/7 days out via Discord.

▸ TOOL STACK
Supabase n8n schedule Discord
flowP5
EVERLY MATERIALS V2.0 → Supabase mirror
Planned

What it does: Mirror the production materials sheet into public.materials on a nightly cadence. Sheet stays the human edit interface; Supabase becomes the queryable source for invoicing, JC scripts, and the marketing analytics dashboard.

▸ TOOL STACK
Google Sheets API n8n Supabase
dataP5
PO email community parser
Planned

What it does: Every BuildPro PO email names the community explicitly (e.g. "Dominion 70 Lot — 20384.70"). n8n parses subject + body, extracts community_name, and writes to public.homes. Makes POs the durable source of truth for address→community mapping.

▸ TOOL STACK
Gmail n8n parser Supabase
flowP5
Inspection outcome tracking
Planned

What it does: Capture pass/fail per phase per home. New public.inspections table. Intake via Discord one-tap shortcut for crew lead (PASS / FAIL / REDLINE + notes). Optional Gmail parser of builder PM emails as verification layer. Unlocks first-attempt-pass-rate KPI per crew, per builder, per phase.

▸ TOOL STACK
Supabase Discord shortcut n8n webhook Gmail parser
flowP5
Drive segments / labor allocation v1
Planned

What it does: Allocate technician drive time using cost-causation rules. New drive_segments table with 5 categories (productive, out-of-area, supply house, non-productive overhead, warranty/callback). Default = destination job; override when prior out-of-town job caused excess return drive. Interim manual timesheet codes until FleetSharp matures.

▸ TOOL STACK
Supabase FleetSharp API QBO (cost centers)
dataP5
Brand kit consolidation v1
In Progress

What it does: Source of truth for 6 brand identities (Plumbing, Pixel & Code, Bookkeeping, Black, Properties, The Everly Group). everly_meta.brands / brand_colors / brand_assets schema seeded. Drive doc as human mirror. Supabase Storage brand bucket holds logo files. Outstanding: real Bookkeeping logo upload (current file is a duplicate of Plumbing).

▸ TOOL STACK
Supabase Supabase Storage Google Drive Canva brand kits
dataP5
MARKETING — B2B (BUILDER TRACK)
Marketing CRM v1 — Builder track
Planned

What it does: B2B CRM for 5–10 builders. marketing.builder_accounts / builder_contacts / builder_pipeline_stages / builder_touchpoints. Retool dashboard for logging calls, meetings, proposals, RFQs. Foundation for tracking builder retention and per-builder revenue growth.

▸ TOOL STACK
Supabase Retool Gmail (logging)
marketingP5
Builder outreach automation
Planned

What it does: Cadence flows triggered by pipeline-stage transitions. Monthly portfolio snapshot email (POs handled + on-time %). Quarterly RFQ check-in ("any new communities coming online?"). Bid-win/loss followup. Discord alert when a builder has had zero touchpoints in 60 days.

▸ TOOL STACK
n8n Gmail Supabase Discord
marketingP5
MARKETING — B2C (HOMEOWNER TRACK)
Marketing CRM v1 — Homeowner track
Planned

What it does: B2C CRM for closed homeowners. marketing.homeowner_leads / homeowner_consent / homeowner_segments / homeowner_campaigns. Bridges from public.homes (closing date) → warranty-window leads. SMS consent captured at closing via Quo.

▸ TOOL STACK
Supabase Quo (consent) Retool
marketingP5
Homeowner nurture sequences
Planned

What it does: Time-triggered SMS via Quo. Day 30 = "everything good?" check-in. Day 90 = water heater / softener service offer. Day 365 = annual inspection prompt + Google review request (feeds Review Responder v2). All gated by opt-in consent.

▸ TOOL STACK
n8n schedule Quo SMS Supabase
marketingP5
MARKETING — STRATEGY & MEASUREMENT
Marketing analytics dashboard
Planned

What it does: Retool reading the marketing schema. Builder pipeline value, homeowner conversion funnel (closing → 30d engaged → service booked → reviewed), channel attribution, opt-out rates. Joins to QBO invoices + Google review timestamps for revenue attribution.

▸ TOOL STACK
Retool Supabase QBO data
marketingP5
Marketing strategy doc v1
Planned

What it does: Written strategy living in Drive + mirrored to everly_meta.docs. Positioning, ICPs for each track, channel mix, measurement model, 90-day OKRs. Reviewed at each invoicing-flow ship milestone.

▸ TOOL STACK
Google Drive Supabase (docs table)
marketingP5
P6CUSTOMER
EXPERIENCE Convert closed builds into ongoing service revenue.
Homeowner OS
Planned

What it does: Post-closing service conversion engine. Receives qualified leads from Marketing CRM (P5). Service booking flow → dispatch → invoice. Replaces ServiceTitan ($900–2500/mo) at ~$50–75/mo on Supabase + Retool + n8n.

▸ TOOL STACK
Supabase Retool n8n Quo SMS QBO
featureP6
Photo Archive (CompanyCam replacement)
Planned

What it does: Internal photo archive for jobsite documentation. Crew uploads via Retool Mobile → n8n parses GPS → auto-tags to project (high confidence) or routes to Discord review queue (low confidence). Office searches/comments via Retool Web. ~$50/mo vs. CompanyCam $450/mo. 10-week phased rollout. Pilot with Berny first.

▸ TOOL STACK
Supabase Storage Retool Mobile Retool Web n8n Discord (review queue)
featureP6
NFC business card system
In Progress

What it does: Metal NFC cards (NTAG213 chips) encoded with cards.everlygroup.org/{name}. Tap-to-card opens a lightweight HTML profile (photo, call/text buttons, builders link). Hosted as static files — URL stays constant, content updated via one curl command. QR sticker backup. Chips left unlocked so cards are reassignable.

▸ TOOL STACK
NFC Tools (Android) Cloudflare / DNS Static HTML hosting StickerMule (QR backup) GoToTags USB writer
featureP6
Drive folder community sync
Planned

What it does: Nightly n8n flow walks JOB FILES/{builder}/{community}/{address}/ recursively, upserts rows in public.homes. Makes Drive folder structure a usable canonical source for address → community mapping (paired with PO parser).

▸ TOOL STACK
Google Drive API n8n Supabase
flowP6
Brand kit: source SVG / vector files
Planned

What it does: Track down original Illustrator/Figma source files from the original logo designers across all 6 brands. Current brand_assets are raster PNG/JPEG only. Vector unlocks vehicle wraps, large-format print, and crisper Retool/Wix renders.

▸ TOOL STACK
Email outreach Supabase Storage
featureP6
build_backend.py recreation
Planned

What it does: Recreate the missing Python helper that generates EVERLY IOS V1.0 backend pricing from POs + materials master. Caller still exists, callee is gone. Known gap in the JC system pipeline.

▸ TOOL STACK
Python Google Sheets API
cleanupP6
P7INFRA
POLISH Tooling, dashboards, inbox hygiene.
Market awareness dashboard
Planned

What it does: Retool dashboard on market.macro_metro for SA, Austin, Houston, DFW. Permits, starts, closings, inventory, builder market share. Multi-select metro filter + date range. Supports the B2B track: which markets are heating, which builders are expanding, where to chase new accounts.

▸ TOOL STACK
Retool Supabase External data feeds
featureP7
EverlyIOS@everlyplumbing.com inbox
Planned

What it does: Activate the dedicated automation inbox and notify Hyphen to redirect PO emails there. Currently routes through billing@ + scheduling@, which mixes operational and automation traffic.

▸ TOOL STACK
Google Workspace Hyphen Solutions
cleanupP7
Retool Home Cleanup dashboard
Planned

What it does: Editable Supabase-backed table for ongoing home metadata cleanup (community, plan, coords, geofence ID). Replaces the rotating Berny v1/v2/v3 sheets with a single durable interface.

▸ TOOL STACK
Retool Supabase
featureP7
Canva brand kit sync
Planned

What it does: Upload Everly brand palettes + logos into Canva brand kits so Canva generation tools apply them automatically when producing customer-facing assets (review responses, builder reports, social).

▸ TOOL STACK
Canva Supabase brand schema
featureP7
P8HARDENING Post-ship security pass.
n8n security audit
Planned

What it does: Run after invoicing flow ships. Credential rotation across all workflows. RBAC review. Webhook signature/auth verification. Confirm Discord on-failure baked into every flow. Confirm Healthchecks.io heartbeats wired once 3+ flows are running.

▸ TOOL STACK
n8n Healthchecks.io Discord
securityP8
§ 02

Marketing strategy

Two-track approach: B2B relationships drive revenue today, B2C conversion compounds revenue tomorrow.

The two-track thesis

Everly's growth has a builder ceiling and a homeowner floor. Build for both, separately.

▪ TRACK A — B2B
The builder track

"Perry-tier reliability, mid-tier overhead. The plumber your construction superintendent doesn't have to babysit."

ICP
Production builders, 50–500 starts/yr, San Antonio metro + Austin/Hill Country. Currently 3 active; target 5–10.
Channels
Direct relationships (Will). Quarterly reviews. Bid responsiveness. Selective referrals from existing PMs.
Pull signal
On-time % from FleetSharp data, callback rate from warranty system, transparent JC pricing.
North star
Builder retention + per-builder revenue growth (not new logos).
▪ TRACK B — B2C
The homeowner track

"We plumbed your house when it was built. We're who you call when something goes wrong — or when you want it to never go wrong."

ICP
Homeowners of Everly-plumbed homes within their first 5 years. Estimated reachable: ~1,500 closed, growing ~600/yr.
Channels
SMS (Quo, primary), email (secondary), Google reviews (trust-builder + signal). Consent captured at closing.
Pull signal
"Original installer" advantage. Photo archive + JC records = we already know the home.
North star
Service conversion rate (% of closed homes booking a paid service within 24mo).

▸ 90-DAY OKRs (REVIEWED ON EACH INVOICING SHIP)

OKR 1 — B2B
≥5
Active builders with logged touchpoints in marketing.builder_touchpoints, ≥1/quarter each.
OKR 2 — B2C
≥60%
Consent capture rate on new closings (SMS opt-in at trim or final-trim handoff).
OKR 3 — INFRA
100%
marketing schema live in Supabase with Retool dashboard. No marketing data outside Supabase.
§ 03

Deferred & not-yet

Tracked but intentionally out-of-scope. Each has an explicit trigger that promotes it back to the roadmap.

Future roadmap
Promote when triggered
  • Builder account management v2 (advanced CRM features) Trigger: First builder formally renegotiates pricing or adds new community.
  • FleetSharp/Linxup REST API + webhooks Trigger: After daily visit attribution flow is stable.
  • On-the-way SMS via geofence triggers Trigger: FleetSharp webhooks active.
  • Real labor hours via geofence (replace timesheet codes) Trigger: drive_segments validated against manual sample.
  • IFTA reporting automation Trigger: First DOT audit or fuel-tax reconciliation pain.
  • Marketing CRM v2 (lead scoring, multi-touch attribution) Trigger: v1 generating consistent qualified-lead volume.
  • Paid acquisition (Google LSA, Meta retargeting) Trigger: Organic Track B converts at >15% before paid is justified.
Explicitly not yet
Premature — would cost more than it returns
  • IAM / role separation Trigger: 10+ employees with system access.
  • Field tech mobile app (full custom) Trigger: Crew demands it. Retool Mobile carries the load until then.
  • Dev / staging / prod separation Trigger: First prod break that costs real money.
  • Mass credential rotation Trigger: Once IOS is running end-to-end. Note exposures, don't loop.
  • Dedicated marketing platform (HubSpot, Brevo, etc.) Trigger: Supabase + n8n can't keep up with marketing volume.
§ 04

Operating principles

Source of truth

Supabase = source of truth. Sheets are the interface layer. Backend data lives in everly_meta, never in MD files.

Comm channels

Quo = customer SMS. Discord = internal/crew alerts. WhatsApp = approval flows. Twilio is out.

Every flow gets an alert

Discord on-failure baked into every n8n flow from #1 onward. Healthchecks.io heartbeats once 3+ flows run.

Execution default

Maximum autonomy. Skip approval theater. Pause only on architectural choices, destructive actions, costs, or physical/credential blockers.

Approved APIs only

No scraping, no headless browsers for review responses. If a vendor blocks the API, pivot to a notification-email pattern. (Supplier scrapers via Firecrawl with explicit auth are the only sanctioned exception — internal data, not customer-facing.)

Marketing on the same stack

Marketing CRM lives in Supabase, sends through n8n + Quo. No HubSpot, no Mailchimp. Same primitives as the rest of IOS.