yichaosun / tv-randshow

App to choose a random TV show episode - Made with #Flutter

TV Randshow - App to choose a random TV show episode

About the project

TV Randshow was created to help choose a random episode from your favorites TV shows. The TV shows database comes from the TMDB and the app saves them in a database on the device. With the list of favorites, you can roll the dice of a TV shows to get a random episode.

This project has been built using the Flutter framework, which allows to build an app for mobile, desktop & web, from a single codebase.

Features

• Save your favorites TV shows
• Choose a random episode from a single TV show
• Support to Android and Web
• Dark mode
• Support to deeplink (https://tvrandshow.com/getRandomEpisode?friends)
• Coming soon...

Tools

• TMDB API
• Flare animation loading
• Provider
• SQFlite
• Dio
• Logger
• Flutter markdown
• Flutter translate - Translate to english, portuguese and spanish
• Persist theme (light and dark)
• Deeplink
• In app review

Build application

Requirements

• First, clone the repository with the 'git clone' command, or just download the zip.

git clone [e-mail]:deandreamatias/tv-randshow.git

• Then, download either Android Studio or Visual Studio Code, with their respective Flutter editor plugins. For more information about Flutter installation procedure, check the official install guide.

• Install dependencies from pubspec.yaml by running flutter packages get from the project root (see using packages documentation for details and how to do this in the editor).

• Get your API Key from TMDB (see this FAQ for more details) and paste in file lib/config/env.dart

• (Optional) If you want build to web, do you need follow this steps

Run

CLI Debug: flutter run --flavor dev -t lib/main_dev.dart

Tests

Integration tests: flutter drive --target=test_driver/app.dart --flavor dev

Built with

• Flutter - Beautiful native apps in record time.
• Android Studio - Tools for building apps for Android devices.
• Visual Studio Code - Code editing. Redefined.

Author

• Matias de Andrea - Mobile developer and UI/UX designer: Website, GitHub & Twitter.

Contributing

If you want to take the time to make this project better, please read the contributing guides first. Then, you can open an new issue, of a pull request.

License

This project is licensed under the GNU GPL v3 License - see the LICENSE file for details.