This MVP was autonomously generated by MVP Factory v11 using a free-tier AI API (NVIDIA / Kimi K2.5). Simple logic runs for real. Complex external dependencies are stubbed so the app always works.

# Option A: Supabase (Postgres, free tier)
npm install @supabase/supabase-js
# In each route: import { createClient } from '@supabase/supabase-js'
# Replace the mock array with: const { data } = await supabase.from('table').select()

# Option B: PlanetScale (MySQL, free tier)
npm install @planetscale/database

Look for // TODO: replace with DB comments in src/app/api/**/route.ts

// In any API route, replace the hardcoded AI string with:
const res = await fetch('https://integrate.api.nvidia.com/v1/chat/completions', {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${process.env.NVIDIA_API_KEY}`,
             'Content-Type': 'application/json' },
  body: JSON.stringify({
    model: 'moonshotai/kimi-k2.5',
    messages: [{ role: 'user', content: yourPrompt }],
    max_tokens: 1024
  })
});
const { choices } = await res.json();
return NextResponse.json({ result: choices[0].message.content });

Add NVIDIA_API_KEY=your_key to .env.local

npm install next-auth
# 1. Create src/app/api/auth/[...nextauth]/route.ts with your provider
# 2. Replace localStorage.setItem("auth_token",...) in auth/page.tsx with signIn()
# 3. Replace localStorage.getItem("auth_token") in dashboard/page.tsx with useSession()

npm install resend
# Replace the { sent: true } mock in notification routes with:
# await resend.emails.send({ from: 'you@domain.com', to: email, subject, html })

npm install stripe @stripe/stripe-js
# Replace demo payment routes with real Stripe checkout sessions

All the UI is already wired up. Every form already calls the right API route. You only need to swap the stubbed returns for real implementations.

Siblings inheriting property 50/50 face emotional deadlock when one wants to rent ($2k/month) and other wants to sell, with no objective way to evaluate tax implications, buyout options, or break the tie without expensive legal fees.

• ❌ Emotional family tension preventing rational financial decisions
• ❌ Lack of objective data to support rent-vs-sell arguments
• ❌ Fear of paying $15k+ in attorney fees for simple disputes
• ❌ Uncertainty about tax implications and hidden costs
• ❌ No neutral ground to discuss buyout options without accusations of greed

Rent-vs-Sell Financial Simulator with real-time tax implication calculations including stepped-up basis adjustments, capital gains projections, and depreciation recapture modeling

Mortgage Buyout Equity Calculator with cash-flow modeling, refinancing scenario comparisons, and fair payment schedule generation based on ownership percentages

Anonymous Ranked-Choice Voting System with vote-weighting algorithms tied to deed ownership percentages and blind voting mode to reduce family bias

Vetted Mediator Matching Engine filtering by conflict type (sibling rivalry vs. cousin disputes), state jurisdiction, and calendar integration for booking neutral third parties

Secure Document Vault with role-based access control, version history tracking, and e-signature workflows for co-ownership agreements and buyout contracts

Probate Deadline Tracker with automated SMS/email notifications for tax filing deadlines, option expiration dates, and court-mandated decision timelines

Fair Market Value Consensus Tool aggregating multiple property valuation APIs (Zillow, Redfin, Realtor.com) with outlier detection and confidence scoring

A step-by-step breakdown of how each feature is built. Use this as your dev roadmap.

What it does: Rent-vs-Sell Financial Simulator with real-time tax implication calculations including stepped-up basis adjustments, capital gains projections, and depreciation recapture modeling

How to implement:

Potential enhancements:

• ⚡ Cache repeated lookups with unstable_cache or Redis
• 🔒 Add rate limiting to /api/rent-vs-sell-financial-simulator-with-real-time-tax-implication-calculations-including-stepped-up-basis-adjustments-capital-gains-projections-and-depreciation-recapture-modeling (e.g. Upstash Ratelimit)
• 📱 Make the UI section responsive-first (mobile breakpoints)
• 📊 Log feature usage to analytics (Plausible / PostHog)
• 🧪 Add an integration test for the API route

What it does: Mortgage Buyout Equity Calculator with cash-flow modeling, refinancing scenario comparisons, and fair payment schedule generation based on ownership percentages

How to implement:

Potential enhancements:

• ⚡ Cache repeated lookups with unstable_cache or Redis
• 🔒 Add rate limiting to /api/mortgage-buyout-equity-calculator-with-cash-flow-modeling-refinancing-scenario-comparisons-and-fair-payment-schedule-generation-based-on-ownership-percentages (e.g. Upstash Ratelimit)
• 📱 Make the UI section responsive-first (mobile breakpoints)
• 📊 Log feature usage to analytics (Plausible / PostHog)
• 🧪 Add an integration test for the API route

What it does: Anonymous Ranked-Choice Voting System with vote-weighting algorithms tied to deed ownership percentages and blind voting mode to reduce family bias

How to implement:

Potential enhancements:

• ⚡ Cache repeated lookups with unstable_cache or Redis
• 🔒 Add rate limiting to /api/anonymous-ranked-choice-voting-system-with-vote-weighting-algorithms-tied-to-deed-ownership-percentages-and-blind-voting-mode-to-reduce-family-bias (e.g. Upstash Ratelimit)
• 📱 Make the UI section responsive-first (mobile breakpoints)
• 📊 Log feature usage to analytics (Plausible / PostHog)
• 🧪 Add an integration test for the API route

What it does: Vetted Mediator Matching Engine filtering by conflict type (sibling rivalry vs. cousin disputes), state jurisdiction, and calendar integration for booking neutral third parties

How to implement:

Potential enhancements:

• ⚡ Cache repeated lookups with unstable_cache or Redis
• 🔒 Add rate limiting to /api/vetted-mediator-matching-engine-filtering-by-conflict-type (e.g. Upstash Ratelimit)
• 📱 Make the UI section responsive-first (mobile breakpoints)
• 📊 Log feature usage to analytics (Plausible / PostHog)
• 🧪 Add an integration test for the API route

What it does: Secure Document Vault with role-based access control, version history tracking, and e-signature workflows for co-ownership agreements and buyout contracts

How to implement:

Potential enhancements:

• ⚡ Cache repeated lookups with unstable_cache or Redis
• 🔒 Add rate limiting to /api/secure-document-vault-with-role-based-access-control-version-history-tracking-and-e-signature-workflows-for-co-ownership-agreements-and-buyout-contracts (e.g. Upstash Ratelimit)
• 📱 Make the UI section responsive-first (mobile breakpoints)
• 📊 Log feature usage to analytics (Plausible / PostHog)
• 🧪 Add an integration test for the API route

What it does: Probate Deadline Tracker with automated SMS/email notifications for tax filing deadlines, option expiration dates, and court-mandated decision timelines

How to implement:

Potential enhancements:

• ⚡ Cache repeated lookups with unstable_cache or Redis
• 🔒 Add rate limiting to /api/probate-deadline-tracker-with-automated-sms-email-notifications-for-tax-filing-deadlines-option-expiration-dates-and-court-mandated-decision-timelines (e.g. Upstash Ratelimit)
• 📱 Make the UI section responsive-first (mobile breakpoints)
• 📊 Log feature usage to analytics (Plausible / PostHog)
• 🧪 Add an integration test for the API route

What it does: Fair Market Value Consensus Tool aggregating multiple property valuation APIs (Zillow, Redfin, Realtor.com) with outlier detection and confidence scoring

How to implement:

Potential enhancements:

• ⚡ Cache repeated lookups with unstable_cache or Redis
• 🔒 Add rate limiting to /api/fair-market-value-consensus-tool-aggregating-multiple-property-valuation-apis (e.g. Upstash Ratelimit)
• 📱 Make the UI section responsive-first (mobile breakpoints)
• 📊 Log feature usage to analytics (Plausible / PostHog)
• 🧪 Add an integration test for the API route

User Request
      │
      ▼
  Next.js Edge ──► API Route ──► Business Logic ──► Data Store
      │                               │
  React UI ◄────────────────── Response / JSON
      │
  Real-time UI Update

MVP Factory Validation Report — 2026-03-03
═══════════════════════════════════════════════════════

✅ PASS  Market Demand             █████████░ 9/10
✅ PASS  Competition Gap           █████████░ 9/10
✅ PASS  Technical Feasibility     ████████░░ 8/10
✅ PASS  Monetization Potential    ██████░░░░ 6/10
✅ PASS  Audience Fit              █████████░ 9/10

─────────────────────────────────────────────────────
         OVERALL SCORE  ████████░░ 8.4/10
         VERDICT        🟢 BUILD — Strong market opportunity
         TESTS PASSED   5/5
═══════════════════════════════════════════════════════

Why this works: Severe pain validated by high-engagement Reddit post (386 comments indicates deep emotional resonance). Zero direct competitors solving the specific workflow of post-inheritance dispute resolution combined with financial modeling. While monetization is challenged by one-time use nature, the freemium model with mediator marketplace commissions creates sustainable revenue. High technical feasibility using existing property APIs and straightforward voting logic.

Unique angle: 💡 The only platform combining objective financial modeling with structured dispute resolution workflows specifically designed for inherited property conflicts, including neutral mediator matching when quantitative analysis fails to convince emotional stakeholders.

Competitors analyzed: LegalZoom (estate planning only, no dispute resolution), CoBuy (co-ownership purchasing platform, not inheritance), Generic spreadsheet calculators (lack collaboration and mediation features)

Next.js 14 App Router + TypeScript + TailwindCSS + Lucide-react

# Clone & install
git clone https://github.com/guyromb/heirharmony.git
cd heirharmony
npm install

# Start development
npm run dev
# → http://localhost:3000

# Build for production
npm run build
npm start

# Add your keys here
NEXT_PUBLIC_APP_NAME=HeirHarmony

Contributions are welcome! Here's how:

1. Fork the repo
2. Create your branch: git checkout -b feature/amazing-feature
3. Commit: git commit -m 'Add amazing feature'
4. Push: git push origin feature/amazing-feature
5. Open a Pull Request

MIT License — see LICENSE for details.