Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mo7amedaliebaid/piiicks-ecommerce

Flutter ecommerce built with clean architecture and bloc state management.
https://github.com/mo7amedaliebaid/piiicks-ecommerce

authentication bloc bloc-pattern cache cart clean-architecture cubit dart dartz ecommerce equatable flutter flutter-ecommerce flutter-state-management flutter-ui http notifications pagination search

Last synced: about 3 hours ago
JSON representation

Flutter ecommerce built with clean architecture and bloc state management.

Awesome Lists containing this project

README 

        
[![Android CI](https://github.com/mo7amedaliEbaid/piiicks-ecommerce/actions/workflows/android.yml/badge.svg)](https://github.com/mo7amedaliEbaid/piiicks-ecommerce/actions/workflows/android.yml)



# Piiicks

Piiicks is a Flutter e-commerce app, meticulously crafted with clean architecture and powered by the efficient BLoC state management ensuring scalability, maintainability, and optimal performance. Dive into a seamless coding experience with a sleek interface and robust features designed to elevate the online shopping journey.



## Directory Structure.

- **lib**

  - **main.dart:** Entry point of the application.

  - **📂application ──📂blocs/cubits:** Houses the BLoC (Business Logic Component) or Cubit classes responsible for managing the application's state.

  - **📂core:** Contains core functionalities and utilities shared across the application.

  - **📂configs:** Holds configuration files for the project.

  - **📂di:** Dependency Injection setup for managing dependencies and services.

  - **📂data:** Manages data sources, repositories, and data models.

  - **📂domain:** Defines the domain entities, use cases, and interfaces.

  - **📂presentation ──📂screens/widgets:** Contains UI components, screens, and widgets for the application.



## Features

1. **Clean Architecture:** Ensure a modular and scalable architecture for long-term maintainability.

2. **BLoC State Management:** Efficient state management for a smooth and predictable user experience.



### User Interface

3. **Product Screen:** User-friendly display of products for effortless browsing.

4. **Categories:** Seamless navigation through various product categories.

5. **Product Details:** In-depth information for a comprehensive view of products.

6. **Search Functionality:** Robust search feature for quick product discovery.

7. **Search Results:** Clear and relevant search results for user convenience.

8. **Home Screen:** Engaging showcase of featured products and categories.

9. **Filter Options:** Intuitive product filtering options for a customized shopping experience.

10. **Splash Screen:** Captivating initial loading screen setting the tone for the app.

11. **Addresses:** Effortlessly manage and edit user addresses for smooth order processing.

12. **Pagination:** Implement pagination for efficient loading of large sets of data, ensuring a smoother user experience.



### User Interaction

13. **Sort Products:** Options to sort products based on criteria such as price.

14. **Notifications:** Keep users informed with updates on order status and more.



### User Management

15. **Login/SignUp:** Secure user authentication for a personalized experience.

16. **Shopping Cart:** Seamless and intuitive management of selected items before purchase.

17. **User Profile:** Dedicated section for managing addresses, viewing order history, and personalizing preferences.

18. **Orders Management:** Enable the user to make orders and show different order result screen based on the order status.



### Additional Features

19. **Image Caching and Loading Optimization:** Utilize the `cached_network_image` package for efficient loading and caching of network images, enhancing performance.

20. **SVG Support:** Leverage the `flutter_svg` package for supporting SVG images, providing a scalable and crisp user interface.

21. **Data Caching:** Use the `shared_preferences` package for caching small amounts of data, improving the user experience by maintaining certain states.

22. **Authentication and Secure Storage:** Implement secure user authentication with the `flutter_secure_storage` package, ensuring sensitive user data is stored securely.

23. **Stateful UI with Shimmer Effect:** Enhance the user interface by incorporating the shimmering effect using the `shimmer` package, providing a polished loading experience.

24. **Dynamic Page Indicators:** Implement dynamic page indicators using the `dots_indicator` package, providing visual cues for users when navigating through different screens.

25. **HTTP Requests and API Integration:** Leverage the `http` package for making HTTP requests and seamlessly integrate with external APIs for fetching and updating data.

27. **Network Connectivity Check:** Utilize the `internet_connection_checker` package to ensure a smooth user experience by checking and handling network connectivity.

28. **Dependency Injection:** Leverage the `get_it` package for efficient dependency injection, improving code maintainability and managing dependencies effectively.

29. **Functional Programming Principles:** Explore and implement functional programming principles from the `dartz` package, enhancing code clarity and error handling.

30. **Share Products:** Enable users to share product details using the `share_plus` package for seamless sharing on social media and other platforms.

31. **Contact Us Screen with URL Launcher:** Utilize the `url_launcher` package to open the contact us screen, allowing users to interact with external links such as emails or phone numbers.

32. **Wishlist with Get Storage:** Implement a wishlist feature using the `get_storage` package to save and retrieve products, providing users with a personalized wishlist experience.

33. **Product Sharing with Screenshot:** Allow users to share product details with a screenshot using the `screenshot` package, enhancing the sharing capabilities of your app.



## Dependencies

```yaml

environment:

  sdk: '>=3.0.5 <4.0.0'



dependencies:

  flutter:

    sdk: flutter

      # the last versions.

  equatable:

      # Package for handling value equality without explicit overrides

  dartz:

      # Functional programming library for Dart

  shared_preferences:

      # Plugin for reading and writing key-value pairs to persistent storage

  http:

      # Package for making HTTP requests

  internet_connection_checker:

      # Library for checking internet connectivity

  flutter_bloc:

      # State management library for Flutter applications

  get_it:

      # Simple service locator for Dart and Flutter projects

  shimmer:

      # Package for adding shimmering effect to Flutter applications

  cached_network_image:

      # Library for loading and caching network images

  flutter_svg:

      # Library for rendering SVG files in Flutter applications

  dots_indicator:

      # Customizable dots indicator for PageView in Flutter

  flutter_secure_storage:

      # Secure storage plugin for Flutter

  photo_view:

      # Package for displaying images in Flutter with zooming and panning capabilities

  dotted_border:

      # Package for creating dotted borders in Flutter

  flutter_local_notifications:

      # Package for displaying local notifications in Flutter applications

  share_plus:

      # Package for sharing content on social media and more

  get_storage: 

      # Persistent storage for Flutter, allowing key-value pair storage

  screenshot:

      # Flutter plugin for taking screenshots of widgets

  path_provider:

      # Plugin for interacting with the file system, including getting the app's temporary and application support directories

  url_launcher:

      # Flutter plugin for launching URLs, emails, making phone calls, and sending SMS.

  flutter_phoenix:

      # Easily restart your application from scratch, losing any previous state.

```



## Download App




## Screens.

### Done:

- Products.

- Categories.

- Product Details.

- Search.

- Search Result.

- Home.

- Filter.

- Login.

- SignUp.

- Splash.

- Cart.

- Profile.

- Adresses.

- Add/Edit Adress.

- Sort Products.

- Terms & Conditions.

- Wishlist.

- Contact Us.

- Checkout.

- Order Success.

- Order Failure.

- Orders.

- Notifications.



For more screen shots [Here](https://github.com/mo7amedaliEbaid/piiicks-ecom/blob/ec474e822af055693058d0beb05a5e52411d8504/screenshots)





   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   

   




### ToDo:



- Payment.



## Demos.



https://github.com/mo7amedaliEbaid/piiicks-ecommerce/assets/131966482/5dc6ddd6-07dc-4c32-9eb6-1f04159997ca



https://github.com/mo7amedaliEbaid/piiicks-ecommerce/assets/131966482/a2c926a7-f8d9-4fc4-8b4a-4061f0fba880



https://github.com/mo7amedaliEbaid/piiicks-ecommerce/assets/131966482/0f01f13b-ac96-4664-8494-5163bea2b82f



https://github.com/mo7amedaliEbaid/piiicks-ecommerce/assets/131966482/6dfb61d2-221a-4a9a-9589-c659217099f3



- Usually this Case will Occur if you open the app for the first time without internet connection. If its not the first time the app will use cached data.



https://github.com/mo7amedaliEbaid/piiicks-ecommerce/assets/131966482/4d83307e-2e4b-4427-bf6b-10e3f39ca835



## Getting Started

1. Clone the repository.

2. Navigate to the project directory.

3. Run `flutter pub get` to fetch the dependencies.

4. Open the project in your preferred Flutter IDE.

5. Run the app on your desired emulator or physical device.