Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💰 TaxScale

Automated Income Tax Calculation & Regime Comparison Platform

Simplifying income tax planning by automatically extracting Form 16 details and comparing tax liability under the Old and New Income Tax Regimes.

🌐 Live Demo: https://taxscale.vercel.app


📖 Overview

TaxScale is a Full Stack Web Application that helps salaried individuals make informed tax decisions by automating income tax calculations.

The application extracts salary information from Form 16 or accepts manual salary details, calculates tax liability under both the Old and New Income Tax Regimes, and recommends the more beneficial option.

The tax calculation engine is configuration-driven, allowing tax rules to be updated every financial year without modifying the application's business logic.


🚀 Features

  • 📄 Upload Form 16 PDF
  • ⚡ Automatic extraction of salary and deduction details
  • 💰 Calculates tax liability under both tax regimes
  • 📊 Side-by-side tax comparison
  • ✅ Recommends the better tax regime
  • 📑 Download detailed tax report
  • ⚙ Configuration-driven tax engine for easy annual updates
  • 📱 Responsive user interface
  • ☁ Cloud deployment using Vercel & Render

❗ Problem Statement

Understanding which income tax regime is more beneficial can be challenging due to:

  • Multiple tax slabs
  • Standard deductions
  • Section 87A rebate
  • Different deduction rules
  • Complex manual calculations

Most taxpayers rely on spreadsheets or online calculators, which often require repetitive manual data entry and may not provide a clear comparison.


💡 Solution

TaxScale simplifies the entire process.

Users upload their Form 16 or manually enter salary details.

The system automatically:

  • Extracts salary information
  • Calculates tax under both regimes
  • Compares tax liability
  • Recommends the better tax regime
  • Generates a downloadable tax report

🛠 Tech Stack

Frontend

  • React.js
  • Vite
  • JavaScript
  • HTML5
  • CSS3

Backend

  • Node.js
  • Express.js

Database

  • MongoDB

Deployment

  • Vercel
  • Render

Tools & Services

  • Git
  • GitHub
  • PDF Parsing
  • PostHog Analytics

🏗 System Architecture

                    User
                      │
                      ▼
         React Frontend (Vercel)
                      │
              REST API Requests
                      │
                      ▼
        Express Backend (Render)
              │               │
              ▼               ▼
      Form 16 Parser   Tax Calculation Engine
                              │
                              ▼
          Configuration-based Tax Rules
                              │
                              ▼
                Tax Comparison Result
                              │
                              ▼
               Download Summary Report

📂 Project Structure

taxscale/
│
├── frontend/          # React Application
├── backend/           # Express Backend APIs
├── java-engine/       # Tax Calculation Engine
├── config/            # Tax Configuration Files
├── assets/            # Screenshots & Sample Reports
└── README.md

✨ Key Highlights

  • Full Stack Web Application
  • Real-world Finance Automation Project
  • Automated Form 16 Processing
  • Configuration-driven Tax Engine
  • Easy Annual Tax Rule Updates
  • Modular Backend Architecture
  • Separate Frontend & Backend Deployment
  • Responsive User Interface
  • Scalable Client-Server Architecture

📸 Application Screenshots

🏠 Home Page


📄 Upload Form 16 & Tax Comparison


📊 Detailed Tax Comparison


📑 Generated Tax Report

📥 Sample Tax Report

Download Tax Report (PDF)


⚙ Installation

Clone the Repository

git clone https://github.com/Demonster9/taxscale.git

Navigate to the Project

cd taxscale

Install Dependencies

npm install

Run the Application

npm run dev

🎯 Future Enhancements

  • User Authentication
  • Tax History Dashboard
  • Multi-Year Tax Comparison
  • Investment Planning Dashboard
  • Support for Additional Income Sources
  • Excel Report Export
  • Admin Panel for Tax Rule Management
  • Improved PDF Parsing Accuracy

👨‍💻 Author

Dhananjay Tangade

B.Tech Information Technology

Government College of Engineering, Karad

GitHub: https://github.com/Demonster9


🤝 Contributing

Contributions, suggestions, and improvements are welcome.

If you'd like to improve this project:

  1. Fork the repository
  2. Create a new feature branch
  3. Commit your changes
  4. Open a Pull Request

⭐ Show Your Support

If you found this project useful, please consider giving it a ⭐ on GitHub.

It motivates me to continue building useful software projects.

About

An automated tax calculation platform that simplifies income tax planning by comparing Old and New Tax Regimes using Form 16 data.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages