Skip to content

dhirajraut1/aarthik-sarathi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Aarthik Sarathi - Nepali Tax Calculator & Advisor

A user-friendly, client-side web application designed to help Nepalese individuals simplify their income tax calculations for the Fiscal Year 2082/83. Beyond just calculating tax, this tool acts as a proactive financial advisor, providing personalized suggestions to maximize savings and visualize financial data.

➡️ View Live Demo


✨ Features

This tool is packed with features to provide a comprehensive financial overview:

  • Accurate Tax Calculation: Implements the latest tax slabs for FY 2082/83 for both individuals and couples.
  • Comprehensive Income & Deductions: Includes fields for:
    • Monthly Salary & Annual Bonus
    • EPF, SSF, and CIT contributions
    • Life & Health Insurance premiums
  • Detailed Tax Breakdown: See exactly how much tax is applied at each slab (1%, 10%, 20%, 30%, 36%, 39%).
  • Take-Home Pay Summary: Instantly view your estimated net salary, both annually and monthly, after all contributions and taxes.
  • Personalized Savings Advisor: Automatically generates actionable advice on how to reduce your tax liability by utilizing available deductions you haven't maxed out yet.
  • Visual Contribution Analysis: A dynamic bar chart compares your current contributions and tax savings against your maximum potential, making it easy to see where you can improve.
  • Modern & Responsive UI: Clean, intuitive, and fully functional on both desktop and mobile devices.

📸 Screenshot

image image image

🛠️ Tech Stack

This project is built with a focus on simplicity and performance, using only client-side technologies:

  • HTML5: For the core structure and content.
  • CSS3: For modern styling, using Flexbox and Grid for a responsive layout.
  • Vanilla JavaScript (ES6+): For all the calculation logic, DOM manipulation, and interactivity. No frameworks needed!
  • Chart.js: For rendering the beautiful and interactive bar chart.

🚀 Getting Started

To run this project locally, follow these simple steps.

Prerequisites

You only need a web browser and a code editor. No complex installations are required.

Installation

  1. Clone the repository:
    git clone https://github.com/dhirajraut1/aarthik-sarathi.git
  2. Navigate to the project directory:
    cd aarthik-sarathi
  3. Open index.html in your browser: Simply double-click the index.html file, or right-click and choose "Open with" your favorite browser.

And that's it! The web app is now running locally on your machine.


📖 How to Use

  1. Enter Your Income: Fill in your Monthly Income and any Annual Bonus.
  2. Select Your Status: Use the toggles to select your Marital Status and Primary Retirement Fund (EPF or SSF).
  3. Input Contributions: Add your yearly contributions for EPF/SSF, CIT, and insurance premiums.
  4. Click Calculate: Hit the "Calculate Tax & Get Advice" button.
  5. Review Your Results: The page will instantly update to show:
    • A full summary of your tax liability.
    • A detailed slab-wise breakdown.
    • Your take-home pay.
    • The visual savings chart.
    • Personalized advice on how you can save more.

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

  1. Fork the Project
  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

📄 License

Distributed under the MIT License. See LICENSE for more information.


⚖️ Disclaimer

This is an estimation tool designed for informational purposes only. The calculations are based on the tax regulations for the Nepalese Fiscal Year 2082/83. It should not be used as a substitute for professional financial or legal advice. Please consult with a qualified accountant for precise financial planning.

About

The all-in-one app for Nepalese to calculate taxes, track expenses, and invest smarter.

Topics

Resources

Stars

Watchers

Forks