Kośa (कोश) — Your Personal Treasury

A modern, feature-rich expense tracking PWA with beautiful visualizations and smart insights.

---

✨ Features

💰 Transaction Management

• Add Income & Expenses — Track all your financial transactions with detailed descriptions
• Recurring Transactions — Set up daily, weekly, or monthly recurring transactions
• Rich Categories — 12 predefined categories with icons (Food, Transport, Shopping, Bills, Entertainment, Health, Education, Travel, Salary, Investment, Gift, Other)
• Notes Support — Add detailed notes to any transaction
• Edit & Delete — Full CRUD operations with undo support
• Search & Filter — Find transactions by keyword, category, type, or month

📊 Analytics & Insights

• Dashboard Overview — Real-time balance, income, and expense summaries
• Spending by Category — Doughnut chart visualization
• Monthly Trend — Track your spending patterns over time
• Financial Health Score — AI-calculated score (0-100) with personalized tips
• Smart Insights — Month-over-month comparisons, daily averages, top spending categories

💵 Budget Management

• Category Budgets — Set monthly spending limits for each category
• Progress Tracking — Visual progress bars showing budget utilization
• Budget Alerts — Get notified when approaching budget limits

🎯 Savings Goals

• Create Goals — Set targets like "Emergency Fund" or "Vacation"
• Track Progress — Visual progress indicators
• Contributions — Add money to goals with quick actions
• Target Dates — Optional deadlines for your savings goals

✈️ Trip Mode (NEW!)

• Create Trips — Plan trips with destination, dates, currency, and budget
• Track Trip Expenses — Link transactions to specific trips
• Trip Analytics — See spending breakdown per trip
• Multi-currency Support — Set trip-specific currencies
• Budget Tracking — Visual progress bar for trip budgets
• Status Badges — Active, Upcoming, or Completed trips

🎤 Voice Input (NEW!)

• Hands-free Entry — Click the mic button in the transaction modal
• Natural Language — Say "Spent 50 dollars on food yesterday"
• Smart Parsing — Automatically detects amount, category, date, and type
• Visual Feedback — Animated listening overlay
• Browser Support — Works in Chrome, Edge, and Safari

🌍 Multi-Currency Support

Supports 27+ currencies including:

• USD, EUR, GBP, INR, JPY, CNY
• AUD, CAD, CHF, SGD, AED, THB
• And many more with real-time conversion

🎨 Customization

• Dark/Light Theme — Toggle between themes
• Accent Colors — Choose from 6 accent color schemes (Indigo, Emerald, Rose, Amber, Cyan, Violet)
• Currency Selection — Display amounts in your preferred currency

📱 Mobile Optimized

• Responsive Design — Works beautifully on all screen sizes
• Mobile Navigation — Bottom navigation bar for easy access
• Pull to Refresh — Refresh data with a simple gesture
• Swipe to Delete — Remove transactions with a swipe
• Modal Gestures — Swipe down to dismiss modals
• Haptic Feedback — Tactile feedback on supported devices
• PWA Support — Install as a native app on your device

⌨️ Keyboard Shortcuts

• N — New transaction
• Escape — Close modal

📤 Data Export

• Export to CSV — Download all transactions for external analysis

---

🚀 Getting Started

Option 1: Open Directly

Simply open index.html in any modern browser.

Option 2: Local Server

For the best experience with PWA features:

# Using Python
python -m http.server 8000

# Using Node.js
npx serve .

# Using PHP
php -S localhost:8000

Then visit http://localhost:8000

Option 3: Install as PWA

1. Open the app in Chrome/Edge/Safari
2. Click "Install" or "Add to Home Screen"
3. Enjoy as a native app!

---

📁 Project Structure

expense-tracker/
├── index.html              # Main HTML file
├── manifest.json           # PWA manifest
├── icons/                  # App icons (192x192, 512x512)
├── styles/
│   ├── main.css           # CSS variables & base styles
│   ├── layout.css         # Layout & grid styles
│   ├── components.css     # UI component styles
│   └── mobile.css         # Mobile-specific styles
└── js/
    ├── app.js             # Main application logic
    ├── categories.js      # Category definitions
    ├── settings.js        # User settings management
    ├── store.js           # localStorage data store
    ├── transactions.js    # Transaction CRUD operations
    ├── budgets.js         # Budget management
    ├── goals.js           # Savings goals logic
    ├── charts.js          # Chart.js visualizations
    ├── currency.js        # Multi-currency converter
    ├── health-score.js    # Financial health calculator
    └── export.js          # CSV export functionality

---

🛠️ Technologies

Technology	Purpose
HTML5	Semantic structure
CSS3	Modern styling with CSS variables
Vanilla JavaScript	No framework dependencies
Chart.js	Beautiful data visualizations
Lucide Icons	Crisp, modern icons
LocalStorage	Persistent data storage
PWA	Installable web app

---

🌟 Screenshots

Dashboard

The main dashboard showing your financial overview with balance, income, expenses, health score, and charts.

Transactions

Full transaction list with search, filters, and swipe-to-delete functionality.

Budgets

Set and track monthly budgets for each spending category.

Analytics

Deep dive into your spending patterns with detailed visualizations.

---

🔒 Privacy

Your data stays with you. All data is stored locally in your browser using LocalStorage. No data is sent to any server. You can export your data anytime and clear it from settings.

---

📝 License

This project is open source and available under the MIT License.

---

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

---