arafaysaleem/ez_tickets_app

EZ Tickets Cinema App - Made With Flutter

A ticket booking app made for Nueplex cinemas.

codecov Build Release APK Test PR and Push Pull Request Labeler Generate Updated Goldens GitHub release GitHub stars GitHub issues GitHub issues GitHub PRs GitHub commit activity GitHub forks License: MIT made-with-python

EZ Tickets is an app made with Flutter framework to provide online ticket booking functionality. The release apk is available under the release tags. It's also available on this drive link - EZ Tickets APK

Demo

Backend

For the backend it uses a REST API made using NodeJS and MySQL. Here is the link to it's code ez_tickets_backend

Important

Due to privacy and resource abuse concerns I have kept the url of the backend API private and you won't be able to see it. Therefore, if you want to work with this project and make your own edits, than you also need to deploy the backend on your own and pass the URL to the flutter app. Don't be confused, you CAN use my backend code provided above, you just have to deploy it on a server of your own. There are plenty of free options including:

• Heroku
• AWS Free Tier
• Azure etc.

For more instruction visit the backend README.

Once deployed, pass the url while running the flutter app like this:

// Replace your-url-here with your own deployed URL like "https://example.com/api/v1"
flutter run --dart-define=BASE_URL="your-url-here"

:sparkles: App Features

• Authentication.
• Browsing movies.
• Viewing movie details.
• Watching movie trailers.
• Checking available movie shows.
• Theater seat map for ticket selection.
• Online ticket booking.
• Online booking payment.
• Viewing ticket bookings history.

:wrench: Technical Features

Riverpod State Management - v1.0.3	Dio + Interceptors For JWT Refresh
Freezed + Flutter Hooks For JSON Handling	Custom Wrapper For Shared Prefs + Flutter Secure Storage
MVC-S Clean Architecture	Session persistence and encrypted key storage
Reusable services architecture and code	Custom reusable widgets
Unit tested code + Automated Code Coverage	Dart ENV variables
Full documentation	Complex CI/CD Build, Test and Deploy pipelines
Github Branch Protection + Secrets	Linting + Custom Analyzer Rules

:iphone: Screens

:art: The UI is inspired by this dribbble shot

Splash Screen	Home Screen	Welcome Screen
https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/splash_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/home_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/welcome_screen.jpg
Movie Details Screen	Movies Screen	Movie Trailer Screen
https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/movie_details_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/movies_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/trailer_screen.jpg
Shows Screen	Theater Screen	Tickets Screen
https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/shows_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/theater_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/tickets_screen.jpg
Payment Screen	Confirmation Screen	Some Skeleton Loaders
https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/payment_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/booking_done_Screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/bookings_history_skeleton.jpg
Some Skeleton Loaders	Bookings History Screen	Booking Details Screen
https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/bookings_history_skeleton.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/bookings_history_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/booking_details_screen.jpg
Login Screen	Register Screen	Change Password Screen
https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/login_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/register_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/change_password_screen.jpg
Forgot Password Screen	OTP Screen	OTP Email
https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/forgot_password_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/otp_screen.jpg	https://raw.githubusercontent.com/arafaysaleem/ez_tickets_app/HEAD/readme_files/otp_email.jpg

⭐ Future Features

• Facial Authentication.
• Cancelling Bookings.
• Movie Reviews.
• FAQ page.

Feel free to fork and contribute to include these features. ❤︎

🚀 Technologies

• Flutter v2.8.1
• Dart v2.14.4

🤝 Contribute

To contribute, fork the repository and push the changes to the master branch. Then submit a pull request for merging with the source. If your code passes the review and checks it will be merged into the master branch.

💬 Feedback

Feel free to send us feedback on Twitter or file an issue. Feature requests are always welcome.

📝 License

Licensed under the MIT License.