ThinkLedger/taxcalculator

A modern, responsive web application for calculating PAYE income tax and SSNIT deductions in Ghana. Calculate your monthly net income, income tax, and SSNIT contributions instantly with accurate tax rates effective from January 2024. # Ghana Tax Calculator 🇬🇭 A modern, responsive web application for calculating PAYE income tax and SSNIT deductions in Ghana. Calculate your monthly net income, income tax, and SSNIT contributions instantly with accurate tax rates effective from January 2024. ## Features - ✨ **Real-time Calculations** - Instant tax calculations as you type - 📊 **Tax Breakdown** - Detailed breakdown of tax brackets and rates - ⚙️ **Configurable Options** - Toggle SSNIT deductions, select year, and country - 🌓 **Dark Mode Support** - Beautiful light and dark themes - 📱 **Responsive Design** - Works seamlessly on desktop and mobile devices - 🎨 **Modern UI** - Built with shadcn/ui and Tailwind CSS - ⚡ **Fast Performance** - Built with Next.js 16 and React 19 ## Tech Stack - **Framework**: Next.js 16 (App Router) - **Language**: TypeScript - **Styling**: Tailwind CSS v4 - **UI Components**: shadcn/ui - **Form Validation**: Zod - **State Management**: React Hooks - **Precision Math**: decimal.js - **Theme Management**: next-themes ## Getting Started ### Prerequisites - Node.js 18+ or Bun - npm, yarn, pnpm, or bun ### Installation 1. Clone the repository: ```bash git clone cd taxcalculatorgh ``` 2. Install dependencies: ```bash bun install # or npm install # or yarn install # or pnpm install ``` 3. Configure Finance Oracle proxy access: ```bash cp .env.example .env.local ``` Set these values in `.env.local`: - `NEXT_PUBLIC_FINANCE_ORACLE_PROXY_URL` Use a deployed proxy URL (for example a Cloudflare Worker). Do not expose Oracle API keys in frontend env vars. 4. Run the development server: ```bash bun dev # or npm run dev # or yarn dev # or pnpm dev ``` 5. Open localhost in your browser. ## Usage 1. Enter your **Monthly Basic Income** in Ghana Cedis (GH₵) 2. Optionally enter **Monthly Allowances** (if applicable) 3. Optionally enter **Tax Relief** amount 4. View your calculated: - Net Income (take home) - Income Tax - SSNIT Deductions 5. Click "Show tax breakdo …