Skip to content

ZenitHTH/vibe-pos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

627 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›’ Vibe POS (Simple POS) v0.2.1

A professional, modern, and lightweight Point of Sale (POS) system built with Tauri v2 and Next.js 16, designed for high performance, security, and simplicity.

Features

Point of Sale Interface

  • Fast and intuitive interface for processing sales with optimized touch support.
  • Virtual Numpad: Optimized touchscreen numeric keypad for quick cash entry.
  • Touch-Optimized Cart: Large touch targets for interactive cart elements.
  • Smart Change Calculation: Automated change display with validity checks.
  • Receipt Generation: Backend integration for secure transaction recording.

Inventory Management

  • Product Management: Detailed product tracking with categories and images.
  • Material & Recipe Management: Track raw materials and define recipes for complex items (e.g., drinks, food).
  • Real-time Stock Tracking: Monitor inventory levels with low-stock alerts.

Customer Management

  • Customer Information: Track customer profiles and preferences.
  • Purchase History: Comprehensive view of past transactions with filters and search.

Modern Hybrid Design Editor (New)

  • Centered Global Action Bar: A sleek, floating island for high-level app control (Display Zoom, Page Width, and Navigation).
  • Draggable Contextual MiniTuner: A smart, persistent tuning panel that follows your selection and allows real-time styling of components.
  • Specialized Component Tuners: Dedicated interactive environments for fine-tuning the Product Grid, Sidebar Layout, Virtual Numpad, and Order History.
  • Smooth Scaling Engine: Fluid, non-snapping item resizing powered by dynamic CSS Grid auto-fill and minmax logic.
  • Live Color Sampler: Extract and apply brand colors directly from product images to your global theme.
  • Apple-Inspired Dark Mode: A sleek, flat interface utilizing glassmorphism, framer-motion animations, and modern aesthetics.
  • Layout Presets: Quickly toggle between Compact POS (high density) and Cozy Desktop (spacious) modes.

Data Export & Reporting

  • Export Formats: CSV, XLSX, and ODS.
  • Thai Accounting Reports: Built-in support for Thai Sales Tax Reports (ΰΈ£ΰΈ²ΰΈ’ΰΈ‡ΰΈ²ΰΈ™ΰΈ ΰΈ²ΰΈ©ΰΈ΅ΰΈ‚ΰΈ²ΰΈ’).

Security & Privacy

  • Encrypted Database: Local data is protected via SQLCipher (AES-256 encryption).
  • Local-First: Your data stays on your machine.
  • Mock API Mode: Develop and test the UI directly in the browser without needing the Tauri backend.

Tech Stack

  • Frontend: Next.js 16 (React 19), Tailwind CSS 4, Framer Motion
  • Backend: Tauri v2 (Rust)
  • Database: SQLite with SQLCipher (via Diesel ORM in Rust)
    • Automatic Path Resolution: Uses directories crate to store data securely in the system's local data directory (e.g., ~/.local/share/simple-pos on Linux).
  • Icons: React Icons (Font Awesome & more)
  • State Management: React Hooks & Context (optimized with specialized providers)

Project Structure

simple-pos/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/            # Next.js App Router pages and layouts
β”‚   β”œβ”€β”€ components/     # Modularized UI components
β”‚   β”œβ”€β”€ context/        # Global state management
β”‚   β”œβ”€β”€ lib/
β”‚   β”‚   β”œβ”€β”€ api/        # Module-based service layer
β”‚   β”‚   β”œβ”€β”€ types/      # TypeScript definitions
β”‚   β”‚   └── utils/      # Shared helper functions
β”‚   └── constants/      # Permanent application constants
β”œβ”€β”€ src-tauri/          # Rust backend source
β”œβ”€β”€ TODO.md             # TODO list
└── package.json

Prerequisites

Before you begin, ensure you have the following installed:

  • Node.js (v24 or newer recommended)
  • Rust & Cargo (latest stable)
  • System Dependencies:
    • Linux: Build essentials, webkit2gtk
    • macOS: Xcode Command Line Tools, OpenSSL
    • Windows: Microsoft Visual Studio C++ Build Tools, OpenSSL

Setup & Development

1. Install Dependencies

npm install

2. Run in Development Mode

npm run tauri dev

Note for Linux Users: The tauri script automatically sets WEBKIT_DISABLE_DMABUF_RENDERER=1 to prevent rendering issues.

3. Build for Production

To build a standalone executable:

npm run tauri build

License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors