film_freund

An application to discover new films and organize what to watch next.

Getting Started

To build the app locally, the following tools are required:

• Flutter stable >= 2.8
• Dart >= 2.15
• macOS:
  • Xcode >= 13.0
  • CocoaPods >= 1.11.0
• Web:
  • Chrome

A Firebase project needs to be created and integrated. Note that to speed up development build times, a pre-compiled version of Firestore on iOS and macOS is used.

An API key is needed to query TMDB. Once a key is obtained, create the file lib/services/movies/movie_database.secrets.dart with the content:

part of 'movie_database.dart';

const apiKey = 'apiKey';

where apiKey is the TMDB v3 api key.

Code Generation

Localizations

To add new localizations, update assets_dev/loca/loca.csv and run

sh bin/loca_generate.sh

Tests

A local code coverage report can be generated using

sh bin/test_local_coverage_report.sh

and viewed by opening coverage/index.html.

Golden tests are used to verify that widgets appear as they should. alchemist is used to ensure goldens can be generated platform agnostic and not be successible to discrepancies on CI pipeline.

Credits

This application is developed for personal use, and is inspired by Letterbox, iMDb and Filmweb. This product uses the TMDB API but is not endorsed or certified by TMDB.

Raising Issues and Contributing

Please report bugs and issues, and raise feature requests here.

To contribute, submit a PR with a detailed description and tests, if applicable.