OpenStores - The Operating System for Modern Retail

OpenStores is a comprehensive, multi-tenant SaaS solution designed to streamline retail operations. From a lightning-fast Point of Sale (POS) to advanced inventory management and real-time analytics, OpenStores empowers independent retailers to compete with big-box giants.

🚀 Key Features

🛒 Modern Point of Sale (POS)

• High-Speed Checkout: Optimized for minimal clicks and fast processing.
• Offline Capable: Continue selling even when the internet goes down.
• Device Agnostic: Works perfectly on iPads, Android tablets, and Desktops.
• Smart Payments: Split payments, partial payments, and visual payment method selection.
• Barcode Integration: Full support for USB and Bluetooth barcode scanners.

📦 Advanced Inventory Management

• Real-time Tracking: Inventory updates instantly across all registers.
• Low Stock Alerts: Automated notifications when items need reordering.
• Product Variants: Handle complex products with sizes, colors, and materials.
• Stock Valuation: Real-time view of your inventory assets.

📊 Analytics & Reporting

• Live Dashboard: View sales, profit, and top products in real-time.
• Sales Reports: Detailed daily, weekly, and monthly performance breakdowns.
• Employee Performance: Track sales by staff member to incentivize growth.

🏢 Multi-Business Architecture

• SaaS Ready: Built from the ground up for multi-tenancy.
• Business Switching: Users can manage multiple separate businesses from a single account.
• Role-Based Access: Granular permissions for Owners, Managers, and Cashiers.

---

📸 Screenshots

Business Dashboard	Admin Dashboard

---

🛠️ Technology Stack

• Backend: Laravel 12.x
• Frontend: Blade Components + Livewire 3
• Interactivity: Alpine.js v3
• Styling: Tailwind CSS + FlyonUI
• Database: MySQL
• Testing: Pest / PHPUnit

---

⚙️ Installation

Prerequisites

• PHP >= 8.2
• Composer
• Node.js & NPM
• MySQL 8.0+

Setup Steps

1. Clone the repository

   git clone https://github.com/oheneadj/openstorev2.git
   cd openstores

2. Install PHP Dependencies

   composer install

3. Install & Build Frontend

   npm install
   npm run build

4. Environment Setup

   cp .env.example .env
   php artisan key:generate

5. Database Setup

   • Configure your database credentials in .env.
   • Run migrations and seeders:

   php artisan migrate --seed

6. Run the Server

   php artisan serve

   Visit http://localhost:8000 to access the application.

---

🧪 Testing

The application includes a comprehensive test suite covering authentication, multi-tenancy isolation, and core features.

To run tests:

php artisan test

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for more details.

1. Fork the repository.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

This project is open-sourced software licensed under the MIT license.