OtoEbe/taxready-nigeria

Free tax compliance platform for Nigeria's 2026 tax reform. PAYE calculator, contractor tax optimizer, expense tracker, and compliance checklist — built for SMEs navigating the Nigeria Tax Act 2025. Streamlit-powered. Ship-ready. # 🇳🇬 TaxReady Nigeria **Tax Compliance Made Simple** — Navigate Nigeria's 2026 Tax Laws with Confidence A comprehensive tax management platform built for the Nigeria Tax Act 2025 (effective January 1, 2026). --- ## 🎯 Features ### Calculators - **PAYE Calculator** — Calculate employee tax with all 2026 deductions - **Contractor Calculator** — Tax optimization for self-employed professionals - **Comparison Tool** — See tax implications of salary vs contractor income ### Record Keeping - Track income and expenses - Organize WHT certificates - Export records for tax filing ### Compliance Tools - Interactive compliance checklist - Filing deadline reminders - Penalty reference guide ### Learning Hub - Complete guide to 2026 tax changes - Topic-specific explainers - FAQ and best practices --- ## 🚀 Quick Start ### Local Development ```bash # Clone the repository git clone github.com cd taxready-nigeria # Create virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt # Run the app streamlit run app.py ``` The app will open at `localhost` ### Deploy to Streamlit Cloud (Free) 1. Push this repo to GitHub 2. Go to share.streamlit.io 3. Click "New app" 4. Select your repo and `app.py` 5. Click "Deploy" Your app will be live at `your-app-name.streamlit.app` --- ## 📁 Project Structure ``` taxready/ ├── app.py # Main Streamlit application ├── requirements.txt # Python dependencies ├── .gitignore # Git ignore rules ├── .streamlit/ │ └── config.toml # Streamlit configuration ├── calculators/ │ ├── __init__.py │ ├── paye.py # Employee PAYE calculator │ └── contractor.py # Contractor tax calculator ├── utils/ │ ├── __init__.py │ └── constants.py # Tax rates, bands, penalties └── README.md ``` --- ## 📊 Tax Calc …