Documentation

Everything you need to know to install and master VitaPOS.

Introduction

VitaPOS is an offline-first point of sale system built for pharmacies, bakeries, and general retail stores. It uses a local SQLite database to ensure your data is always on your machine and works without an internet connection.

Installation

Installing VitaPOS takes less than a minute.

  • Download the VitaPOS Setup 1.0.0.exe file from the Download page.
  • Double-click the installer.
  • Windows may show a "SmartScreen" warning. Click More Info and then Run Anyway.
  • Follow the installation wizard. The default path is C:\Program Files\VitaPOS.

First Login

Upon opening the application for the first time, you will be presented with a login screen. Use the default administrator credentials:

Username: admin
Password: admin123

Security Note: Immediately navigate to Staff / Users and change the default password.

Point of Sale (POS)

The POS is the heart of the application. It is designed for speed. You can use the following keyboard shortcuts:

  • F2: Focus the search bar to scan a barcode.
  • F4: Checkout the current cart.
  • Esc: Close any open modal or clear the search.

Inventory Management

VitaPOS tracks stock per batch, not just per product. This allows you to manage expiry dates accurately. Go to Inventory Alerts to see items running low or nearing expiry.

Customer Khata (Credit)

When checking out, select Pay on Credit (Khata). To view balances, go to the Customers & Khata page. Click the "Khata" button next to a customer to see their transaction history and record payments.

Reports & Profit/Loss

Navigate to the Profit & Loss page to generate financial reports. The system automatically deducts COGS and Operating Expenses from Gross Revenue to calculate Net Profit.

User Roles & Permissions

  • Admin: Full access to everything, including deleting sales, viewing P&L, and changing settings.
  • Pharmacist: Can access inventory, POS, and reports, but cannot manage users or view P&L.
  • Cashier: Restricted strictly to the POS and viewing customers.

Backup & Self-Heal

VitaPOS automatically backs up your database to your Documents folder when you close the app. If you ever encounter database errors or negative stock, go to Settings -> System Self-Heal and click "Run Diagnostics".