-
-
Financial overview showing expected inflows, upcoming expenses, projected cash flow, and overdue invoices
-
Track business invoices, payment statuses, due dates, and outstanding amounts in one place
-
Gemini-powered personalized payment reminder drafts with owner review and approval
-
Manage business expenses and monitor upcoming financial obligations
Inspiration
Freelancers and small businesses often struggle with delayed client payments. Even after completing their work, they may have to spend time following up on unpaid invoices while managing their own upcoming expenses. This can create uncertainty about whether enough money will be available to meet financial obligations.
I wanted to build a solution that helps business owners become more proactive about managing their cash flow instead of simply reacting to payment delays.
What it does
Cash-Flow Guardian is an AI-powered financial assistant designed for freelancers and small businesses.
It brings several important financial activities together:
- Invoice Management: Track invoices, payment statuses, due dates, and outstanding amounts.
- AI-Powered Reminders: Generate personalized payment reminder drafts using Google's Gemini API.
- Human Approval: Let business owners review, approve, or reject AI-generated reminders before taking further action.
- Expense Tracking: Manage business expenses and upcoming payment obligations.
- Cash-Flow Forecasting: Estimate expected incoming payments and upcoming expenses to identify potential cash shortages.
- PayPal Integration: Connect with PayPal Sandbox APIs and webhooks to support invoice-related integration workflows.
How we built it
The frontend was developed using React, TypeScript, and Vite. The backend uses Django and Django REST Framework, with PostgreSQL for production data storage.
Google's Gemini API powers personalized reminder generation. PayPal Sandbox APIs and webhooks provide the payment integration layer. The application is deployed on Render.
The application also includes authentication and a business workspace for managing financial information.
Challenges we faced
One of the main challenges was designing an AI reminder workflow that keeps business owners in control. Instead of automatically sending AI-generated messages, we implemented a review-and-approval approach.
Another challenge was keeping application-derived overdue status separate from PayPal invoice statuses and designing a useful cash-flow estimate based on expected payments and expenses.
Integrating the frontend, backend, database, external APIs, and deployment into one working application also required careful testing and debugging.
What we learned
Building Cash-Flow Guardian helped us understand how to develop and integrate a full-stack application, work with external APIs and webhooks, use AI for a practical business problem, and design human-in-the-loop workflows.
Most importantly, we learned that AI should assist business owners in making decisions while keeping important financial actions under their control.
What's next
Future improvements could include more advanced cash-flow forecasting, richer payment-plan proposals, improved notification workflows, and deeper PayPal integration.
