CamlineKe/easytax-kenya

# EasyTax Kenya - Frontend Application Documentation ## Project Overview EasyTax Kenya is a comprehensive SaaS application designed to simplify tax compliance for Small and Medium Enterprises (SMEs) in Kenya. The frontend application provides an intuitive, professional interface for users to manage their tax obligations, file returns, and make payments seamlessly. ## 🎯 Key Features ### Core Functionality - **Automated Tax Filing**: One-click NIL return submission and guided regular return filing - **Real-time Compliance Tracking**: Dashboard showing compliance status and upcoming deadlines - **M-Pesa Integration**: Seamless tax payments through mobile money - **eTIMS Validation**: Real-time invoice validation for VAT compliance - **Multi-step Forms**: User-friendly signup and tax filing processes - **Subscription Management**: Flexible pricing plans with upgrade options ### User Experience - **Responsive Design**: Optimized for desktop, tablet, and mobile devices - **Professional UI**: Clean, modern interface using Kenya's national colors - **Intuitive Navigation**: Clear user flows and logical page organization - **Accessibility**: WCAG-compliant design with proper contrast and keyboard navigation ## 🏗️ Technical Architecture ### Technology Stack - **Frontend Framework**: React 18 with Vite - **Styling**: Tailwind CSS with custom design system - **UI Components**: Shadcn/UI component library - **Icons**: Lucide React icons - **Routing**: React Router v6 - **State Management**: React hooks and context - **Build Tool**: Vite for fast development and optimized builds ### Project Structure ``` easytax-kenya/ ├── src/ │ ├── components/ │ │ └── ui/ # Reusable UI components │ ├── pages/ │ │ ├── home/ # Landing page │ │ ├── auth/ # Login and signup pages │ │ ├── dashboard/ # Main dashboard │ │ ├── tax-filing/ # Tax filing interface │ │ └── payment/ …