Executive Summary
The Problem Worth Solving
Right now, running a quote from initial lead to signed proposal to installation instructions requires jumping between five separate tools — none of which were built specifically for a Christmas lighting business. The result is a tax county bug that has to be manually fixed on every single returning client, an invoice email template that bleeds between Christmas and Events modes, a mockup workflow that lives in PowerPoint and can take hours per job, and zero automated follow-up for the 10+ new leads arriving each week.
This proposal describes a purpose-built platform that consolidates everything into one system — designed from the ground up around exactly how Twinkle Nights works.
Current State
What You're Running Today — And What It Costs You
| Tool |
What It Does |
Estimated Cost |
Status |
| Tinsel / Service Autopilot |
CRM, proposals, invoices, client management, scheduling |
$200–$400/mo |
Replaced |
| PowerPoint |
Manual mockup creation — screenshots, overlay decorations, watermarking, export |
$20/mo + 3–5 hrs/quote |
Replaced |
| Google Street View |
Virtual property assessment before site visits |
Free (manual workflow) |
Embedded |
| St. Johns County Property Appraiser |
Cyclomedia aerial/street imagery for property research |
Free (manual navigation) |
Embedded |
| CompanyCam |
Job site photos, installation documentation, technician coordination |
$60–$150/mo |
Integrated / Optional |
| Trello |
Pipeline visualization — tracking lead stages |
$10–$20/mo |
Replaced |
| Loom |
Proposal walkthrough videos for boards and property managers |
$15–$20/mo |
External (kept) |
| Twilio / SMS |
Manual follow-up texts after proposal sends |
Time cost (manual) |
Automated |
Total tool cost today: $300–$600/month plus an estimated 8–15 hours of manual administrative labor per week during peak season. This platform eliminates the subscriptions and the manual hours simultaneously.
The Known Pain Points
Tinsel / Service Autopilot
Tax County Bug — Every Single Time
When cloning a returning client's proposal, the system silently switches the tax county to the wrong jurisdiction. Every client must be manually inspected and corrected before acceptance. Tax reports are wrong if this step is missed.
Invoice Email Templates
Christmas vs. Events Bleedthrough
Invoice email templates are shared between Christmas and Events modes. When switching seasons, every invoice risks going out with the wrong branding and messaging. Requires constant manual switching and review.
PowerPoint Mockup Workflow
Hours Per Quote on Visual Creation
Every mockup requires: finding a property photo, taking a screenshot, importing into PowerPoint, overlaying elements, applying the watermark, exporting, and uploading. This takes 2–4 hours per proposal for complex jobs like HOAs.
Follow-Up Process
10+ Leads, No Automation
Every follow-up after sending a proposal is manual — individual texts, calls, spam folder warnings. With 10+ active leads simultaneously during peak season, critical follow-ups fall through the gaps.
Proposal Modification
Modify → Re-Accept Loop
Any change to an accepted proposal — even a minor correction — requires opening modify mode, making the change, and re-accepting. A clunky process that adds friction to every correction, even trivial ones like tax county fixes.
Multi-Tool Context Switching
Five Tools to Close One Job
A single job flows through: Service Autopilot → Property Appraiser → PowerPoint → Tinsel → CompanyCam → Scheduling. Every tool switch is an opportunity for error, lost data, or duplicated work.
The Solution
What We're Building — Module by Module
The platform is organized into eleven functional modules. Every module replaces or automates a step in the current workflow. Below is the complete feature inventory.
01
Lead Management & Pipeline
- Web form webhook — auto-import when form fills on site
- Affiliate email parse — forward to receiving address, lead appears instantly
- Manual lead entry with all contact fields
- Client → Site → Project hierarchy (mirrors current mental model)
- Kanban pipeline view replacing Trello
- Lead source tracking (web, affiliate, referral, phone)
- Status timestamps and activity log
02
Property Research Panel
- Embedded Google Street View by site address — no tab switching
- One-click deep link to St. Johns County Property Appraiser with address pre-filled
- Cyclomedia viewer link generation for aerial imagery
- Research notes field tied to the site record
- Screenshot capture and pin to job record
- Measurement notes and roof line documentation
03
AI-Assisted Mockup Builder
- Upload property photo directly from job record
- "Make this dusk" — AI image enhancement via Claude API, one click
- Canvas-based decoration overlay (wreaths, bows, C9 strands, garland, signs)
- Pre-built decoration library matching Twinkle Nights inventory
- Auto-apply watermark layer
- Save to job record and attach to proposal in one click
- Rename and reorder images for proposal display sequence
04
Proposal Builder
- Template library — Christmas display, events, by item type
- Line items: Feature / Description / Quantity / Unit Price
- Per-line client visibility toggle (hide footage and strand counts from client)
- Multi-year pricing columns: 1-year / 3-year / 5-year calculated live
- County-based tax — locked to site record, never auto-switches
- Optional vs. required item flags (client can check/uncheck optional items)
- Mockup image carousel attached at proposal bottom
- Clone last year's proposal with one click — retains all items and locked pricing
- Agreement type auto-populated from client's signed contract
05
Client-Facing Proposal (Web View)
- Branded, mobile-friendly proposal URL
- Live price update when client selects agreement type (1/3/5yr)
- Optional item checkboxes with running total
- Mockup image gallery displayed clearly below line items
- Scroll-to-accept with digital signature + agreement acknowledgments
- Proposal viewed notification fires immediately to your inbox
- View history — how many times, when, from what device
06
Invoice Engine
- 50% deposit invoice auto-send on proposal acceptance (toggleable per client)
- Manual invoice send option for municipalities and board-approval clients
- Seasonal email template switcher — Christmas mode vs. Events mode, per-invoice
- PDF invoice generation (clean, branded)
- "Get remaining balance" one-click for final invoice
- County-accurate tax line on every invoice
- Payment status tracking
07
Installation Documentation Builder
- Structured installation picture template: client name, contact, timer setting, power location, designer, N/R/RC code
- Zone-by-zone strand count and footage fields
- Overhead map upload with annotation layer (arrows, text, "stop here" markers)
- Box prep / materials list auto-generated from accepted proposal line items
- One-click export to CompanyCam project (via API) or save natively
- Sign-in-yard authorization field (yes/no)
08
Job Scheduling & Dispatch
- Schedule installation and take-down in one view
- Pre-installation email auto-sent on schedule: gate codes request, security notice
- Post-installation follow-up email trigger
- Status board: Deposit Received → Scheduled → Installed → Final Invoiced → Paid
- Job notes visible to technicians
- CompanyCam project creation on schedule confirmation
09
Returning Client Automation
- Annual renewal workflow: clone prior year, system pre-fills locked pricing
- Accept on client's behalf for multi-year agreements — no new send required
- System flags: locked pricing (multi-year) vs. re-quote needed
- July deposit reminder email sequence fires automatically
- RC (returning with changes) notation system — documents what changed year-over-year
- Multi-year contract countdown display (e.g., "Year 2 of 3")
10
Automated Follow-Up
- Proposal sent → viewed → not accepted: configurable email sequence fires automatically
- Spam folder heads-up SMS auto-sent right after proposal email
- Proposal view notification — instant alert when client opens their link
- Configurable follow-up cadence (day 2, day 5, day 10)
- One-click "stop follow-up" when client responds
- Follow-up log visible in job record
11
Reporting & Tax Management
- Tax report by county — accurate, never wrong due to auto-switch bug
- Revenue by client type (HOA, residential, municipal, commercial)
- Proposal close rate and average deal size
- Multi-year contract portfolio (total locked revenue, renewal dates)
- Pipeline value by stage
- Seasonal comparison year-over-year
Technical Architecture
How It Gets Built
Every component of this platform is built on production-grade, widely supported tools. Nothing experimental. Nothing that creates a single-vendor dependency for Twinkle Nights. The stack is chosen for stability, speed of development, and long-term maintainability.
Frontend
React + Vite
Fast, modern web app. Same stack used in the most successful B2B SaaS products. Works on any device.
UI Components
Tailwind + shadcn/ui
Polished, accessible interface components. Clean, professional design that matches the Twinkle Nights brand.
Database & Auth
Supabase
Postgres database, authentication, file storage, and real-time updates. Secure, scalable, SOC 2 compliant.
AI Image Enhancement
Claude / GPT-4o API
Powers the "make this dusk" feature and future AI description generation. Best-in-class image editing via API call.
Mockup Canvas
Fabric.js
Industry-standard canvas library for drag-and-drop decoration overlay. Used by major design tools.
PDF Generation
React-PDF
Pixel-perfect invoices and proposals as downloadable PDFs. Branded, print-ready output every time.
Email
Resend
Transactional email delivery with high inbox rates, open tracking, and template management built in.
SMS
Twilio
Automated SMS for spam-folder warnings, schedule confirmations, and follow-up sequences.
Deployment
Vercel
99.99% uptime, global CDN, automatic deployments. The same infrastructure running tools used by millions.
Integration
CompanyCam API
Direct push of installation docs and photos to existing CompanyCam projects without manual uploads.
Maps & Research
Google Maps API
Embedded Street View inside the job record. No tab switching to research a property.
Digital Signature
Custom (built-in)
Native signature collection on proposal acceptance. No third-party DocuSign fees. Stored with the proposal record.
On AI-Assisted Development: This platform is built with Claude Code — AI-assisted software development that compresses build time by 40–50% versus traditional development. This means Twinkle Nights gets a faster delivery at the same level of quality, and the efficiency savings are passed through in the project pricing below.
Build Timeline
Three Phases — Delivered Before Your Busy Season
Phase 1 ships first and solves 80% of your current pain. Phases 2 and 3 add the visual tools and automation layer. At sprint pace with two builders and AI-assisted development, the full platform can be operational before your September ramp-up.
P1
The complete end-to-end quote-to-invoice workflow. This phase alone replaces Tinsel, Service Autopilot, and Trello. The tax county bug is gone on day one. Multi-year pricing, template proposals, client-facing acceptance, and invoicing all ship in this phase.
Lead management
Client / Site / Project hierarchy
Proposal builder + templates
Multi-year pricing (1/3/5yr)
County tax (locked, correct)
Visibility toggles (hide footage)
Client-facing proposal web view
Digital signature + acceptance
50% + final invoice engine
PDF generation
Seasonal email templates
Proposal viewed notifications
Clone returning client proposals
Pipeline kanban
P2
The mockup workflow that currently lives in PowerPoint moves into the platform. AI image enhancement, the canvas decoration builder, installation documentation, and automated pre/post-job communications all ship here.
Photo upload + canvas mockup builder
AI "make this dusk" enhancement
Decoration library overlay (wreaths, bows, C9s)
Auto-watermark
Installation documentation builder
N/R/RC codes + timer/power fields
Materials list auto-gen from proposal
CompanyCam API integration
Pre-installation email automation
Post-installation follow-up trigger
P3
The follow-up problem gets solved permanently. Returning client renewal automation fires in July without you touching it. Tax reporting by county is accurate and exportable. The full analytics picture shows close rates, pipeline value, and multi-year contract health.
Automated follow-up sequences
SMS spam-folder alert on proposal send
Returning client annual renewal workflow
July deposit reminder automation
Tax report by county (export-ready)
Revenue by client type
Multi-year contract portfolio view
Proposal close rate analytics
Year-over-year seasonal comparison
Buffer + QA (Weeks 14–16): Real-world testing with your actual client data, technician training, and any refinements before your September ramp. Arriving at season with 4–6 weeks of buffer is by design.
Why This Changes Everything
The Business Case — What This Is Actually Worth
The question isn't what this costs. The question is what your current inefficiencies cost — and what closing one more HOA per season is worth to your bottom line.
⏱
8–15 Hours Back Per Week at Peak Season
When follow-up is automated, mockups take 20 minutes instead of 3 hours, and installation docs generate themselves from the accepted proposal — that time goes back to you.
📈
Higher HOA Close Rate
The mockup is what sells HOAs and boards. The platform makes high-quality mockups fast — which means more proposals get mockups, which means more HOA contracts get closed.
🔁
Zero Tax Errors on Returning Clients
The county tax bug that has to be manually corrected every single year on every returning client is gone on day one. Tax reports are accurate by design, not by vigilance.
🤝
Proposals That Sell Themselves
The client-facing proposal with live multi-year pricing, optional item checkboxes, and mockup gallery is built to convert. Property managers can forward it to their board without needing to explain anything.
🧠
Institutional Memory That Doesn't Walk Out the Door
Every measurement, every mockup, every installation photo, every technician note — all stored in one place, tagged to one client, accessible from any device, forever.
🏆
A Competitive Moat
No other Christmas lighting company in your market is running a purpose-built platform like this. When you show a prospect a live, branded proposal with a rendered mockup and multi-year pricing — the comparison to a competitor's PDF quote is stark.
If this platform closes two additional HOA contracts per season — each averaging $8,000–$15,000 — the platform pays for itself in year one. The follow-up automation alone, if it converts one additional residential lead per week during the 8-week peak, generates $15,000–$25,000 in additional revenue annually.
Investment Options
Five Ways to Structure This Engagement
The platform is the same regardless of which model you choose. The difference is how ownership, risk, and ongoing costs are structured between Twinkle Nights and Advisor AI Partners. Choose the model that fits your cash position and long-term goals.
What You Get
- All three phases delivered in full (Weeks 1–13)
- Perpetual license — platform runs forever at your custom URL
- Full onboarding and data migration from Tinsel/SA
- 60-day post-launch bug fix support included
- Source code available in escrow for business continuity
- Priority build timeline — Phase 1 in 5 weeks guaranteed
Ongoing Costs After Purchase
- Hosting & infrastructure: $200–$350/month
- Optional maintenance retainer: $400–$600/month
- New feature development: quoted as needed
- No subscription. No recurring license fee to Advisor AI.
Best for: Businesses with available capital who want a clean transaction, no ongoing obligations to the developer, and maximum control. You own the platform outright. If Advisor AI Partners ceased to exist tomorrow, your platform keeps running. The $40,000 is the full cost of a system worth significantly more in annual operational savings and revenue impact.
What You Get
- All three phases delivered on the same timeline
- Hosting, maintenance, and infrastructure included in monthly fee
- Platform updates and improvements as they're released
- ~2 hours/month support included
- Same onboarding and migration support as outright
Terms & Ownership
- 24-month minimum commitment
- Month-to-month after 24 months
- Advisor AI Partners retains platform IP
- Your data is always exportable (CSV on request)
- Access ends if subscription lapses — no perpetual license
Total 24-month cost: $18,500 ($500 + $750 × 24). Best for: Businesses that prefer predictable monthly operating expenses over a capital outlay. This replaces your existing tool subscriptions ($300–$600/mo) while delivering a dramatically more capable platform. Net new cost over current tools: approximately $150–$450/month.
What You Get
- All three phases on the same delivery timeline
- Hosting and maintenance included through buyout
- After 36 months: perpetual license — access never expires
- Post-buyout: drops to $200/month (hosting only)
- Full platform ownership at month 36 — no further fees to Advisor AI
The Buyout Math
- Setup: $2,500
- Monthly × 36: $25,200
- Total to perpetual license: $27,700
- Post-buyout ongoing: $200/mo hosting only
- Perpetual license at month 36 — platform is yours forever
Best for: Businesses that want ownership but prefer to spread payments over time. You reach full ownership at 36 months at a total cost of $27,700 — $12,300 less than outright purchase. The key distinction vs. SaaS: there is a defined finish line. After month 36, your platform runs at $200/month forever regardless of what Advisor AI charges new customers.
What You Get
- All three phases on the same delivery timeline
- Founder rate — 20% below standard SaaS pricing, locked for life
- Direct input on feature roadmap — your requests get priority
- 18-month geographic territory protection (Jacksonville / St. Johns area)
- Named as founding case study (with your approval) — drives our marketing
- ~3 hours/month support included (more than any other model)
- After 24 months: buy out to perpetual license for $6,000 flat
The Founder Exchange
- You allow Advisor AI to reference Twinkle Nights as a client (with approval)
- You provide honest product feedback during build
- Territory protection: we don't sell to direct competitors in your market for 18 months
- You become the reference customer that makes this platform credible to others
Total 24-month cost: $16,900 ($2,500 + $600 × 24). Optional perpetual license at month 24: $6,000 (total $22,900 to full ownership — $17,100 less than outright purchase). Best for: Twinkle Nights specifically. You get the platform built to your workflow, at a rate that drops below the cost of the tools you're replacing, with 18 months before a competitor in your market could have the same tool. The case study value you provide is real — and it's reflected in your pricing.
What You Get
- All three phases on the same delivery timeline
- $150/month ongoing (hosting only — no subscription fee)
- Perpetual platform access at no additional charge
- 25% of all monthly subscription revenue from any new customer who signs up through your referral network or co-marketing
- Your story and name are central to how we market this to the industry
- First right of refusal on any equity arrangement if this becomes a standalone SaaS company
- Lifetime territory protection — we will never sell to a competitor in your immediate market
How the Revenue Share Works
- We market the platform to Christmas lighting companies nationally
- Standard subscription: $700/month per new customer
- Your 25% cut: $175/month per referred or co-marketed customer
- At 10 new customers: $1,750/month back to you
- At 20 new customers: $3,500/month back to you
- At 40 new customers: $7,000/month back to you
- Revenue share continues in perpetuity — no cap, no expiration
The math: You invest $25,000 upfront. At 20 co-marketed customers paying $700/month, you receive $3,500/month — your $25,000 is fully recovered in approximately 7 months. After that, it's passive income on a platform built to solve your own problem. Best for: An owner who thinks like a business builder, sees the potential for this platform beyond their own operation, and wants to participate in what it becomes. This is a co-venture, not a purchase. Twinkle Nights becomes the anchor customer and a business partner in the growth of the platform.
Side-by-Side
Model Comparison
| Feature / Term |
Model 1
Outright |
Model 2
SaaS |
Model 3
Rent-to-Own |
Model 4
Founder |
Model 5
Partner |
| Upfront cost |
$40,000 |
$500 |
$2,500 |
$2,500 |
$25,000 |
| Monthly fee |
$0 license |
$750/mo |
$700/mo |
$600/mo |
$150/mo |
| Total 24-month cost |
$40,000 |
$18,500 |
$19,300 |
$16,900 |
$28,600 |
| Perpetual license |
✓ Immediate |
✗ |
✓ Month 36 |
● Optional at mo. 24 (+$6k) |
✓ Immediate |
| Territory protection |
✗ |
✗ |
✗ |
✓ 18 months |
✓ Lifetime |
| Revenue share |
✗ |
✗ |
✗ |
✗ |
✓ 25% of referred |
| Feature roadmap input |
● Standard |
● Standard |
● Standard |
✓ Priority |
✓ Priority |
| Support included |
60-day post-launch |
2 hrs/mo |
2 hrs/mo |
3 hrs/mo |
3 hrs/mo |
| Minimum commitment |
None (one-time) |
24 months |
36 months |
24 months |
None |
| Best if you… |
Have capital, want clean ownership |
Want low entry, predictable OpEx |
Want ownership, prefer payments |
Want the best rate + protection |
Think like a business builder |
Next Steps
How We Move from Proposal to Platform
1
Select Your Model — This Week
No decision today. But we have a hard window: to deliver Phase 1 five weeks from kickoff and Phase 3 before your September ramp, we need to start by May 26, 2026. Decide your model and we schedule the kickoff call within 48 hours.
2
Kickoff Call — Phase 1 Spec Lock
A 90-minute working session to lock the Phase 1 feature spec, confirm the proposal template format, establish county tax rules, and align on the client-facing proposal design. Everything we need to build without coming back for decisions mid-sprint.
3
Weekly 30-Minute Syncs Throughout Build
Every Monday. You see what shipped. You answer any open questions. We confirm the next week's build targets. No surprises at delivery — you're watching it get built.
4
Phase 1 Delivery — Week 5
Core platform is live at your URL. You run it on real leads. Feedback goes into the bug list. The tax county bug is gone. Multi-year proposals work. You can send your first proposal from the new platform within days of delivery.
5
Full Platform Live — Week 13
All three phases delivered. Mockup builder, installation docs, CompanyCam integration, automated follow-up, returning client automation, and tax reporting all operational. Four weeks of buffer before September. Season starts with a full system.
Questions? Ready to move forward? Schedule a call: meetings.advisoraipartners.com