Logo Lanfrica

dan-kingo/EEUCMS-MOBILE-APP

Domain:

digital infrastructure

Record type:

software
Creator:
dan
Host:
React Native based mobile app for Ethiopian Electric Utility Complaint Management Project. # EEUCMS Mobile App This is the official mobile application for the **Ethiopian ELectric Utility Complaint Management System (EEUCMS)**. The app allows users to easily make complaints, view complaint history, and manage their profiles. It uses an AI-based backend to classify, route, and escalate complaints for faster resolution. ## πŸš€ Tech Stack - **Framework**: Expo (React Native) - **UI Library**: React Native Paper - **State Management**: Zustand - **API**: Axios for backend communication - **Toast Messages**: `react-native-flash-message` ## πŸ“ Folder Structure ``` app/ β”œβ”€β”€ tabs/ # Tab navigation pages β”‚ β”œβ”€β”€ home.tsx β”‚ β”œβ”€β”€ make-complaint.tsx β”‚ └── profile.tsx β”œβ”€β”€ login.tsx # Login screen β”œβ”€β”€ register.tsx # Register screen assets/ β”œβ”€β”€ constants/ β”‚ └── profileData.ts # Profile form field definitions hooks/ β”œβ”€β”€ useUpdate.ts # Profile update logic β”œβ”€β”€ useUser.ts # Fetch and store current user store/ β”œβ”€β”€ userStore.ts # Zustand user state utils/ β”œβ”€β”€ profileUpdateSchema.ts # Profile validation schema ```` ## πŸ”§ Features - πŸ” Secure login & registration with OTP - πŸ“‹ Submit complaints with optional file upload - πŸ’¬ Integrated AI chatbot (planned) - πŸ”Ž View and filter complaint history - πŸ‘€ Edit profile information - ☁️ Cloudinary file storage (planned for uploads) - πŸ“± Fully responsive mobile UI with dark mode ## πŸ› οΈ Installation ```bash # 1. Clone the repo git clone github.com cd aicms-mobile # 2. Install dependencies npm install # 3. Start development server npx expo start ```` > ⚠️ Requires Expo CLI and Node.js installed. ## πŸ”‘ Environment Variables Create a `.env` file with: ``` API_BASE_URL=your_api_url ``` > Make sure you use `withCredentials: true` in all axios requests. ## 🧠 Important Design Decisions * All design tokens (fonts, colors) follow EEUCMS branding: * Primary: `#ff784b` * Secondary: `#c6635a` * Background: `#121212` * Font: ` …