# KMPMovies

**Repository Path**: pythonzz/KMPMovies

## Basic Information

- **Project Name**: KMPMovies
- **Description**: 一个 Compose 多平台应用程序，专注于架构和特定于平台的视图/功能
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-08-30
- **Last Updated**: 2024-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MoviesApp

MoviesApp is a Kotlin-based Android application that allows users to search for movies, view details, and watch trailers. The app uses  Compose Multiplatform for the UI and Koin for dependency injection and supports IOS, Android and JVM.

## Features

- **Search Movies**: Search for movies, TV shows, and people.
- **View Details**: View detailed information about movies.
- **Watch Trailers**: Watch trailers of movies.
- **Popular Movies**: Browse popular movies.
- **Top Rated Movies**: Browse top-rated movies.
- **Upcoming Movies**: Browse upcoming movies.
- **Now Playing Movies**: Browse movies that are currently playing.
- **Search**: Search Movies

## Technologies Used

- **Kotlin**: Programming language used for development.
- **Multiplatform Compose**: Modern toolkit for building native Android UI.
- **Koin**: Dependency injection framework.
- **Voyager**: Navigation library for Jetpack Compose.
- **Gradle**: Build automation tool.
- **Ktor**: HTTP client for networking.
- **Coroutines**: Asynchronous programming.
- **Serialization**: JSON serialization library.
- **Coil**: Image Loading and Caching
- **JavaFX**: JVM WebView

## Project Structure

- `src/commonMain/kotlin/com/kashif/common/presentation/`: Common presentation logic.
- `src/commonMain/kotlin/com/kashif/common/data/`: Common data logic.
- `src/commonMain/kotlin/com/kashif/common/domain/`: Common domain logic.
- `src/commonMain/kotlin/com/kashif/common/di/`: Common dependency injection logic.
- `src/androidMain/kotlin/com/kashif/android/`: Android-specific logic.
- `src/ioMain/kotlin/com/kashif/ios/`: iOS-specific logic.
- `src/jvmMain/kotlin/com/kashif/jvm/`: JVM-specific logic.
- `iosApp`: iOS-specific configuration and entry point.
- `androidApp`: Android-specific configuration and entry point.
- `jvmMain`: JVM-specific configuration and entry point.

### Screen Shots

<div style="display: flex; gap: 10px;">
    <img src="art/deatilstop.png" alt="details screen" style="width: 180px; height: auto;"/>
    <img src="art/detailsbottom.png" alt="details bottom" style="width: 180px; height: auto;"/>
    <img src="art/home.png" alt="home" style="width: 180px; height: auto;"/>
    <img src="art/search.png" alt="search" style="width: 180px; height: auto;"/>
    <img src="art/trailer.png" alt="trailer" style="width: 180px; height: auto;"/>
    <img src="art/verticallist.png" alt="vertical list" style="width: 180px; height: auto;"/>
</div>


## Getting Started

### Prerequisites

- Android Studio Koala | 2024.1.1 Patch 2
- Kotlin 2.0.0+
- Gradle 8.0+

### Installation

1. **Clone the repository**:
    ```sh
    git clone https://github.com/yourusername/MoviesApp.git
    cd MoviesApp
    ```

2. **Run in Android Studio**:
    - Open the project in Android Studio.
    - Build and run the project.

## Usage

- **Search for Movies**: Use the search bar to find movies, TV shows, or people.
- **View Movie Details**: Click on a movie to view its details.
- **Watch Trailers**: Click on the play button to watch a movie trailer on ios, android and JVM.
- **Browse Movies**: Scroll through the lists of popular, top-rated, upcoming, and now-playing movies.

## Contributing

1. **Fork the repository**.
2. **Create a new branch**:
    ```sh
    git checkout -b feature/your-feature-name
    ```
3. **Make your changes**.
4. **Commit your changes**:
    ```sh
    git commit -m 'Add some feature'
    ```
5. **Push to the branch**:
    ```sh
    git push origin feature/your-feature-name
    ```
6. **Open a pull request**.

## License

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

## Acknowledgements

- [Jetpack Compose](https://developer.android.com/jetpack/compose)
- [Koin](https://insert-koin.io/)
- [Voyager](https://github.com/adrielcafe/voyager)
- [Compose Multiplatform](https://github.com/JetBrains/compose-multiplatform)

## Contact

If you have any questions, please contact [kashismails@gmail.com].