💰 ردیاب هزینه

یک ابزار ساده و زیبا برای ثبت و مدیریت هزینه‌های روزانه

---

🇬🇧 English • 🇮🇷 فارسی

---

🇬🇧 English

Overview

Expense Tracker is a simple, beautiful, and fully offline personal expense tracking application. No server, no database, no registration — everything runs in your browser and is stored locally.

Live Demo: Open in Browser

✨ Features

• 📅 Persian (Jalali) Calendar — Full Shamsi date picker with Persian month names
• 📊 Monthly Summary — View total expenses, count and daily average per month
• 🔍 Live Search — Instantly filter expenses by description or category
• 📂 Categories — 7 categories (Food, Transport, Housing, Entertainment, Health, Shopping, Other) with icons and colors
• 📥 Export to Excel (CSV) — Download your data as a CSV file, openable in Excel
• 💾 Export to JSON — Full backup with one click
• 📱 Mobile-First Design — Responsive and beautiful on mobile, tablet and desktop
• 🌙 Fully Offline — No internet required, all data stays in your browser
• 🆓 Free & Open Source — MIT License

🚀 Quick Start

Just open index.html in any browser. No installation needed.

git clone https://github.com/HoseinBorsi/expense-tracker.git
cd expense-tracker
open index.html    # or double-click the file

🛠 Tech Stack

Technology	Purpose
HTML5	Structure
CSS3 (Vanilla)	Styling (mobile-first, responsive)
JavaScript (Vanilla)	Logic (no frameworks, no dependencies)
localStorage	Data persistence
Jalali (Persian) Calendar	Custom library (lib/jalali.js)

📁 Project Structure

expense-tracker/
├── index.html        # Main page
├── style.css         # Styles
├── script.js         # Application logic
├── lib/
│   └── jalali.js     # Persian calendar converter
├── .gitignore
├── LICENSE
└── README.md

---

🇮🇷 فارسی

نمای کلی

ردیاب هزینه یک ابزار شخصی، ساده و زیبا برای ثبت و مدیریت هزینه‌های روزانه است. بدون سرور، بدون دیتابیس و بدون ثبت‌نام — همه چیز در مرورگر شما اجرا می‌شود و اطلاعات به صورت محلی ذخیره می‌گردد.

✨ قابلیت‌ها

• 📅 تقویم شمسی — انتخابگر تاریخ کاملاً فارسی با نام ماه‌ها
• 📊 خلاصه ماهانه — مشاهده جمع کل، تعداد و میانگین روزانه
• 🔍 جستجوی زنده — فیلتر لحظه‌ای هزینه‌ها
• 📂 دسته‌بندی — ۷ دسته (خوراکی، حمل و نقل، مسکن، تفریح، سلامت، خرید، سایر) با آیکون و رنگ
• 📥 خروجی اکسل — دانلود فایل CSV قابل باز شدن در اکسل
• 💾 پشتیبان JSON — ذخیره کامل اطلاعات با یک کلیک
• 📱 طراحی واکنش‌گرا — زیبا در موبایل، تبلت و دسکتاپ
• 🌙 کاملاً آفلاین — بدون نیاز به اینترنت
• 🆓 رایگان و متن‌باز — تحت مجوز MIT

🚀 شروع سریع

کافیست فایل index.html را در مرورگر خود باز کنید. هیچ نصب اضافه‌ای نیاز نیست.

git clone https://github.com/HoseinBorsi/expense-tracker.git
cd expense-tracker
# فقط کافیست index.html را در مرورگر باز کنید

📁 ساختار پروژه

expense-tracker/
├── index.html        # صفحه اصلی
├── style.css         # استایل‌ها
├── script.js         # منطق برنامه
├── lib/
│   └── jalali.js     # تبدیل تاریخ شمسی
├── .gitignore
├── LICENSE
└── README.md

🤝 مشارکت

هرگونه مشارکت، گزارش باگ یا پیشنهاد استقبال می‌شود!

---

ساخته شده با ❤️ توسط Hossein Borsi