🌸 Personal Finance Tracker 💕

Live Demo: Kawaii Finance Tracker

A cute and interactive web app for tracking expenses, budgets, and savings goals. It features user authentication, automated categorization, and beautiful visualizations — all wrapped in a fun pastel design.

---

✨ Features

• 🔐 User Authentication: Secure login/register with password hashing
• 💰 Transaction Management: Add income and expenses with smart categorization
• 🔄 Recurring Transactions: Handle salaries, bills, and subscriptions automatically
• 📊 Interactive Charts: Visualize spending and income patterns
• 🎨 Kawaii UI: Soft pastel theme with animations and emojis
• 📱 Responsive Design: Optimized for desktop and mobile
• 👤 Private Data: Each user sees only their own records
• 💾 SQLite Database: Lightweight, easy to deploy

---

🛠️ Tech Stack

• Backend: Python (Flask)
• Frontend: HTML5, CSS3, Bootstrap 5
• Database: SQLite (with user isolation)
• Authentication: Werkzeug password hashing, Flask sessions
• Charts: Chart.js with custom pastel themes
• Deployment: Railway.app (HTTPS + Git CI/CD)

---

🔐 Security Overview

• Hashed Passwords (PBKDF2) with unique salts
• Encrypted Sessions for login state
• Parameterized Queries to prevent SQL injection
• User Data Isolation through foreign key relationships
• Input Validation for date, type, and completeness

For production: Add environment-based config, secure cookies, rate limiting, and switch to PostgreSQL with encryption.

---

🚀 Getting Started

Prerequisites

• Python 3.7+
• Git installed

Setup

git clone https://github.com/BlissPhinehas/personal-finance-tracker.git
cd personal-finance-tracker
pip install -r requirements.txt
python app.py

Visit http://127.0.0.1:5000

---

📸 Screenshots

---

🎯 Advanced Features

• 🏷️ Automatic Categorization based on keywords
• 🔁 Recurring Transaction Logic with frequency options
• 📊 Real-Time Charts via AJAX updates

---

🔮 Future Enhancements

• 📄 CSV import for bank statements
• 💰 Budget tracking and savings goals
• 📈 Advanced financial reports
• 🔐 2FA and session management
• 🤖 AI-based spending insights
• 📱 Mobile app (React Native)

---

🤝 Contributing

Open to suggestions and pull requests for:

• Security improvements
• New financial features
• UI/UX optimization
• Testing coverage

---

📄 License

MIT License – Free to use and modify for learning or personal projects.

---

🎨 Credits

• Design: Kawaii-inspired pastel theme
• Typography: Nunito (Google Fonts)
• Icons: Unicode emojis

---

📞 Contact & Portfolio

• GitHub: BlissPhinehas
• Live Demo: Kawaii Finance Tracker

“Combining technical skills with creative design to make finance management delightful!” 💫

---