Changelog & Release Notes

🚀 New Features & Enhancements

• Product Reference Field: You can now add an optional reference number to each product (such as a spare part number or supplier code). This field is optional and does not affect any existing data. You can now search for products by name, barcode, or reference number.

• Sidebar Navigation: A new option in System Preferences lets you switch between two layouts: the existing portal buttons, or a sidebar that appears on the right side of the screen with a command center dashboard. The change is instant — no restart needed.

• Proforma Invoice: In the POS screen, you can now print a preliminary invoice for the customer before completing the sale. Useful for quotes and price offers.

• Cash Drawer Settings: Full control over when the cash drawer opens automatically — after cash sales, after debt sales, with or without printing. All configurable from the Settings page.

• Manual Drawer Open from POS: A dedicated button to open the cash drawer directly from the POS screen (shortcut F12) without needing to complete a sale.

• Test Print Opens Drawer: When clicking “Test Print” in Settings, the cash drawer will also open to confirm everything is working correctly.

• Optional Password: Passwords are no longer required when creating a new user. Users without a password can log in simply by selecting their name.

• Remove Password: Users can now remove their account password from the Profile page if they prefer to log in without one.

• Proforma Shortcut Ctrl+P: A new keyboard shortcut to quickly print a proforma invoice from the POS screen.

🐛 Bug Fixes

• Field Navigation Fix: When adding a product, pressing Enter now correctly moves through fields in order: Name → Reference → Barcode → remaining fields.

🚀 New Features & Enhancements

• Improved POS Search Box: Enhanced the product search functionality to support typing in Arabic with spaces and backspaces naturally, while maintaining fast and accurate barcode scans without any layout conflicts.

🐛 Bug Fixes

• Cash Drawer Calculations: Cancelled and deleted invoices are now correctly excluded from expected cash balance totals, ensuring the drawer expected balance perfectly matches actual sales.
• Resolved Cash Drawer Freezes: Fixed an issue where the cash drawer view would sometimes appear completely empty due to a calculation parsing error.
• Sales Reports Accuracy: Cancelled and deleted invoices are now excluded from total revenue and sales count metrics in the Reports dashboard.
• Delete Cancelled Invoices: Added support to delete previously cancelled invoices directly to help keep your invoices list organized.
• Hide Deleted Invoices from Drawer: Deleted invoices are now completely hidden from the cash drawer invoices list, displaying only active and cancelled ones.

🚀 New Features & Enhancements

• Dynamic Excel File Picker Filters: Updated the file dialog filters to display “Excel Files” when importing products and data, replacing generic or hardcoded image file filters.

🐛 Bug Fixes

• Reports Initial Load Fix: Resolved the issue where reports appeared empty upon first entry by offloading query processing to background threads, ensuring immediate data visualization.
• Smart Center Crash Fix (Locale Formatting): Fixed data loading crashes in the Smart Center caused by regional decimal and negative sign formatting (e.g., Arabic locales) by standardizing database collation parsing using invariant culture.
• Cashier Performance Column Bindings: Corrected the math and data binding for the “Average Invoice” column in the Cashier Performance analytics view and adjusted colors for a cleaner presentation.

🚀 New Features & Enhancements

• Smart Decimal Formatting: Implemented dynamic decimal formatting across all list views, invoices, and reports to show precise values while hiding trailing zeros for integers (e.g., displaying 15 instead of 15.00), using a unified notation (comma , for thousands and dot . for decimals).
• Activation UI Usability: Added a “Paste” button, Ctrl+V keyboard shortcut support, and Enter key confirmation to the license activation screens for a smoother setup flow.
• Quick Buttons Performance: Greatly accelerated loading times in the Quick Buttons management dashboard, ensuring smooth browsing and full compatibility even with a very large number of products.
• Unified Print Button Design: Standardized the look and behavior of the debt statement print buttons in both Customer and Supplier directories to dynamically match the style of the Purchase Orders print action.

🐛 Bug Fixes

• Invoice Rounding Adjustment: Refined the POS rounding mechanism to only apply to the invoice grand total, preserving exact double-decimal pricing for individual items.
• Debt Payment Separator Fix: Updated debt payment fields for both customers and suppliers to allow decimal separator input at all times, replacing default zero values with clean placeholders.
• Cash Drawer Decimal Precision: Forced cash drawer expected totals and transactions to display with exactly two decimal places for absolute financial accuracy.

🔒 Security Updates

• Security fixes and stability improvements: General security updates to improve stability and protect the application licensing system.

🚀 New Features & Enhancements

• First-Run Printer Setup: Added a new configuration modal accessible via a gear icon ⚙️ on the startup welcome screen, allowing users to configure and test receipt, label, and A4 printers before registering or logging in.
• Smart Restart Handling: Improved the application’s reboot behavior during database recovery or reset to restart smoothly without showing false “application already running” warning messages.
• Localized Launch Warnings: The warning message shown when attempting to open the application twice is now displayed in the language configured in the application instead of the operating system’s default language.

🐛 Bug Fixes

• Font Size & Settings Persistence: Fixed an issue where the user’s preferred font size (Small, Medium, Large) reset to “Medium” when switching the UI language. The application now also preserves the active weight display unit (kg, g) and rounding configurations across language changes.
• Printer Dialog Centering & Scroll: Adjusted the printer setup dialog width to 520px with uniform spacing and added a vertical scrollbar to prevent layout clipping.

🚀 New Features & Enhancements

• License Activation Interface: Improved the in-app license key activation screen to be faster and simpler, featuring automatic focus tabbing between input boxes and autofocus on startup.
• Amount-in-Words Translation: Integrated a number-to-words converter on A4 invoices and purchase orders to print written totals for financial clarity.
• User Management Overhaul: Removed the redundant username field, unified employee profiles under their unique full name, enabled real-time duplicate name checking, and made Name, JobTitle, and Password fields mandatory.
• Stock Adjustments & Units: Made the adjustment reason optional to speed up daily stock edits, and enabled automatic scrolling to the end of the list when adding packaging units.
• Dynamic Alignment & Flow (RTL/LTR): Fixed dynamic text and element alignment for Login, FirstRun, profile dropdowns, and dashboard widgets to automatically adapt to flow directions.

🐛 Bug Fixes

• Excel Import/Export Fixes: Fixed Excel product imports by setting correct header options and resolved layout clipping and text wrapping issues on Excel sheets.
• Text Truncation Prevention: Increased price and unit column widths in the POS view and settings layouts to prevent text cut-offs when scaling fonts.
• Printers Test Capabilities: Added print testing features inside Settings for receipt, label, and A4 printers to verify connections.

🎉 Initial System Release (Stable Version)

• Fast Point of Sale (POS): Advanced, ultra-fast checkout screen supporting instant search by name or barcode, invoice parking, discounts control, and quick quantity edits.
• Inventory & Stock Management: Complete system to track items count, automatic low-stock alerts, shelf locations, item categorization, and product expiration dates tracking.
• Cash Drawer & Shift Control: Detailed tracking of cashier sessions, daily cash movements, custom expenses registry, and automatic cash variance calculations.
• Suppliers, Customers & Debt Tracking: Dedicated customer/supplier registries to manage purchases and sales, tracking pending credits/debts with full or partial payment logging.
• Receipt & Label Printing: Seamless integration with thermal receipt printers (58mm/80mm), standard A4 printers, barcode labels, and pricing tags.
• User Accounts & Permissions: Secure individual accounts for staff (Manager, Cashier, Sales) with custom access control to protect sensitive financial records and settings.