패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소Dinesh-Sowndar/flutter_billing_app

flutter_billing_app

Dinesh-Sowndar/flutter_billing_app open-source repository details.

flutter_billing_app 프로젝트 이미지
스타
1.6천
포크
764
최근 푸시(UTC)
2026. 3. 11.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

🛒 Mobile POS & Billing App

A feature-rich, high-performance offline-first billing and Point of Sale (POS) application built with Flutter. Designed for seamless retail checkout operations featuring barcode scanning, thermal Bluetooth printing, and robust local data persistence.

Screenshot

https://github.com/user-attachments/assets/f2d16454-5408-43b3-b207-cd843bbc2c9e

🎯 Project Scope

This application serves as a complete offline POS system for small to medium-sized retail shops. It streamlines the checkout process, catalog management, and receipt generation securely entirely on-device.

Core Features:
  • Product Management System: Complete CRUD operations for inventory items with barcode/QR code support.
  • Smart Checkout System: Rapid cart building via camera-based barcode scanning or manual entry, and robust order calculation functionality.
  • Bluetooth Thermal Printing: Direct integration with thermal printers (print_bluetooth_thermal) to instantly output physical receipts.
  • Shop Settings & Customization: Centrally managed shop details printed dynamically on receipts.
  • Offline-First Architecture: Powered by Hive for lightning-fast localized NoSQL data storage. No active internet connectivity required.

🛠 Tech Stack & Architecture

Built leveraging industry-standard architectural principles (Clean Architecture & Feature-Driven Design) ensuring scalability, separation of concerns, and robust testability.

  • Framework: Flutter (SDK >=3.1.0)
  • State Management: flutter_bloc
  • Dependency Injection: get_it
  • Routing: go_router
  • Local Database: hive & hive_flutter
  • Data Modeling: json_serializable, equatable
  • Functional Programming: fpdart
  • Hardware Integrations: mobile_scanner (barcodes), print_bluetooth_thermal

📁 File Structure

The codebase is organized using a Feature-First Clean Architecture utilizing domain-driven concepts.

lib/
├── core/                       # Core application utilities and shared components
│   ├── data/                   # Global data sources (e.g., Hive initialization)
│   ├── error/                  # Standardized Failure/Exception models (fpdart compatible)
│   ├── theme/                  # UI aesthetics, typography, styling
│   ├── usecase/                # Base UseCase contracts
│   ├── utils/                  # Helpers (e.g., PrinterHelper, formatters)
│   ├── widgets/                # Reusable global UI widgets (AppBars, generic buttons)
│   └── service_locator.dart    # get_it dependency injection setup
│
└── features/                   # Independent feature modules
    ├── billing/                # Core POS operations: Cart, Checkout, Invoice Generation
    ├── product/                # Inventory management: Adding, Listing, Scanning products
    ├── settings/               # App configuration: Printer connections, App settings
    └── shop/                   # Shop details configuration

Note: Each feature is further subdivided internally into Clean Architecture layers: data, domain, and presentation.

💡 Use Cases

  • Rapid Billing Entry: A cashier launches the app, navigates to the checkout page, and uses the device camera to instantly scan product barcodes. The products are added to the cart, the total is calculated including taxes, and a receipt is finalized.
  • Physical Receipt Generation: After checkout confirmation, the app triggers a connected external Bluetooth thermal POS printer to instantly print an itemized paper receipt with the shop’s header.
  • Inventory Sideloading: A manager opens the Product feature to add new stock to the local database, taking a picture of the barcode to bind the SKU for future lightning-fast checkouts.
  • No-Connection Operation: The business operates a stall at an exhibition with poor networking. The app functions entirely via its embedded Hive local database and Bluetooth, completely undisturbed by network drops.

🚀 Getting Started

Prerequisites
  • Flutter SDK ^3.1.0 or higher
  • Android Studio / Xcode for emulators and building.
  • Optional: A physical Android/iOS device and a Bluetooth Thermal Printer for testing hardware integrations natively.
Installation
  1. Clone the repository and navigate to the project directory:

    git clone <repository_url>
    cd billing_app
    
  2. Fetch dependencies:

    flutter pub get
    
  3. Run code generation (required for Hive adapters and JSON serialization):

    dart run build_runner build --delete-conflicting-outputs
    
  4. Run the project:

    flutter run
    

🤝 Contributing Guidelines

As a senior-focused project, please adhere to:

  1. Clean Architecture Rules: Maintain strict boundaries between domain, data, and presentation layers.
  2. Immutable States: Emit only immutable states from BLoCs utilizing equatable.
  3. No Direct Exceptions in Domain: Utilize fpdart's Either<Failure, Type> pattern to handle control flow for exceptions.
Dinesh Sowndar GitHub avatar
GitHub 작성자

Dinesh Sowndar ↗

Flutter | React developer

언어DartRubyHTMLSwiftKotlinObjective-C

사용 중인 의존성

의존성 목록 25 개

순위

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗