Skip to content

hikmetbozkurt/Imperium

Repository files navigation

Imperium 🏛️

Imperium Logo


📚 Introduction

Imperium is a modern, interactive history quiz app designed to make learning about world history fun and engaging. Explore ancient civilizations, the medieval era, the Renaissance, modern history, and the world wars through beautifully crafted quizzes, progress tracking, and a gamified experience.

"The more you know about the past, the better prepared you are for the future."
— Theodore Roosevelt


✨ Features

  • 🏆 Multiple Historical Eras: Ancient, Medieval, Renaissance, Modern, and World Wars
  • 🎨 Material Design 3 UI: Smooth, modern, and responsive interface
  • 📊 Interactive Progress Charts: Pinch-to-zoom, swipe gestures, and animated statistics (powered by MPAndroidChart)
  • 🧠 Challenging Quizzes: Hundreds of questions across categories and levels
  • 🗂️ Level & Category Progression: Unlock new levels and track your mastery
  • 🥇 Achievements & Badges: Earn badges as you progress
  • 👤 Profile & Stats: View your achievements, stars, and quiz history
  • 🔊 Sound & Music: Immersive background music and sound effects
  • 🌙 Dark/Light Theme Ready: Consistent experience in any lighting
  • 🚀 Offline Support: Play quizzes anytime, anywhere

🖼️ Screenshots

Home Levels Ancient Quiz Medieval Quiz
Home 1 Levels Ancient Quiz Medieval Quiz
Home 2
Renaissance Modern History World Wars Progress
Renaissance Modern History World Wars Progress
Profile About
Profile About

Captions:

  • Home: Main dashboard with navigation and categories
  • Levels: Level selection for a category
  • Ancient/Medieval/Renaissance/Modern/World Wars: Quiz screens for each era
  • Progress: Interactive progress and statistics
  • Profile: User profile and achievements
  • About: App information and credits

🛠️ Tech Stack

  • Kotlin & Jetpack Compose (UI)
  • Room (local database)
  • Hilt (dependency injection)
  • Retrofit (network/API)
  • MPAndroidChart (interactive charts)
  • WorkManager (background tasks)
  • Material Design 3

🏗️ Architecture

  • MVVM (Model-View-ViewModel) pattern
  • Repository pattern for data management
  • Composable UI: Reusable, modular components
  • Room Database: For quiz data, user progress, and achievements
  • Navigation: Bottom navigation bar for Home, Progress, and Profile
  • Background Services: For badge/achievement updates

🚦 Getting Started

Prerequisites

  • Android Studio Hedgehog or newer
  • Android SDK 33+

Build & Run

  1. Clone the repository:
    git clone https://github.com/yourusername/imperium.git
    cd imperium
  2. Open in Android Studio
  3. Build the project (Gradle will auto-download dependencies)
  4. Run on emulator or device

📦 Dependencies


🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

👤 Author

Hikmet Bozkurt Aydoğan
LinkedIn
Email


🙏 Credits & License


Made by Hikmet Bozkurt Aydoğan

About

Imperium : History Quiz Application

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages