Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kinoarizu/slimx

Allows users to search for a movie or tv series, see the detail, season & episode, and save watchlist.
https://github.com/kinoarizu/slimx

clean-architecture flutter

Last synced: 1 day ago
JSON representation

Allows users to search for a movie or tv series, see the detail, season & episode, and save watchlist.

Awesome Lists containing this project

README

        

# Slimx

Slimx is a Flutter app project that allows users to search for a movie or tv series, see the detail, season & episode, and save watchlist. The movies and tv series data is gotten from https://www.themoviedb.org/

## Prerequisites

Before begin to install to your local machine and test it, make sure you have met the following requirements:
* You have installed the latest version of Flutter SDK. [Install Flutter](https://docs.flutter.dev/get-started/install)
* You have installed Android Studio and setup an emulator. [Download Android Studio](https://developer.android.com/studio)
* You have installed XCode 13 and setup a simulator (if you are using macOS)

## Run for the first time
After load the project to your local machine IDE, follow these steps:

Restore the package
```
flutter pub get
```

Run
```
flutter run
```

To use your own TMDB API Key, you can edit this line on the file inside lib/common/urls.dart:
```dart
class Urls {
static const String baseUrl = 'https://api.themoviedb.org/3';
static const String apiKey = 'api_key=YOUR_API_KEY';
...
}
```

## Core concepts this project used

* Clean Architecture ๐Ÿ—๏ธ
* Test-Driven Development (TDD) - Unit, Widget, and Integration tests ๐Ÿงช
* Advanced UI ๐Ÿ™๏ธ
* Modularity

If you are currently learning Flutter development and want to start contributing to open source, let's get started! To contribute to this project, follow these steps:

1. Fork this repository
2. Create a new branch: `git checkout -b `
3. Make your changes and commit them: `git commit -m ''`. Please follow this [Commit Style Guide](https://mauss.dev/posts/semantic-commit-message)
4. Push your changes to the original branch on your repository
5. Create the PR (Pull Request)

To contributing to this project, you can explore [TMDB API Docs](https://developers.themoviedb.org/3) and start add a new feature that intresting and useful for cinephile.

IMPORTANT: You must follow the clean architecture and TDD proccess to add a new feature.

Thanks ๐Ÿ˜Š