Skip to content

fabyo0/pos-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

37 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

POS System

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

Laravel Filament Livewire License


πŸ“Έ Screenshots

Click to view screenshots

Dashboard

Screenshot 2025-12-18 at 16 58 27

POS Interface

Screenshot 2025-12-18 at 16 59 21

Sales Management

Screenshot 2025-12-18 at 17 00 07

Item Management

Screenshot 2025-12-18 at 17 01 11

✨ 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:


πŸ“‹ 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:


πŸ§ͺ 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

Technology Version Purpose
Laravel 12.x Backend Framework
Filament 4.x Admin Panel
Livewire 3.x Frontend Reactivity
MySQL 8.x Database
Tailwind CSS 3.x Styling
Alpine.js 3.x JavaScript Framework
Vite 5.x Asset Bundling

🀝 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


πŸ’– Support

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


πŸ“Š Project Stats

GitHub stars GitHub forks GitHub issues GitHub pull requests


Built with ❀️ by Fabyo