Skip to content

NewdlDewdl/FinPath

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

FinPath - AI-Powered Financial Navigator for Life's Biggest Moments

πŸ† Built for Capital One's "Best Financial Hack" Track Navigate life's major transitions with AI-powered personalized financial roadmaps. No expensive advisors. No generic advice. Just clarity when you need it most.

Demo Built with Next.js Powered by OpenAI


🎯 For Judges: Why FinPath Wins

Criteria FinPath's Strength
Market Gap Fills the void between free generic advice ($0) and expensive financial advisors ($200/hr)
Technical Innovation Advanced prompt engineering delivers truly personalized, context-aware AI financial guidance
Impact Democratizes financial planning for 100% of people (everyone goes through life transitions)
Business Model Clear path to profitability: Freemium ($5-15/mo) + Affiliate partnerships + B2B (HR benefits)
Demo Factor Complete, polished user journey in 3 minutes with visible AI value proposition
Scalability Serverless architecture, ~$0.05/roadmap cost, profitable at scale

TL;DR: FinPath is the first AI-powered financial navigator purpose-built for life transitions. It's technically innovative, solves a real problem for millions, and has a clear business model.


πŸ’‘ The Problem We Solve

Scenario: You're expecting your first baby in 5 months. You're excited but terrified about the financial side.

❓ How much will this actually cost? ❓ Can we afford childcare on our income? ❓ Should we move to a bigger place? ❓ When do I need to do what?

Where do you turn?

Option Problem
πŸ“ Blog posts & Google Too generic. Doesn't account for YOUR income, location, or timeline
πŸ’° Financial advisor $200-400/hour, requires multiple sessions, inaccessible to most people
πŸ€– Generic AI chatbots No structured guidance, no accountability, overwhelming information dumps
πŸ“Š Budgeting apps (Mint, YNAB) Great for steady-state budgeting, useless for navigating transitions

The gap: Major life transitions are when people need financial guidance the most but have the fewest good options.

The Cost of Getting It Wrong

  • ❌ New parents waste $10,000+ in the first year on avoidable mistakes
  • ❌ First-time homebuyers overpay by $15,000+ due to poor timing/preparation
  • ❌ Career changers deplete savings 6 months too early from lack of runway planning

FinPath solves this.


✨ The Solution: AI-Powered Personalized Roadmaps

FinPath provides AI-generated, personalized financial roadmaps for major life transitions:

🎯 What Makes FinPath Different

  1. πŸ€– Truly Personalized AI

    • Not generic GPT responses
    • Considers YOUR income, location, timeline, and life situation
    • Context-aware prompt engineering for relevant, actionable advice
  2. πŸ—ΊοΈ Structured Roadmaps, Not Information Dumps

    • Clear timelines with realistic deadlines
    • Prioritized milestones (critical β†’ important β†’ recommended)
    • Actionable tasks for each milestone
    • Progress tracking to stay motivated
  3. βš–οΈ AI-Powered Decision Comparison

    • Compare major financial decisions (e.g., daycare vs nanny vs stay-at-home)
    • Detailed cost analysis (upfront, monthly, 1-year, 5-year projections)
    • Pros/cons tailored to YOUR situation
    • Data-driven recommendations
  4. πŸ’° Accessible Pricing

    • FinPath: $5-15/month β†’ Financial Advisor: $200-400/hour
    • 40x cheaper for comparable personalized guidance
  5. ⏰ Just-in-Time Guidance

    • Get the right information at exactly the right moment
    • No overwhelming 50-page financial plans you'll never read
    • Timely nudges and reminders for critical milestones

πŸš€ Features

Core Features

  • βœ… Life Transition Assessment - 2-minute quiz to understand your unique situation
  • βœ… AI-Generated Roadmap - Personalized financial milestones and action items
  • βœ… Interactive Timeline - Visual journey from start to financial security
  • βœ… Decision Comparison Tool - AI-powered analysis of major financial choices
  • βœ… Progress Tracking - Mark milestones complete, stay motivated
  • βœ… Educational Content - Bite-sized learning contextualized to YOUR transition

Supported Life Transitions

Transition What We Help With
πŸ‘Ά Having Your First Baby Emergency fund, childcare costs, insurance, 529 plans, budget adjustments
🏠 Buying Your First Home Down payment, mortgage planning, closing costs, maintenance reserves
πŸ’Ό Career Change Financial runway, skill-building budget, income gap bridging
πŸ’ Getting Married Joint finances, goal alignment, wedding budgeting, combined planning
🌴 Planning Retirement 401k/IRA strategy, healthcare, Social Security timing, downsizing
πŸš€ Starting a Business Runway calculation, incorporation costs, tax planning, sustainable growth

πŸ› οΈ Tech Stack

Frontend

  • Next.js 14 (App Router) + React + TypeScript
  • Tailwind CSS + shadcn/ui for beautiful, accessible UI
  • Framer Motion for smooth animations
  • Recharts for data visualization

Backend

  • Next.js API Routes (serverless)
  • OpenAI GPT-4o API for AI generation
  • Advanced prompt engineering for structured outputs

Data & State

  • Local storage (demo)
  • Supabase (production roadmap)

Deployment

  • Vercel (one-click deploy)
  • Edge functions for low latency

Why These Choices?

  • ⚑ Fast development - Built entire MVP in 12 hours
  • πŸ“ˆ Scales to millions - Serverless architecture
  • πŸ’΅ Cost-effective - ~$0.05 per roadmap generation
  • 🎨 Production-ready UI - shadcn/ui components look professional out of the box

🎬 Quick Start

Prerequisites

Installation

# 1. Clone the repository
git clone <your-repo-url>
cd Capital_One_Track_UTD

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .env.example .env.local

# 4. Add your OpenAI API key to .env.local
# OPENAI_API_KEY=sk-your-key-here

# 5. Run the development server
npm run dev

# 6. Open http://localhost:3000

First-time setup: Under 5 minutes ⚑


πŸ“ Project Structure

Capital_One_Track_UTD/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ api/
β”‚   β”‚   β”œβ”€β”€ generate-roadmap/     # AI roadmap generation endpoint
β”‚   β”‚   └── compare-options/      # Decision comparison endpoint
β”‚   β”œβ”€β”€ onboarding/                # Multi-step quiz flow
β”‚   β”œβ”€β”€ dashboard/                 # Main dashboard with roadmap & timeline
β”‚   β”œβ”€β”€ layout.tsx                 # Root layout with fonts & metadata
β”‚   └── page.tsx                   # Landing page
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ ui/                        # shadcn/ui components (button, card, etc.)
β”‚   β”œβ”€β”€ LifeTransitionQuiz.tsx     # Multi-step assessment component
β”‚   β”œβ”€β”€ FinancialTimeline.tsx      # Timeline visualization component
β”‚   └── DecisionComparison.tsx     # Comparison tool component
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ types.ts                   # TypeScript type definitions
β”‚   β”œβ”€β”€ ai-prompts.ts              # AI prompt engineering templates
β”‚   β”œβ”€β”€ openai.ts                  # OpenAI client wrapper
β”‚   └── utils.ts                   # Utility functions
β”œβ”€β”€ public/                        # Static assets
β”œβ”€β”€ .env.example                   # Environment variables template
β”œβ”€β”€ DEMO_SCRIPT.md                 # Complete demo & pitch guide
└── README.md                      # You are here

🎀 Demo Flow (For Judges)

Total Time: 3-4 minutes See detailed script: DEMO_SCRIPT.md

Quick Demo Outline

  1. Landing Page (30s) β†’ Show value prop, click "Get Your Free Roadmap"
  2. Onboarding (1m) β†’ Select "Expecting First Baby", fill in Sarah's details (SF, $85k income)
  3. AI Generation (15s) β†’ Watch AI analyze Sarah's specific situation
  4. Dashboard (1.5m) β†’ Explore personalized timeline, expand milestones, show action items
  5. Decision Comparison (1m) β†’ Generate "Daycare vs Nanny" comparison, show cost analysis

Key talking points:

  • Emphasize personalization (income, location, timeline)
  • Highlight actionable guidance (not just information)
  • Demonstrate AI decision support (comparison tool)
  • Mention cost savings (vs $200/hr advisor)

πŸ† Why FinPath Wins This Hackathon

1. Solves a Real, Universal Problem

  • 100% of people go through major life transitions
  • $10,000+ lost per person due to poor financial planning during transitions
  • 74% of Americans report financial stress during major life events
  • Current solutions are inadequate (too generic or too expensive)

2. Technical Innovation

Advanced Prompt Engineering:

  • Context-rich prompts with income, location, timeline, life event details
  • Structured JSON outputs validated for quality
  • Few-shot examples for consistent tone and advice quality
  • Temperature tuning (0.7) for creative but reliable responses

Scalable Architecture:

  • Serverless APIs scale to millions automatically
  • Edge deployment for global low latency
  • Stateless design for horizontal scaling
  • OpenAI API cost: ~$0.05/roadmap (highly profitable at $5-15/mo pricing)

Production-Ready in 12 Hours:

  • Modern tooling (Next.js 14, TypeScript, Tailwind)
  • AI-assisted development (Cursor AI agents)
  • Component library (shadcn/ui) for polished UI
  • Git workflow, linting, type safety

3. Clear Business Model

Revenue Stream Description TAM
Freemium Subscriptions Basic roadmap free, premium features $5-15/mo 200M+ Americans experience life transitions annually
Affiliate Partnerships Financial products (insurance, 529 plans, savings accounts) $50-200 per referral
B2B Enterprise HR benefits for life event support Fortune 500 companies, $10-50/employee/year
Premium Advisory Connect users with vetted human advisors $50 referral fee

Unit Economics (Projected):

  • CAC (Customer Acquisition Cost): $15 (content marketing, SEO)
  • Monthly subscription: $10
  • Lifetime Value (18-month retention): $180
  • LTV:CAC Ratio: 12:1 βœ…

4. Massive Market Opportunity

Total Addressable Market:

  • πŸ‡ΊπŸ‡Έ 200M+ Americans experience major life transitions annually
  • 🌍 1B+ people globally in addressable markets

Initial Target:

  • New parents (US): 3.6M/year
  • First-time homebuyers (US): 4.5M/year
  • Career changers (US): 50M+ over 5 years

Market Gap:

  • Financial advisors serve <5% of population (too expensive)
  • Budgeting apps focus on steady-state (Mint, YNAB)
  • No one is solving for life transitions specifically

5. Social Impact

  • βœ… Democratizes access to quality financial advice
  • βœ… Reduces wealth inequality through education
  • βœ… Helps people avoid costly mistakes ($10k+ savings per user)
  • βœ… Reduces financial stress during already stressful life events
  • βœ… Empowers underserved communities with accessible guidance

6. Demo-ability

  • βœ… Complete user journey works end-to-end
  • βœ… Visible AI value (personalization, insights, comparisons)
  • βœ… Polished UI that looks production-ready
  • βœ… Fast loading, smooth animations
  • βœ… Mobile responsive
  • βœ… No bugs in critical path

Judges will see: A real product that solves a real problem, not a hackathon prototype.


πŸ“Š Competitive Landscape

Competitor Focus Limitation
Mint / YNAB Budgeting & expense tracking Steady-state only, not transition-focused
Personal Capital Wealth management Requires $100k+ assets, not for transitions
ChatGPT / Claude General Q&A No structure, no accountability, overwhelming
Financial advisors Comprehensive planning $200-400/hr, inaccessible to most
Blog content SEO-driven articles Generic, not personalized, no action plan

FinPath's Moat:

  • 🎯 Only platform focused on life transitions specifically
  • πŸ€– Purpose-built AI prompts for financial roadmaps (not generic chatbot)
  • ⚑ Just-in-time guidance at the moment users need it
  • πŸ’° Accessible pricing ($5-15/mo vs $200/hr)

πŸ›£οΈ Future Roadmap

Phase 1: MVP (Complete) βœ…

  • 6 life transitions supported
  • AI roadmap generation
  • Decision comparison tool
  • Interactive timeline
  • Progress tracking

Phase 2: User Validation (Months 1-3)

  • 100 beta users
  • Collect feedback & iterate
  • Add authentication & data persistence (Supabase)
  • Email/SMS reminders for milestones
  • Mobile-responsive optimizations

Phase 3: Monetization (Months 3-6)

  • Launch freemium model ($5/mo premium)
  • Affiliate partnerships (insurance, 529 plans)
  • First B2B pilot (HR benefits platform)
  • Analytics dashboard for users

Phase 4: Scale (Months 6-12)

  • 10,000 paying users
  • Plaid integration for financial accounts
  • Community features (forums, shared roadmaps)
  • Mobile app (React Native)
  • Expand to 12+ life transitions
  • Raise seed round ($1-2M)

Phase 5: Enterprise (Year 2+)

  • B2B sales to Fortune 500 HR departments
  • White-label solution for financial institutions
  • International expansion (Canada, UK, Australia)
  • AI coach (conversational guidance)

🚒 Deployment

Deploy to Vercel (Recommended)

Option 1: GitHub Integration

  1. Push code to GitHub
  2. Import project in Vercel
  3. Add environment variable: OPENAI_API_KEY
  4. Deploy! (automatic on every push)

Option 2: Vercel CLI

# Install Vercel CLI
npm i -g vercel

# Login
vercel login

# Deploy
vercel

# Add environment variable
vercel env add OPENAI_API_KEY production

# Deploy to production
vercel --prod

Deployment time: <3 minutes ⚑


πŸ”§ Development

# Run development server (with hot reload)
npm run dev

# Build for production
npm run build

# Run production server locally
npm start

# Lint code
npm run lint

# Type check
npx tsc --noEmit

🀝 Contributing

This is a hackathon project, but we welcome contributions!

How to contribute:

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

πŸ“„ License

MIT License - Feel free to use for learning or building upon.


πŸ™ Acknowledgments

  • Capital One for hosting this hackathon and the "Best Financial Hack" track
  • OpenAI for GPT-4o API powering our AI guidance
  • Vercel for seamless deployment and hosting
  • shadcn/ui for beautiful, accessible component library
  • Cursor AI for accelerating development with AI agents

Built with ❀️ using AI Designed to empower financial decisions during life's biggest moments

πŸš€ Try the Demo β€’ πŸ“– Read the Pitch β€’ ⭐ Star on GitHub

About

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors