Track payments. Understand spending. Make smarter financial decisions.
PayTrack is a full-stack expense tracking application that integrates PayPal Sandbox payments with manual expense tracking, interactive analytics, and rule-based financial insights.
Live Demo: https://paypal-expense-tracker.vercel.app/
- GitHub Authentication: Secure sign-in using Auth.js and GitHub OAuth.
- PayPal Sandbox Integration: Create and complete test payments through PayPal.
- Manual Expense Tracking: Record and manage expenses in USD.
- Unified Transaction History: View PayPal payments and manual expenses together without double-counting.
- Interactive Analytics: Explore spending trends across 7 days, 30 days, 3 months, and 6 months.
- Category Breakdown: Analyze spending with interactive donut charts and time filters.
- Financial Insights: View rule-based spending observations, month-over-month comparisons, and illustrative savings opportunities.
- Responsive Dashboard: Modern, violet-themed interface for tracking expenses.
Track your expenses and view your financial overview.
Complete test payments through PayPal Sandbox.
View manual expenses and PayPal payments in one place.
Explore spending trends, category breakdowns, and financial insights.
PayTrack is built with Next.js and deployed on Vercel. It uses GitHub OAuth for authentication, PayPal Sandbox for payment processing, and Prisma with Neon PostgreSQL for persistent storage.
flowchart TD
A["User / Browser"] --> B["Next.js Application on Vercel"]
B --> C["Auth.js v5"]
C --> D["GitHub OAuth"]
B --> E["Next.js API Routes"]
E --> F["PayPal Sandbox API"]
E --> G["Prisma ORM"]
C --> G
G --> H[("Neon PostgreSQL")]
E --> I["Analytics & Financial Insights"]
I --> B
- A user signs in using GitHub OAuth.
- The user creates a manual expense or initiates a PayPal Sandbox payment.
- Next.js API routes validate and process the request.
- Completed transactions are saved in PostgreSQL using Prisma.
- Analytics combines completed manual and PayPal transactions in USD.
- Interactive charts and financial insights display the updated spending data.
PayPal orders and mirrored transactions are not counted twice in spending totals.
| Layer | Technology |
|---|---|
| Frontend | Next.js, React, TypeScript |
| Styling | Tailwind CSS |
| Authentication | Auth.js v5, GitHub OAuth |
| Database | PostgreSQL (Neon) |
| ORM | Prisma |
| Payments | PayPal Sandbox |
| Charts | Recharts |
| Deployment | Vercel |
- Sign in securely using GitHub.
- Add a manual expense or complete a PayPal Sandbox payment.
- PayTrack stores the completed transaction in PostgreSQL.
- View all transactions in a unified history.
- Explore interactive charts and spending insights.
- Node.js and npm
- PostgreSQL database
- GitHub OAuth application
- PayPal Sandbox developer credentials
git clone https://github.com/PreDiv-Labs/paypal-expense-tracker.git
cd paypal-expense-tracker
npm installCreate a .env file with the environment variables required by your configuration, including:
DATABASE_URL=""
AUTH_SECRET=""
AUTH_GITHUB_ID=""
AUTH_GITHUB_SECRET=""
PAYPAL_CLIENT_ID=""
PAYPAL_CLIENT_SECRET=""
PAYPAL_MERCHANT_ID=""Never commit real credentials to GitHub.
npx prisma generate
npx prisma migrate deploynpm run devOpen http://localhost:3000.
PayTrack is deployed on Vercel using Neon PostgreSQL, with GitHub OAuth authentication and PayPal Sandbox payment processing.
Live Application: https://paypal-expense-tracker.vercel.app/
PayTrack currently supports USD transactions and uses PayPal Sandbox for payment demonstrations. Financial insights are generated through application logic rather than paid AI services.
- CSV export and reporting
- Customizable spending goals
- More advanced transaction search and filtering
- Additional financial visualizations
Built together by Divya Kumari and Preet.
License to be determined.