StockX is a powerful and intuitive inventory management solution built with Laravel and FilamentPHP, designed to streamline your stock, orders, suppliers, and user roles—all in one place. Whether you're managing a warehouse, a small business, or a large-scale operation, StockX provides all the tools you need to keep your inventory under control.

• Product Categories – Create, update, soft-delete, and manage product categories.
• Suppliers – Maintain supplier records with full CRUD capabilities.
• Products – Track products with key details like quantity, supplier, pricing, and category.

• Order Handling – Create and manage orders with automatic stock validation and dynamic inventory updates.
• Stock Validation – Ensure product availability during order processing.
• Low Stock Alerts – Email notifications when stock dips below a set threshold.

• User Admin – Create, edit, and manage users with role assignments.
• Role-Based Access Control (RBAC) – Fine-tuned permission handling with Filament Shield.

• Low Stock Emails – Automatic alerts to notify admins when stock is low.

• Interactive Charts – Visualize sales and inventory trends.
• Quick Stats – Glance at total users, products, orders, and alerts.

• Smart Search – Look up products, orders, and suppliers with rich result details.
• Quick Navigation – Jump straight to the item’s page from search results.

• Order Filters – Filter by custom timeframes like today, this week, or this year.
• Supplier Tabs – Organize suppliers by product categories.

• Secure Login – Full auth system with email verification.
• Permissions System – Restrict access by user roles for enhanced security.

Here’s a quick peek at what StockX looks like in action:

• Dashboard
  

• Products
  

• Orders
  

• Create Order
  

• Roles
  

• Edit Role
  

• Email Notification (Low Stock)
  

Make sure you have the following installed:

• PHP ≥ 8.2
• Composer ≥ 2.3
• Node.js ≥ 18.8
• NPM ≥ 8.18
• Mailpit – For testing email notifications

git clone https://github.com/abogo-nono/StocksX.git

cd StocksX

composer install
npm install

Rename .env.example to .env and adjust environment variables:

APP_NAME=StockX
APP_ENV=local
APP_URL=http://127.0.0.1:8000
DB_DATABASE=stocksx
DB_USERNAME=root
DB_PASSWORD=
MAIL_HOST=localhost
MAIL_PORT=1025

php artisan migrate
php artisan db:seed

php artisan make:filament-user
php artisan shield:install --fresh
php artisan shield:generate --all
php artisan shield:super-admin --user=1

php artisan storage:link

php artisan serve

npm run dev

Access it at http://127.0.0.1:8000

We’d love to hear your thoughts!

• 🐛 Found a bug? Open an issue
• 🌟 Got a feature idea? Share it or submit a pull request

This project is open-source and available under the MIT License.