An open API service indexing awesome lists of open source software.

https://github.com/waffiqaziz/restaurantzz

Flutter Restaurant Recommendation App
https://github.com/waffiqaziz/restaurantzz

codecov dart flutter flutter-test material-design provider-state-management test-coverage

Last synced: about 2 months ago
JSON representation

Flutter Restaurant Recommendation App

Awesome Lists containing this project

README

          

# Restaurantzz

![Header](/docs/images/header.png)
[![Flutter Version](https://img.shields.io/badge/flutter-v3.38.6-blue?logo=flutter&logoColor=white)](https://github.com/flutter/flutter/blob/main/CHANGELOG.md#3386)
[![Flutter Testing](https://github.com/waffiqaziz/restaurantzz/actions/workflows/flutter-test.yml/badge.svg)](https://github.com/waffiqaziz/restaurantzz/actions/workflows/flutter-test.yml)
[![codecov](https://codecov.io/gh/waffiqaziz/restaurantzz/graph/badge.svg?token=W2M08GY7CJ)](https://codecov.io/gh/waffiqaziz/restaurantzz)

**Restaurantzz** is a Prototype Flutter-based restaurant recommendation app. The app allows users to discover and explore recommended restaurants with an elegant and responsive UI. It supports both dark and light themes based on system preferences, and utilizes modern features such as Material 3 UI and Hero animations.

## ๐Ÿ› ๏ธ Getting Started

For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.

### Development Step by Step

To develop the project, please read [here](./docs/DEVELOPMENT.md).

## ๐ŸŒŸ Features

- **Restaurant Recommendations:** View and search list of recommended restaurants.
- **Restaurant Details:** See detailed information about each restaurant.
- **Submit Review:** Write your own review.
- **Responsive UI:** Material 3 UI with adaptive design.
- **Dark and Light Themes:** The app automatically switches between dark and light themes based on the system settings.
- **Favorite List:** Save your favorite restaurant.
- **Schedule Notification**: Daily notification at 11 a.m. about random restaurant. (only for mobile)

## ๐Ÿ“ธ Screenshots

๐ŸŒž Light Mode


List Screen (Light Mode)
Search Screen (Light Mode)
Favorite Screen (Light Mode)
Settings Screen (Light Mode)



Detail Screen Top (Light Mode)
Detail Screen Bottom (Light Mode)
Schedule Push Notification (Light Mode)

###

๐ŸŒ™ Dark Mode


List Screen (Dark Mode)
Search Screen (Dark Mode)
Favorite Screen (Dark Mode)
Settings Screen (Dark Mode)



Detail Screen Top (Dark Mode)
Detail Screen Bottom (Dark Mode)
Schedule Push Notification (Dark Mode)

## ๐Ÿงช Testing

This project includes unit tests, widget tests, and instrumented test to ensure the correctness of the application. We use GitHub Actions to automatically run the tests on each pull request, and you can view the results [here](https://github.com/waffiqaziz/restaurantzz/actions/workflows/flutter-test.yml). To run testing on your local machine please read [here](/docs/TESTING.md).

## ๐Ÿค Contributing

Feel free to contribute to this project by adding new features, improving the code, or enhancing the overall design.
Whether it's fixing a bug, refining the UI, or suggesting improvements, all contributions are welcome!