🪙 Penny Flow - Expense Tracker

Penny Flow is a real-time expense tracker built with React and Firebase, designed to make personal finance management effortless.
Track your expenses, set budgets, and visualize your financial journey with elegant charts and analytics.
Spend smart. Save better. Flow free.

🚀 Live Demo

👉 Visit Penny Flow Live

✨ Features

• 🔥 Real-time expense tracking
• 📊 Dynamic financial analytics (Monthly, Category, Weekday)
• 🏦 Set and monitor budgets
• 📅 Organize transactions by categories and time
• 🔔 Email alerts for budget limits (optional feature)
• 🔐 Secure authentication with Firebase
• 🌙 Light/Dark mode (optional upgrade)

🛠 Tech Stack

• Frontend: React.js, Tailwind CSS, Recharts (for data visualization)
• Backend: Firebase Firestore (database), Firebase Authentication
• Hosting: Vercel

⚙️ Setup Instructions

1. Clone the repository

   git clone https://github.com/your-username/penny-flow.git
   cd penny-flow
   Install dependencies
   npm install
   

Create a .env.local file in the root directory and add your Firebase credentials:

NEXT_PUBLIC_GEMINI_API_KEY=""
NEXT_PUBLIC_FIREBASE_API_KEY=""
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=""
NEXT_PUBLIC_FIREBASE_PROJECT_ID=""
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=""
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=""
NEXT_PUBLIC_FIREBASE_APP_ID=""
NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID=""
MAILTRAP_USER=""
MAILTRAP_PASS=""
NEXT_PUBLIC_EXCHANGERATE_API_KEY=""

Run the app locally

npm run dev

To deploy, connect the project to Vercel and run:

vercel deploy --prod

🙌 Contributions

• Contributions are welcome! Feel free to open a pull request or file an issue.

📬 Contact

• Built with ❤️ by Kunal Bishwal