Skip to main content

System Overview

bsr-pos-plus is a monorepo for multiple POS surfaces that share domain logic and utilities.

Monorepo layout​

  • apps/mobile: current React Native mobile POS application
  • apps/pos-terminal: terminal-oriented React Native app for large-screen and secondary-display scenarios
  • packages/api: shared API client and endpoint helpers
  • packages/domain: shared business rules and orchestration logic
  • packages/types: shared TypeScript models
  • packages/utils: shared utility functions

Design intent​

  • Keep apps/mobile working first because it is the active production-facing POS surface.
  • Let apps/pos-terminal evolve toward large-screen Android terminal use cases without forcing premature abstraction.
  • Move logic to packages/* only when both apps agree on the data contract and usage pattern.

Main runtime surfaces​

  • Operator-facing mobile UI
  • Operator-facing terminal UI
  • Customer-facing terminal display on supported Android hardware
  • Shared services such as API access, Firebase, and device integrations