POS System

A modern, feature-rich Point of Sale (POS) system built with Laravel 12, Filament 4, and Livewire 3.

📸 Screenshots

Click to view screenshots

Dashboard

POS Interface

Sales Management

Item Management

✨ Features

Core POS Functionality

• 🛒 Product Management - Complete CRUD with categories
• 🛍️ Shopping Cart - Real-time calculations and updates
• 💳 Multiple Payment Methods - Cash, Card, Bank Transfer
• 💰 Discount System - Percentage & fixed amount discounts
• 👤 Customer Management - Track customer purchases
• 📊 Stock Tracking - Real-time inventory validation
• 🔍 Advanced Search - Quick product search with filters

Dashboard & Reporting

• 📈 Sales Statistics - Comprehensive sales analytics
• 💵 Revenue Tracking - Daily, weekly, monthly reports
• 📦 Inventory Overview - Stock levels at a glance
• 🔔 Low Stock Alerts - Automated notifications

User Interface

• 🎨 Modern Design - Clean and professional UI
• ⚡ Fast & Intuitive - Optimized for speed
• 📱 Mobile Responsive - Works on all devices
• 🌙 Filament Admin - Powerful admin panel

🚀 Demo

Live Demo: https://pos-app-yi7setba.on-forge.com

Demo Credentials:

• Email: [email protected]
• Password: demo

📋 Requirements

Before you begin, ensure your system meets the following requirements:

• PHP >= 8.3
• Composer >= 2.0
• MySQL >= 8.0 (or MariaDB >= 10.3)
• Node.js >= 20.0 & npm >= 10.0
• Git

Recommended PHP Extensions

php-mbstring
php-xml
php-bcmath
php-curl
php-gd
php-mysql
php-zip
php-intl

⚙️ Installation

1. Clone the Repository

git clone https://github.com/fabyo0/pos-app.git
cd pos-app

2. Install Dependencies

# Install PHP dependencies
composer install

# Install Node.js dependencies
npm install

3. Environment Configuration

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

4. Database Setup

Update your .env file with database credentials:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=pos_system
DB_USERNAME=your_username
DB_PASSWORD=your_password

Create the database:

mysql -u root -p
CREATE DATABASE pos_system;
exit;

5. Run Migrations & Seeders

# Run migrations
php artisan migrate

# Seed database with sample data
php artisan db:seed

6. Create Storage Symlink

php artisan storage:link

7. Build Frontend Assets

# Development
npm run dev

# Production
npm run build

8. Start the Application

php artisan serve

Visit: http://localhost:8000

🔐 Default Credentials

After seeding, you can log in with:

• Email: [email protected]
• Password: password

🧪 Running Tests

This project uses PestPHP for testing.

Run All Tests

php artisan test

Or using Pest directly:

./vendor/bin/pest

Run Specific Test Suite

# Feature tests only
php artisan test --testsuite=Feature

# Unit tests only
php artisan test --testsuite=Unit

Test with Coverage

php artisan test --coverage

Testing Database

Configure a separate testing database in .env.testing:

DB_CONNECTION=mysql
DB_DATABASE=pos_system_testing

🛠️ Tech Stack

🤝 Contributing

Contributions are welcome! Please follow these steps:

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

🐛 Bug Reports & Feature Requests

Found a bug or have a feature request? Please open an issue.

📝 License

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

🙏 Acknowledgments

• Laravel - The PHP Framework
• Filament - Admin Panel
• Livewire - Reactive Components
• Tailwind CSS - Utility-first CSS

💖 Support

If you find this project helpful, please give it a ⭐️!

📊 Project Stats

Built with ❤️ by Fabyo