A production-ready Flutter application for discovering movies, built with REST API integration and Riverpod state management.
Flickd is a beautifully crafted movie discovery app powered by TheMovieDB (TMDB) API. Browse popular and upcoming films, search your favorites, and enjoy a cinema-grade experience — all built with clean, scalable Flutter architecture.
Whether you're a movie buff or a Flutter developer looking for a real-world project reference
| Feature | Description |
|---|---|
| 🎥 Popular Movies | Browse trending and top-rated films in real time |
| 🗓️ Upcoming Releases | Stay ahead with movies coming to theaters |
| 🔍 Search | Find any movie instantly with a responsive search bar |
| 📄 Pagination | Seamless infinite scrolling through thousands of titles |
| 🔐 Authentication | Secure user login and session management |
| 🎨 Custom UI | Stunning splash screen, custom fonts, and dark theme |
| ⚡ Riverpod | Reactive, testable, and scalable state management |
- Framework: Flutter (cross-platform — iOS & Android)
- Language: Dart
- State Management: Flutter Riverpod
- Networking: HTTP / Dio — RESTful API calls
- API: TheMovieDB (TMDB) REST API
- Async Handling: FutureBuilder, StreamBuilder, async/await
- Architecture: Clean layered architecture with separation of concerns
- Flutter SDK
>=3.0.0 - Dart SDK
>=3.0.0 - APi key TMDB
- VS Code or Android Studio configured for Flutter
| Endpoint | Description |
|---|---|
GET /movie/popular |
Fetch currently popular movies |
GET /movie/upcoming |
Fetch upcoming movie releases |
GET /search/movie |
Search movies by query |
GET /movie/{id} |
Get detailed info for a movie |
POST /authentication/token/new |
Create auth request token |
- ✅ Flutter REST API integration with error handling
- ✅ Riverpod providers (StateNotifier, FutureProvider, StreamProvider)
- ✅ Pagination with scroll-based infinite loading
- ✅ Token-based authentication flow
- ✅ Form validation and user feedback
- ✅ Custom theming and Google Fonts integration
- ✅ Async data handling with FutureBuilder & StreamBuilder
- ✅ Responsive, production-ready UI patterns