💰 PaisaPlan

A lightning-fast daily expense tracker for mindful spending

🌐 Live Demo | 🚀 Quick Start | ✨ Features

---

🛠️ Build Stack

Category	Technology
Core Build
Frontend Design
Logo & Branding

🎯 What is PaisaPlan?

PaisaPlan is a lightweight, mobile-first expense tracker that helps you stay on budget. Set your daily spending limit, log expenses in seconds, and watch your remaining balance in real-time.

Perfect for: Students, budget-conscious individuals, and anyone who wants to track daily spending without complexity.

---

✨ Features

🏠 Smart Flow Home → Login → Dashboard architecture Protected routes for authenticated users Seamless authentication with Supabase	💳 Budget Management Set personalized daily budgets Quick expense logging Real-time balance tracking
📊 Visual Progress Spend progress visualization Remaining balance display Intuitive UI feedback	⚙️ Flexible Settings Edit budget on the fly Secure sign out Persistent user preferences

---

🛠️ Tech Stack

Category	Technology
Frontend
Animations
Icons
Backend

---

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm installed
• A Supabase account (Get started free)

Installation

# 1️⃣ Clone the repository
git clone https://github.com/yourusername/paisaplan.git
cd paisaplan

# 2️⃣ Install dependencies
npm install

# 3️⃣ Configure environment variables
cp .env.example .env
# Edit .env with your Supabase credentials

# 4️⃣ Start development server
npm run dev

🔧 Environment Setup

Create a .env file in your project root:

VITE_SUPABASE_URL=your_supabase_project_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

💡 Tip: Find these values in your Supabase Dashboard under Project Settings → API

---

📱 Test Credentials

Want to try PaisaPlan without signing up? Use our demo account!

Click the "Testing credentials" button on the login screen

Field	Value
📧 Email	saksham.arora7@s.amity.edu
🔑 Password	test@123

---

🎨 Branding Assets

The PaisaPlan logo is located at:

public/PaisaPlan.svg

This file is used for:

• Authentication header branding
• Browser favicon
• App logo throughout the interface

To update: Replace public/PaisaPlan.svg with your custom logo (SVG format recommended).

---

🏗️ Building for Production

Development Build

npm run build

This creates an optimized build in the dist/ folder.

Local Preview

npm run preview

Test your production build locally before deploying.

---

🚀 Deployment

PaisaPlan is a static Vite app that can be deployed anywhere. Here are popular options:

📦 Vercel (Recommended)

This repo includes a vercel.json configuration file.

# Deploy with Vercel CLI
npm i -g vercel
vercel

Settings:

• Build Command: npm run build
• Output Directory: dist
• Environment Variables: Add VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY

🌐 Netlify

# Deploy with Netlify CLI
npm i -g netlify-cli
netlify deploy

Settings:

• Build Command: npm run build
• Publish Directory: dist
• Environment Variables: Add VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY

✅ Deployment Checklist

• Set environment variables on hosting platform
• Configure SPA fallback (serve index.html for all routes)
• Test authentication flow
• Verify Supabase connection
• Check mobile responsiveness

---

🤝 Powered By

PaisaPlan is proudly built with:

Antigravity 🚀

Revolutionary development framework powering our core architecture

Stitch 🎨

Beautiful design system bringing our interface to life

Nano Banana 🍌

Creative genius behind our stunning logo

---

📬 Support & Contact

Need help? Found a bug? Have a feature request?

📧 Email: saksham.arora7@s.amity.edu

---

📄 License

This project is licensed under the MIT License.

---

Made with ❤️ for mindful spenders

⭐ Star this repo if you find it helpful!

📖 Documentation • 🐛 Report Bug • 💡 Request Feature