Skip to content

KashifKT/Aven-Flix

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎬 Aven-Flix

πŸ“± About the App

Aven-Flix is a modern Flutter-based movie application that uses TheMovieDB (TMDB) API to fetch and display trending, popular, and top-rated movies. The app is built using GetX for state management, MVC architecture for clean code separation, and Dio for efficient API handling.

It provides a smooth and responsive UI experience with real-time movie data and optimized performance.


πŸ“₯ Download App

✨ Features

  • πŸŽ₯ Trending Movies (Web API integration)
  • πŸ” Movie search functionality
  • πŸ“„ Movie details screen (overview, rating, release date)
  • ⚑ Fast and smooth UI performance
  • πŸ”„ Real-time data fetching from API
  • 🎨 Clean and responsive UI design
  • πŸ“± Smooth navigation between screens

πŸ—οΈ Architecture (MVC + GetX)

This project follows MVC architecture with GetX:

lib/
β”‚
β”œβ”€β”€ models/         # Data models (Movie, Details, etc.)
β”œβ”€β”€ views/          # UI screens (Home, Details, Search)
β”œβ”€β”€ controllers/    # GetX controllers (business logic)
β”œβ”€β”€ services/       # API services (Dio client)
β”œβ”€β”€ widgets/        # Reusable UI components
└── main.dart       # Entry point

⚑ State Management

  • GetX is used for:
    • State management
    • Route management
    • Dependency injection
  • Reactive variables for instant UI updates
  • Clean separation of UI and logic

🌐 API Integration (Dio)

  • Dio used for HTTP requests
  • Fetch trending movies from web API
  • JSON parsing into models
  • Error handling for network failures
  • Optimized API calls for performance

πŸ› οΈ Tech Stack

  • Flutter (Dart)
  • TheMovieDB (TMDB) API
  • GetX (State Management)
  • MVC Architecture
  • Dio (HTTP Client)
  • REST API (Trending Movies API)

πŸš€ Getting Started

1. Clone Repository

git clone https://github.com/KashifKT/Aven-Flix.git

2. Navigate Project

cd Aven-Flix

3. Install Dependencies

flutter pub get

4. Run App

flutter run

πŸ“± App Flow

  1. App fetches trending movies from API
  2. GetX controller handles API response
  3. Movies are displayed in UI list/grid
  4. User taps a movie β†’ navigates to details screen
  5. Movie details are shown dynamically

πŸ“Έ Screenshots

img_1776958295991 img_1776958434710 img_1776958503833 img_1776963654413 img_1776958646825

πŸš€ Future Improvements

  • 🎬 Movie trailers integration
  • ❀️ Favorites / Watchlist feature
  • πŸ” Advanced search filters
  • πŸŒ™ Dark mode support
  • πŸ“₯ Offline caching of movies
  • πŸ”” Push notifications for new releases

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit changes
  4. Push branch
  5. Open Pull Request

πŸ“„ License

MIT License


πŸ‘¨β€πŸ’» Developer

KashifKT

About

A Flutter movie app using getx mvc dio TheMovieDB API to fetch trending movies from a web api with clean architecture and smooth ui and ux

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors