FreelanceFlow AI

An AI-powered finance assistant that helps freelancers generate invoices, track payments, predict cash flow, and automate payment reminders using intelligent workflows and PayPal integration.

Comment

Inspiration

What it does

How we built it

💡 Inspiration

Freelancing gives creators freedom, but it comes with a major vulnerability: unpredictable cash flow and delayed client payments. Traditional accounting software looks backwards—it tells you what you spent last month, but fails to answer critical forward-looking questions like:

  • "Can I afford a $25,000 studio purchase right now?"
  • "What happens to my runway if my biggest client pays 15 days late?"
  • "Which overdue client should I follow up on first?"

We built FreelanceFlow AI to turn freelancer finance into an intelligent Decision Engine backed by real-time PayPal Sandbox settlements.

⚙️ What It Does

FreelanceFlow AI is a comprehensive financial cockpit and decision companion for freelancers:

  1. AI Financial Decision Engine: Runs deterministic financial arithmetic (zero numeric hallucinations) to stress-test planned purchases against available cash, committed recurring expenses, and open receivables.
  2. Demonstrable PayPal Sandbox Checkout: Invoices feature an integrated PayPal Sandbox payment modal where clients or testers can simulate payments in seconds, automatically flipping invoices to "Paid", updating liquid balances, and recording settlement history.
  3. Multi-Timeframe Cash Flow Forecasting: Seamlessly toggle across 30 Days, 3 Months, 6 Months, and 1 Year with dynamic curve projections and operating runway indicators.
  4. Tone-Aware AI Payment Reminders: Generate Friendly, Firm, or Concise follow-up emails with 1-click PayPal payment links for past-due clients (like Northstar Studio's $2,850 overdue invoice).
  5. Printable PDF Invoices & Client CRM: Clean, print-ready client invoice modal and a dedicated client relationship manager.
  6. Multi-Currency Reconciled Ledger: Instant conversion across USD, INR (₹85/$), and EUR (€0.92/$) with 100% mathematical consistency.

🛠️ How We Built It

  • Frontend: Built with React 19, Vite, and TypeScript, styled using a bespoke forest-and-ivory aesthetic with responsive slidebar navigation, dynamic SVG charting, and glassmorphic HUD cards.
  • Payment Layer: Integrated PayPal REST API and @paypal/react-paypal-js for Sandbox order creation, capture, and real-time ledger reconciliation.
  • AI & Financial Engine: Powered by a dual-path engine combining OpenAI models with deterministic arithmetic algorithms so recommendations are always grounded in verified numbers, with a robust offline client-side fallback.
  • State & Architecture: Managed via TanStack React Query and localized workspace persistence, deployed globally on Vercel.

🧗 Challenges We Ran Into

  • Reconciling Financial Numbers: Ensuring every penny matched across the dashboard HUD, runway forecasts, overdue invoices, and PayPal settlements required a disciplined mathematical model.
  • Eliminating AI Number Hallucinations: Standard LLMs often guess financial arithmetic. We solved this by executing exact calculations on the client/ledger state first, then using AI to explain the underlying logic transparently.
  • End-to-End PayPal Demonstration: Ensuring judges could test the checkout loop seamlessly without needing live credentials or risking 401 token expiration.

🏆 Accomplishments That We're Proud Of

  • A demonstrable, closed-loop PayPal checkout that immediately updates the live cash ledger.
  • The Affordability Simulator that transparently explains why a $25,000 purchase isn't feasible with an $8,420 cash balance, detailing the exact revenue gap.
  • An intuitive UI featuring dynamic multi-month cash flow curves, print-ready PDF invoices, and sub-second responses.

📖 What We Learned

  • How to design resilient fintech UX that bridges asynchronous payment gateways (PayPal) with real-time financial decision models.
  • The importance of deterministic logic when presenting financial intelligence—users and judges trust AI only when the math is undeniably accurate.

🚀 What's Next for FreelanceFlow AI

  • Automated PayPal invoice generation synced directly with clients' PayPal accounts.
  • Milestone-based escrow and recurring retainer payments via PayPal Subscriptions.
  • Multi-banking aggregation to sync live balances alongside PayPal wallet funds. ## Challenges we ran into

Accomplishments that we're proud of

What we learned

What's next for FreelanceFlow AI

Built With

Share this project:

Updates

Submission history