sphampila-debug/homebound-ai

AI-powered immigration assistant for Africa # 🌍 Homebound AI **An AI-powered immigration assistant for Africa** ## 🎯 Overview Homebound AI is a comprehensive mobile application designed to simplify the immigration process for African citizens. It leverages AI technology to provide personalized guidance, document checklists, embassy information, and real-time chat support to help navigate complex visa and immigration requirements. ## ✨ Key Features - 🤖 **AI Chat Assistant** - Get instant answers to immigration questions - 📋 **Document Checklist** - Organized checklists for required documents by country/visa type - 🏢 **Embassy Directory** - Find and contact embassies in your region - 👤 **User Profiles** - Save preferences and track application progress - 🔐 **Secure Authentication** - Safe login and data protection - 📱 **Mobile-First** - Accessible on any smartphone ## 🚀 Getting Started ### Prerequisites - Flutter SDK 3.0+ - Dart 3.0+ - Android Studio or Xcode (for emulator/device testing) ### Installation ```bash # Clone the repository git clone github.com cd homebound-ai # Install dependencies flutter pub get # Run the app flutter run ``` ### Environment Setup Create a `.env` file in the project root: ```env API_BASE_URL=api.homebound-ai.com AI_API_KEY=your_api_key_here DATABASE_URL=your_database_url ``` ## 📁 Project Structure ``` homebound-ai/ ├── mobile/ │ ├── lib/ │ │ ├── main.dart # App entry point │ │ ├── app.dart # App configuration │ │ ├── navigation.dart # Navigation setup │ │ ├── screens/ # UI screens │ │ │ ├── splash_screen.dart │ │ │ ├── login_screen.dart │ │ │ ├── home_screen.dart │ │ │ ├── profile_screen.dart │ │ │ ├── ai_chat_screen.dart │ │ │ ├── embassy_directory_screen.dart │ │ │ └── document_checklist_screen.dart │ │ ├── widgets/ # Reusable UI components │ │ │ └── app_drawer.dart …