Celestia Weather App

A modern Android weather application built with Clean Architecture principles and modular design, providing real-time weather information.

This is a production app, you can try it out from Google Playstore

📱 Screenshots

🏗️ Architecture & Modularization

The app follows Clean Architecture principles with a modular structure:

app/
├── core/
│   ├── network/            # Network operations and API interfaces
│   ├── data/               # Data layer, repositories
│   ├── model/              # Domain models
│   ├── domain/             # Use cases, business logic
│   ├── ui/                 # Common UI components
│   ├── designsystem/       # Design system, themes
│   ├── common/             # Shared utilities
│   ├── testing/            # Test utilities
│   └── androidtest/        # Android test utilities
│
└── feature/
    ├── home/               # Home screen with current weather
    ├── detail/             # Detailed weather information
    └── location/           # Location selection

Module Dependencies

• app: Main application module, depends on all feature modules
• core: Contains all core functionality and shared resources
• feature: Contains all feature modules, each independent of others

🛠️ Tech Stack

Core

• Kotlin: Primary programming language
• Coroutines & Flow: Asynchronous programming
• Hilt: Dependency injection
• Jetpack Compose: Modern UI toolkit
• Material 3: Design system
• Clean Architecture: Architectural pattern
• MVVM: Presentation layer pattern

Features

• Google Maps: Location services
• Location Services: Real-time weather data
• Retrofit: Network requests
• OkHttp: HTTP client

Testing

• JUnit 5: Unit testing
• Mockk: Mocking framework
• Turbine: Flow testing
• Compose Testing: UI testing

🌟 Features

• Real-time weather information
• Location-based weather data
• 5-day weather forecast
• Detailed weather metrics (humidity, wind speed, visibility)
• Location search with Google Maps integration
• Material 3 theming
• Dark/Light mode support
• Error handling and retry mechanisms
• Location permissions handling

🚀 Getting Started

1. Clone the repository git clone https://github.com/yourusername/celestia-weather.git

2. Add your OpenWeather API key in local.properties: WEATHER_API_KEY=your_weather_api_key

3. Add your Google Maps API key in local.defaults.properties (under the ./gradle): MAPS_API_KEY=your_google_maps_api_key

4. Build and run the project in Android Studio

📦 Dependencies Management

The project uses a custom Gradle plugin for dependency management with version catalogs: kotlin // Example from build.gradle.kts

plugins {
    alias(libs.plugins.celestia.android.library)
    alias(libs.plugins.celestia.android.library.compose)
    alias(libs.plugins.celestia.android.hilt)
    alias(libs.plugins.celestia.android.feature)
}
dependencies {
    // ...
    implementation(libs.androidx.ktx)
    implementation(libs.androidx.lifecycle.runtime.ktx)
    implementation(libs.bundles.compose)
    // ...
}

🧪 Testing Strategy

• Unit Tests: Testing individual components (ViewModels, UseCases, Repositories)
• UI Tests: Testing UI components with Compose Testing

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

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

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👤 Author

Sevban Buyer - @sevbanBayir