Shovies

Shovies is a Flutter-based mobile application that allows users to explore movies and TV series, view detailed information, and manage a personal watch library.

The app is designed with a clean UI and a simple user experience, focusing on performance and modular architecture.

---

Features

• Browse popular movies and TV shows
• Search for movies and series
• View detailed information (overview, rating, poster, cast)
• Add items to personal library
• Local persistence using SharedPreferences
• Fallback to mock data when API is unavailable
• Clean and responsive UI

---

Tech Stack

• Flutter (UI framework)
• Dart
• TMDB API
• SharedPreferences (local storage)

---

Project Structure

lib/
 ├── core/          # constants, theme, shared utilities
 ├── features/      # feature-based modules (movies, search, library)
 ├── models/        # data models
 ├── services/      # API services
 ├── data/          # mock data & repositories
 └── main.dart      # entry point

---

Getting Started

1. Clone the repository

git clone https://github.com/altanyuce/shovies.git
cd shovies

---

2. Install dependencies

flutter pub get

---

3. Run the application

You need a TMDB API key to run the app.

flutter run --dart-define=TMDB_API_KEY=YOUR_TMDB_API_KEY

Alternatively, if using a bearer token:

flutter run --dart-define=TMDB_BEARER=YOUR_TMDB_BEARER_TOKEN

---

API

This project uses The Movie Database (TMDB) API.

No API keys are stored in the repository. All keys must be provided at runtime.

---

Notes

• The app works with mock data if API access is not available.
• This project is intended for learning and portfolio purposes.
• Not production-ready.

---

Future Improvements

• User authentication
• Cloud sync (multi-device support)
• Favorites & watchlist enhancements
• Pagination and performance optimization
• Better error handling

---

License

This project is open-source and available under the MIT License.