Build hybrid QuickFix and Thumbtack repair journey by role

Objective

• Build a role-based repair journey that presents two paths in the quote flow:
• Rapid Quote / QuickFix for fast, paid buyer-agent negotiation support
• Thumbtack / ProPair for free quote discovery and execution-oriented workflows
• Reduce friction in the current Thumbtack flow and improve overall post-inspection repair adoption.

Background

• Product feedback calls for a split journey because buyer-agent negotiation needs differ from listing-agent and homeowner execution needs.
• In the May 15 feature sync, Chris said Thumbtack had effectively launched everywhere but was being used less than expected, making adoption one of the biggest current problems.
• The team discussed changing the process so agents are pushed more directly toward QuickFix while still giving an alternate Thumbtack option for broader or free quote discovery.
• The transcript also highlighted that the categorization step appears to be a major source of friction and confusion.
• The intended downstream motion is also audience-specific:
• agents should be able to choose a fast QuickFix path for negotiation support
• buyers/homeowners can be retargeted post-move-in with more contextual prompts that link directly into the repair journey

Scope

Frontend (attik-frontend)

• Existing ProPair entry and branching logic is in src/app/client/reports/components/RepairListSidebar.tsx (GET FREE REPAIR QUOTES, proPairExperience gate) and src/app/client/job/[slug]/components/RepairQuotesDisplay.tsx (old vs new experience split).
• ProPair experience setting is exposed in src/app/tools/settings/report-settings/ReportSettingsForm.tsx via proPairExperience; this already controls whether the category-based request flow is used.
• Current Thumbtack request journey is implemented in:
• src/app/client/reports/[slug]/repair-list/[id]/components/CategorizationPageClient.tsx
• src/app/client/reports/[slug]/repair-list/[id]/request/page.tsx
• src/app/client/reports/[slug]/repair-list/[id]/request/components/MultiCategoryRequestClient.tsx
• src/app/client/reports/[slug]/repair-list/[id]/request/components/RequestFlowDrawer.tsx
• New hybrid UX likely belongs at the ProPair CTA entry point (before categorization/request routes), with explicit role-aware branching and confirmation states.
• The revised UX should support a simpler choice model such as:
• full quote via QuickFix
• free quotes / limited-item path via Thumbtack
• The buyer retargeting path may also need a more direct entry experience that avoids reintroducing the same categorization friction.

Backend (attik-backend)

• Thumbtack and repair-list quote infrastructure already exists:
• src/routes/repairList.ts (/categorize, /categories, /request-quotes, quote submission tracking)
• src/routes/thumbtack.ts and src/util/functions/thumbtack/* (search, form prefill, request flow)
• src/models/repairListSchema.ts (submission type supports thumbtack | partner | other)
• Report setting persistence for enabling/disabling ProPair experience is in src/models/reportSettingsSchema.ts (proPairExperience default true).
• Service and role-level access controls for quote features are already modeled (repair-quote, repair-quote-fallback) in service/role schemas and permission data.
• Decision needed on QuickFix backend integration shape:
• account connection model
• request payload and response storage
• whether QuickFix is stored as a new submission type vs separate track
• rollout toggles so hybrid does not appear on all reports by default

Rollout / configuration

• Scope includes per-company or per-report experience toggles (existing proPairExperience + any new QuickFix gating).
• Decision needed on pilot gating strategy (market/company/environment) and measurement signals for pathway adoption and success.
• Success metrics should line up with the broader post-inspection revenue dashboard work so the team can measure whether the new journey improves repair-list and Thumbtack adoption.

References

• attik-frontend/src/app/client/reports/components/RepairListSidebar.tsx
• attik-frontend/src/app/client/job/[slug]/components/RepairQuotesDisplay.tsx
• attik-frontend/src/app/tools/settings/report-settings/ReportSettingsForm.tsx
• attik-backend/src/routes/repairList.ts
• attik-backend/src/routes/thumbtack.ts
• attik-backend/src/models/reportSettingsSchema.ts
• attik-backend/src/models/repairListSchema.ts