🇧🇩 Bangladesh Tax Calculator

A modern, user-friendly web application for calculating income tax in Bangladesh

---

✨ Overview

Bangladesh Tax Calculator is a comprehensive Vue 3 application designed to help salaried individuals in Bangladesh calculate their income tax obligations accurately. Now featuring dual tax comparison between FY 2024-2025 and FY 2025-2026, this tool provides detailed breakdowns, investment tracking, and supports different taxpayer categories with side-by-side comparison of tax structures.

🎯 Accurate Follows official NBR guidelines

⚡ Fast Instant calculations

📱 Responsive Works on all devices

🔒 Private All data stays local

🎯 Key Features

💼 Tax Management ✅ Dual tax comparison FY 2024-25 vs 2025-26 ✅ Side-by-side calculation display ✅ Multiple taxpayer profiles (General, Female, Senior, Disabled, Freedom Fighter) ✅ Detailed salary component breakdown ✅ Investment tracking & progressive rebate rates ✅ TDS calculation support

🛠️ User Experience ✅ Clean, intuitive interface ✅ Real-time calculations ✅ Data persistence across sessions ✅ Export/Import functionality ✅ Mobile-optimized design

🆕 What's New in v1.2.0

Feature	Description
⚖️ Dual Tax Comparison	Side-by-side comparison of FY 2024-25 vs FY 2025-26 tax calculations
📊 Tax Structure Changes	Reflects new thresholds, unified minimum tax, and progressive rebate rates
💰 Savings Calculator	Shows tax savings or additional tax with new structure
📱 Responsive Comparison	Mobile-optimized side-by-side or stacked layout
🧪 Comprehensive Testing	Full test coverage for dual calculations and edge cases

Previous Updates (v1.1.0)

Feature	Description
🚀 Vue 3 Migration	Enhanced performance and modern development experience
👥 Taxpayer Profiles	Support for different taxpayer categories with specific exemptions
🎨 Enhanced UI	Improved navigation with quick action buttons
🧪 Better Testing	Comprehensive unit and E2E test coverage
⚡ Performance	Faster load times and improved reactivity

🚀 Quick Start

Prerequisites

• Node.js 16.0 or higher
• npm 8.0+ or Yarn 1.22+

Installation

# Clone the repository
git clone https://github.com/nadimtuhin/tax-calculator.git
cd tax-calculator

# Install dependencies
yarn install

# Start development server
yarn dev

Visit http://localhost:8080 to see the application running.

📦 Available Scripts

Command	Description
yarn dev	Start development server
yarn build	Build for production
yarn test	Run unit tests
yarn test:e2e	Run E2E tests
yarn test:all	Run all tests
yarn lint	Lint and fix files

🏗️ Technical Stack

Vue 3

Vuex 4

Vue Router 4

Jest

Playwright

📁 Project Structure

src/
├── 📂 components/          # Reusable Vue components
│   ├── 📄 Calculation-2024.vue    # FY 2024-25 calculations
│   ├── 📄 Calculation-2025.vue    # FY 2025-26 calculations
│   ├── 📄 TaxComparison.vue       # Dual comparison display
│   ├── 📄 Investment.vue
│   ├── 📄 TaxpayerProfile.vue
│   └── ...
├── 📂 pages/              # Page components
├── 📂 store/              # Vuex store modules
├── 📂 router/             # Vue Router configuration
├── 📂 utils/              # Utility functions
│   ├── 📄 taxSlabs.js             # FY 2024-25 tax logic
│   └── 📄 taxSlabs2025.js         # FY 2025-26 tax logic
├── 📄 calculateTaxBreakdown.js    # FY 2024-25 calculations
└── 📄 calculateTaxBreakdown2025.js # FY 2025-26 calculations

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Quick Contribution Steps

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📈 Roadmap

• Dual tax comparison (FY 2024-25 vs 2025-26)
• Historical tax year comparisons
• Export comparison reports (PDF/Excel)
• Business income tax calculation
• Tax planning recommendations
• Multi-language support (Bengali)
• Chart visualizations for tax breakdown

📚 Documentation

• Dual Tax Comparison Guide - Comprehensive guide to the new comparison feature
• API Documentation - Technical implementation details
• Contributing Guidelines - How to contribute to the project

👨‍💻 Author

Nadim Tuhin

📧 Email • 🐙 GitHub

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• National Board of Revenue (NBR) Bangladesh for tax guidelines
• Vue.js community for excellent documentation
• All contributors who have helped improve this project

---

⭐ If this project helps you, please give it a star!

Report Bug • Request Feature