alexgrate/TaxClarity

Tax clarity and compliance assistant for Nigeria's 2026 tax reforms. # TaxClarity NG 🇳🇬 A mobile app that helps Nigerians understand and comply with the 2026 tax reforms. --- ## 📱 About TaxClarity NG is a personalized tax clarity assistant that: - Explains applicable tax rules in **plain language** - Provides **step-by-step compliance guidance** - Helps users avoid penalties and stay tax compliant ### Target Users - 💼 Salary Earners - 💻 Freelancers & Gig Workers - 🏪 Small Business Owners --- ## 🛠️ Tech Stack | Layer | Technology | |-------|------------| | **Mobile App** | React Native + Expo SDK 54 | | **Navigation** | Expo Router (file-based) | | **State** | Zustand + AsyncStorage | | **Forms** | React Hook Form | | **Backend** | Django + Django REST Framework | | **Database** | PostgreSQL (prod) / SQLite (dev) | --- ## 📂 Project Structure ``` TaxClarity/ ├── frontend/ # React Native Expo app (frontend branch) │ ├── app/ # Screens (expo-router) │ │ ├── index.tsx # Landing screen │ │ ├── profile-setup.tsx │ │ └── next-steps.tsx │ ├── components/ui/ # Reusable UI components │ ├── services/ # API client (Axios) │ ├── store/ # Zustand state management │ ├── constants/ # Theme colors │ └── docs/ # Documentation │ └── backend/ # Django API (main branch) └── taxclarity/ ├── App/ # Main application └── taxclarity/ # Project settings ``` --- ## 🚀 Getting Started ### Prerequisites - Node.js 18+ - Python 3.10+ - Expo Go app on your phone ### Frontend Setup ```bash # Clone the repository git clone github.com cd TaxClarity # Switch to frontend branch git checkout frontend # Install dependencies npm install # Start Expo development server npx expo start ``` Scan the QR code with Expo Go (Android) or Camera app (iOS). ### Backend Setup ```bash # Switch to main branch (from repo root) git checkout main cd backend/taxclarity # Create virtual environment python -m …