KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #claude-code #codex #cli #agent-skills #ai #dsh-plugin #mcp #windows #agent

piiicks-ecommerce

★ 95 Open GitHub ↗

Flutter ecommerce built with clean architecture and bloc state management.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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
<a href="https://github.com/mo7amedaliEbaid/piiicks-ecommerce/releases/download/v3.0.0/piiicks-v3.apk"><img src="https://playerzon.com/asset/download.png" width="150"></img></a>

## 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

#### ⚠️ API Usage Warning
##### The APIs included in this project might not work as intended, as they haven't been tested for a while. If you wish to work with this repository:

- Replace the API URLs and endpoints with your own.
- Use this project to study the architecture, understand the use cases, and gain insights into implementing API integrations, handling data flow, managing state, and designing scalable and maintainable codebases.
- If you encounter any issues or have updates, contributions are welcome!
- Let me know if you'd like further refinements or additional sections for clarity!

## 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.

piiicks-ecommerce

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README