https://github.com/siddiqui145/movie_app
A Flutter-based movie exploration app that allows users to search and browse detailed information about movies fetched from an external API. The app features a modern and interactive user interface with intuitive navigation and responsive design. Search movies by title. View in-depth information, Movies displayed in an organized grid.
https://github.com/siddiqui145/movie_app
dart flutter grid-layout navigator rest-api search
Last synced: 4 months ago
JSON representation
A Flutter-based movie exploration app that allows users to search and browse detailed information about movies fetched from an external API. The app features a modern and interactive user interface with intuitive navigation and responsive design. Search movies by title. View in-depth information, Movies displayed in an organized grid.
- Host: GitHub
- URL: https://github.com/siddiqui145/movie_app
- Owner: Siddiqui145
- License: apache-2.0
- Created: 2024-11-11T15:16:18.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-12-15T19:11:29.000Z (6 months ago)
- Last Synced: 2025-01-03T11:17:32.178Z (6 months ago)
- Topics: dart, flutter, grid-layout, navigator, rest-api, search
- Language: C++
- Homepage:
- Size: 523 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎬 Movie App
A Flutter app that allows users to search, view, and explore details about movies. The app fetches movie data from an API and provides users with an interactive interface for browsing movies.
## 📱 Features
- **Movie Search**: Search for movies by title.
- **Movie Details**: View detailed information about a selected movie.
- **Grid View Layout**: Movies displayed in a grid format.
- **Bottom Navigation**: Easily navigate between the home screen and search functionality.
## 🖼️ Demo
https://github.com/user-attachments/assets/2bc73a9e-0d53-48fb-8096-75e751425789
---
## 🚀 Getting Started
### Prerequisites
Ensure you have the following installed:
- [Flutter SDK](https://flutter.dev/docs/get-started/install)
- [Dart SDK](https://dart.dev/get-dart)
- Android Studio or Visual Studio Code (with Flutter plugins installed)
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/Siddiqui145/movie_app.git
cd movie_app
```
2. **Install dependencies**
```bash
flutter pub get
```
3. **Run the app**
Connect an Android/iOS device or start an emulator, then use the following command:
```bash
flutter run
```
---
## 📂 Project Structure
```plaintext
lib/
├── models/
│ └── movie.dart # Movie model for storing movie data
├── screens/
│ ├── home_screen.dart # Home screen with movie grid
│ ├── search_screen.dart # Search screen for querying movies
│ └── details_screen.dart # Details screen displaying movie information
├── services/
│ └── api_service.dart # API service for fetching movie data
└── main.dart # App entry point
```
---
## 🔧 Configuration
### API Service
The app uses an `ApiService` class in `services/api_service.dart` to fetch movies from a movie API. Update the API endpoint and API key if required.
---
## 📋 Usage
1. **Home Screen**: Displays a grid of movies fetched from the API. Tap on a movie card to view its details.
2. **Search Functionality**: Tap the search icon to go to the Search screen, where you can search for movies by title.
3. **Details Screen**: Shows detailed information about a selected movie, including a summary and image.
---
## 🛠️ Bottom Navigation
The app includes a bottom navigation bar to switch between the home screen and the search screen.
---
## 🖼️ Assets
- **Default Images**: Default images for movies without posters are located in the `assets/` folder.
- Ensure your `pubspec.yaml` includes:
```yaml
assets:
- assets/failed.jpeg
```
---
## 💡 Customization
- **Design**: Customize colors, typography, and UI components as desired in the `theme` section or by editing widget styles.
- **Add New Features**: Add more screens, features, or API integrations to enhance functionality.
---
## 📜 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
---
## 🤝 Contributing
Contributions are welcome! Please submit a pull request or open an issue for improvements or new features.
---
## 📞 Contact
For any questions or issues, please contact [[email protected]](mailto:[email protected]).
---
Happy coding! 🚀