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
.png)
.png)
-
Products
.png)
.png)
-
Orders
.png)
-
Create Order
.png)
-
Roles
.png)
-
Edit Role
.png)
-
Email Notification (Low Stock)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
You only need Docker and Docker Compose installed on your system. All other dependencies (PHP, Composer, Node.js, MySQL, etc.) are handled inside containers.
- Docker ≥ 20.10
- Docker Compose ≥ 1.29
If you prefer manual installation, see the Manual Setup section below.
git clone https://github.com/abogo-nono/StocksX.git
cd StocksXcp .env.example .env
# Edit .env as needed (DB, mail, etc.)docker-compose up --build -d- This will build the app container, set up MySQL, and run all necessary services.
- All dependencies are installed automatically inside the containers.
docker-compose exec app php artisan migrate --seed
docker-compose exec app php artisan storage:link
docker-compose exec app php artisan make:filament-user
docker-compose exec app php artisan shield:install --fresh
docker-compose exec app php artisan shield:generate --all
docker-compose exec app php artisan shield:super-admin --user=1- Visit http://localhost:9000 (or the port you mapped)
If you want to run the app without Docker, follow these steps:
- PHP ≥ 8.2
- Composer ≥ 2.3
- Node.js ≥ 18.8
- NPM ≥ 8.18
- MySQL ≥ 8.0
- Mailpit – For testing email notifications
- Install dependencies:
composer install
npm install- Build frontend assets:
npm run build- Set up
.envand database as described above. - Run migrations, seeders, and setup commands as above.
- Start the Laravel server:
php artisan serve- (Optional) Start Vite dev server for hot reload:
npm run devWe’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.