💼 Salary Calculator PRO — Local Salary Breakdown Dashboard

Salary Calculator PRO is a self-hosted income and tax calculator built with FastAPI + Jinja2 + Chart.js.
It calculates your gross, tax, and net salary across multiple pay periods — hourly, daily, weekly, monthly, quarterly, and yearly.
Fully offline. Private. Beautifully designed.

---

✅ Key Features

• 🧮 Multi-period salary breakdown — converts between hour, day, week, month, quarter, and year
• 💰 Tax deduction logic — input your tax percentage and get instant net values
• 🕒 Custom working days — supports any working schedule (default 21 days ≈ 5/2)
• 🌗 Modern UI — glass-style dashboard with dark/light theme toggle
• 📘 Built-in documentation — /documentation route with examples and field explanations
• ⚙️ Backend-powered — all calculations handled by FastAPI for accuracy
• 🧾 Dynamic table output — shows Gross, Tax, and Net across all periods
• 🖥 Cross-platform start scripts — ready for Windows, macOS, and Linux
• 💾 Offline-first — runs locally with no cloud dependency

---

📂 Project Structure

C:.
│   .env
│   LICENSE.txt
│   requirements.txt
│   run.py
│   start_linux.sh
│   start_macos.sh
│   start_windows.bat
│
├── app
│       calculators.py
│       main.py
│       models.py
│       tax_rates.json
│       __init__.py
│
├── screens
│       1server start.png
│       2light front.png
│       3dark front.png
│       4calculated salary.png
│       5another calc.png
│       6docs page.png
│       7docs page.png
│
├── static
│       app.js
│       style.css
│
└── templates
        docs.html
        index.html

---

🌐 Main Routes

URL	Description
/	Main salary calculator dashboard
/calculate	Backend API endpoint for calculations
/documentation	Built-in documentation and usage examples

---

⚙️ Requirements

Install dependencies:

pip install -r requirements.txt

Core dependencies:

• fastapi
• uvicorn
• jinja2
• httpx

---

🚀 Run Locally

▶️ Windows

start_windows.bat

💻 macOS

chmod +x start_macos.sh
./start_macos.sh

🐧 Linux

chmod +x start_linux.sh
./start_linux.sh

The app will automatically create a virtual environment,
install requirements, and open your browser at:
👉 http://127.0.0.1:8000

---

🧠 How It Works

Field	Description
Work Hours (per day)	How many hours you work each day
Working Days per Month	Number of working days per month (default 21 = 5/2 schedule)
Income Period	The pay period you are entering (Hour, Day, Week, Month, etc.)
Income Amount	Gross income for the selected period
Tax Rate (%)	Your tax percentage (deduction from gross pay)

---

🧾 Example Calculations

Example	Input	Output
Hourly employee	8h/day, $25/h, tax 15%	≈ $3,570 net/month
Monthly salary	$5,000/month, tax 20%	$4,000 net/month, $48,000/year
Shift schedule (3/3)	15 working days/month, $120/day, tax 20%	≈ $17,280 net/year

---

🖥 UI Overview

Screenshot	Description
1server start.png	Server start console
2light front.png	Main calculator in light mode
3dark front.png	Calculator in dark mode
4calculated salary.png	Example of calculation results
5another calc.png	Another salary comparison
6docs page.png	Documentation page
7docs page.png	Field guide and examples

---

🪄 Start Scripts

File	OS	Description
start_windows.bat	Windows	Creates venv, installs deps, starts server, opens browser
start_macos.sh	macOS	Same as above (zsh)
start_linux.sh	Linux	Same as above (bash)

---

📘 Documentation

Access in-app documentation at:
👉 http://127.0.0.1:8000/documentation

This page explains all fields, formulas, and real-world examples for hourly, monthly, and shift-based work.

---

📬 Support

Email: talabov.ali72@gmail.com
Telegram: @talabovali

---

💡 Salary Calculator PRO — privacy-first, accurate, and effortlessly modern.