Skip to content

HordRicJr/Idile

Repository files navigation

# Idile - African Heritage & History App Discover the rich heritage and history of Africa through an immersive mobile experience. ## Architecture This project follows the **MVVM (Model-View-ViewModel)** architecture pattern with Clean Architecture principles to ensure maintainability, testability, and scalability. ### Project Structure ``` lib/ ├── core/ # Core functionality and utilities │ ├── constants/ # App constants, themes, strings │ ├── services/ # Core services (network, storage, etc.) │ └── utils/ # Utility classes and helpers ├── data/ # Data layer │ ├── datasources/ # Local and remote data sources │ ├── models/ # Data models with JSON serialization │ └── repositories/ # Repository implementations ├── domain/ # Domain layer (business logic) │ ├── entities/ # Business entities │ ├── repositories/ # Repository interfaces │ └── usecases/ # Business use cases └── presentation/ # Presentation layer ├── pages/ # UI screens/pages ├── viewmodels/ # ViewModels (Controllers in MVVM) └── widgets/ # Reusable UI components ``` ## Features ### Content Categories 1. **Historical Figures** - African leaders, scholars, artists, and warriors 2. **Museums** - African museums with virtual tours and collections 3. **Historical Sites** - Archaeological sites, monuments, and landmarks 4. **Tales & Stories** - Traditional African folktales and legends 5. **Art Objects** - Sculptures, paintings, textiles, and artifacts 6. **Quotes** - Wisdom and sayings from African leaders 7. **People & Cultures** - Histories of African ethnic groups and peoples 8. **African Deities** - Traditional gods and spiritual beings from various African religions 9. **African Kingdoms** - Historical empires and kingdoms across Africa 10. **African Festivals** - Traditional celebrations and cultural events 11. **African Music** - Traditional and contemporary music with cultural context ### Key Features - **Multilingual Support** - English, French, Arabic, Swahili, and more - **Local Content Management** - All content stored locally in JSON files - **User Content Creation** - Add your own stories, figures, and quotes - **360° Panoramic Views** - Immersive museum and site experiences - **Audio/Video Support** - Rich media content with integrated players - **Content Export/Import** - Share user-created content with others - **Offline Access** - Full functionality without internet connection - **Search & Filter** - Advanced content discovery across all categories - **Cultural Preservation** - Platform for preserving and sharing African heritage ## Getting Started - [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab) - [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook) For help getting started with Flutter development, view the [online documentation](https://docs.flutter.dev/), which offers tutorials, samples, guidance on mobile development, and a full API reference. # Idile

About

A mobile application dedicated to the discovery and promotion of African cultural heritage

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published