Configuration

After installation and licensing, configure the POS application for your business needs.

Business Settings

Access business settings from Settings → Business:

• Business Name: Your store or company name
• Currency: Select from supported currencies (USD, EUR, GBP, etc.)
• Tax Name: Display name for tax (e.g., "Sales Tax", "VAT", "GST")
• Tax Rate: Default tax percentage (0-100%)
• Receipt Printer: Printer port or IP address (optional)

Printer Configuration

USB Thermal Printers (Windows)

Most USB thermal printers appear as COM ports. Common ports:

• COM3, COM4, COM5, COM6, COM7, COM8, COM9

To find your printer port: 1. Open Device Manager 2. Expand "Ports (COM & LPT)" 3. Look for your printer (e.g., "USB Serial Port") 4. Note the COM number

Network Printers

Enter the printer's IP address (e.g., 192.168.1.100)

Test Printer

Use the Test Print button in Settings to verify your printer is working correctly.

Cloud Sync (Optional)

Enable cloud sync to backup your data to Supabase:

1. Navigate to Settings → Sync 2. Click "Connect to Supabase" 3. Enter your Supabase URL and anon key 4. Authorize via OAuth or enter credentials 5. Configure your store name

Security Settings

• Grace Period: Days the app works offline without license validation (default: 30)
• User Roles: Configure owner, manager, and cashier permissions

Data Backup

Manual backup: 1. Close the application 2. Copy the database file:

• Windows: %APPDATA%\com.posapp.desktop\posapp.db
• Mac: ~/Library/Application Support/com.posapp.desktop/posapp.db

3. Store the backup in a safe location

Reset

To reset the application to factory settings:

1. Close the application 2. Delete the database file 3. Restart the application (setup wizard will appear)