⚠️ PROJECT IN ACTIVE DEVELOPMENT / BETA Inventoros is currently in early development. Contributions and feedback are welcome!
Inventory Management for the Rest of Us
Inventoros is an open-source Inventory and Warehouse Management System (WMS) built with Laravel, Inertia.js, and Vue 3. Designed to bridge the gap between complex enterprise-grade WMS tools and user-friendly systems, Inventoros provides powerful inventory management capabilities with a developer-focused, extensible architecture.
Inventoros aims to democratize warehouse and inventory management by providing small and medium businesses with tools typically found only in expensive enterprise software, while offering developers a flexible, plugin-ready foundation for customization.
- Inventory Management: Complete CRUD operations, stock tracking, SKU management, product categories, suppliers, and locations
- Warehouse Management: Order management, fulfillment queues, and location-based tracking
- CSV Import/Export: Bootstrap your inventory with bulk data operations
- Plugin System: Modular extension layer for third-party add-ons and custom functionality
- REST + GraphQL API: Secure, tokenized API endpoints for integration with e-commerce, ERP, and custom systems
- Multi-User Support: Role-based permissions, teams, and organization-level data isolation
- Installer Wizard: Guided setup flow with database validation and admin creation
- Update Management: Version-controlled migrations and UI-driven update flow
- Backend: Laravel 12 (PHP 8.2+)
- Frontend: Inertia.js + Vue 3 + Vite
- Database: MySQL / PostgreSQL (abstraction-ready)
- Queueing & Events: Redis + Laravel Horizon (planned)
- Extensions: Composer-based + JSON manifest layer for plugin registration
- PHP 8.2 or higher
- Composer
- Node.js 18+ and npm
- MySQL 8.0+ or PostgreSQL 13+
- Redis (optional, recommended for production)
# Clone the repository
git clone https://github.com/inventoros/inventoros.git
cd inventoros
# Install dependencies and set up
composer install
cp .env.example .env
php artisan key:generate
# Configure your database in .env, then migrate
php artisan migrate
# Install frontend dependencies and build
npm install
npm run build
# Serve the application
php artisan serveFor active development with hot-reloading:
# Run all development services (server, queue, logs, vite)
composer dev
# Or run individually:
php artisan serve # Application server
npm run dev # Vite dev server with HMR
php artisan queue:work # Queue worker (if needed)-
Environment Setup: Copy
.env.exampleto.envand configure:- Database credentials (
DB_*) - Application URL (
APP_URL) - Mail settings (for notifications)
- Queue driver (recommend
redisfor production)
- Database credentials (
-
Database Migration: Run
php artisan migrateto create the database schema -
Asset Compilation: Run
npm run buildfor production ornpm run devfor development
- Base Laravel + Inertia scaffolding
- Multi-tenant architecture foundation
- Installer & Update Manager (CLI + UI)
- Basic Inventory module (CRUD operations)
- Role-Based Access Control (Permission-based system)
- Product categorization and locations
- Multi-currency support
- CSV Import/Export foundation
- Backup system
- Unit and feature tests
- Warehouse location management
- Order management (CRUD with inventory tracking)
- Stock movement tracking (automatic on orders)
- Product categorization system
- Supplier management
- Purchase order management
- Product variants
- Advanced stock movement workflows
- Plugin system architecture (WordPress-style hooks)
- Database plugin activation system
- Plugin slot system with multiple hooks
- Sample plugin with documentation
- REST API endpoints (Products, Categories, Locations, Orders, Stock Adjustments, Suppliers, Purchase Orders, Barcode Lookup)
- GraphQL API layer
- API documentation
- Barcode/QR code generation
- Reporting and analytics dashboard (Inventory Valuation, Stock Movement, Sales Analysis, Low Stock, Category Performance)
- Audit logging (Activity Log with filtering)
- Barcode/QR code scanning
- Advanced permissions (custom permission sets)
- Multi-warehouse support
Inventory & Product Management
- Product Management: Complete inventory CRUD with SKU, pricing, stock levels, categories, locations, and barcodes
- Multi-Currency Support: Product pricing in multiple currencies with conversion support
- Categories & Locations: Organize products by category and track warehouse locations
- Barcode Generation: Automatic barcode generation for products
- CSV Import/Export: Bulk import and export of product data
Order & Warehouse Management
- Order Management: Full order lifecycle (create, view, edit, delete) with automatic inventory adjustments
- Stock Movement Tracking: Automatic tracking of inventory changes through orders
- Warehouse Locations: Location-based inventory tracking
- Supplier Management: Complete supplier CRUD with product associations
- Purchase Orders: Full purchase order lifecycle with item receiving workflow
User & Access Management
- User Management: Full CRUD with role assignment and permission-based access control
- Role Management: Custom roles with granular permissions, system roles (Administrator, Manager, Member)
- Permission System: Granular permission checks at route and UI levels
- Custom Error Pages: Beautiful 403 access denied pages with light/dark mode
System & Extensions
- Plugin System: WordPress-style hooks and filters with database activation
- Plugin Slots: Extensible UI component system with multiple hook points
- Sample Plugin: Comprehensive example plugin with documentation
- REST API: Complete API for Products, Categories, Locations, Orders, Stock Adjustments, Suppliers, Purchase Orders, and Barcode Lookup
- Installer Wizard: Guided setup with database validation and admin account creation
- Update Manager: Version-controlled updates with automatic backup system
- Backup System: Automatic backups before system updates
- Notification System: Header dropdown with notification management
- Activity Logging: Complete audit log with filtering by user, action, date, and subject type
Reporting & Analytics
- Dashboard Analytics: Overview with stats, recent activity, stock movements, and top products
- Inventory Valuation Report: Stock value by product and category
- Stock Movement Report: Track all inventory adjustments with filtering
- Sales Analysis Report: Revenue, top products, and daily sales trends
- Low Stock Report: Identify products below minimum stock levels
- Category Performance Report: Analyze stock and value by category
User Experience
- Dark Mode: Full application support with persistent theme preferences
- Responsive Design: Mobile-friendly UI throughout the application
- Modern UI: Built with Vue 3, Inertia.js, and Tailwind CSS
- Proper Sidebar Navigation: Intuitive navigation structure
Testing & Quality
- Unit Tests: Comprehensive unit test coverage
- Feature Tests: Integration tests for critical workflows
- Code Quality: PSR-12 compliant with Laravel Pint formatting
- GraphQL API layer
- API documentation
- Product variants
- Advanced inventory workflows
- Barcode scanning support
- Multi-warehouse support
- Advanced permissions (custom permission sets)
We welcome contributions! Please see CONTRIBUTING.md for guidelines on how to get started.
- Follow PSR-12 coding standards
- Write tests for new features
- Use conventional commit messages
- Update documentation for significant changes
# Run all tests
composer test
# Run specific test suites
php artisan test --testsuite=Feature
php artisan test --testsuite=Unit# Format code with Laravel Pint
./vendor/bin/pint
# Run static analysis (when configured)
./vendor/bin/phpstan analyse- cPanel Deployment Guide - Deploy Inventoros on shared hosting with cPanel
- Installation Guide (Coming Soon)
- Plugin Development (Coming Soon)
- API Documentation (Coming Soon)
- Architecture Overview (Coming Soon)
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Security: See SECURITY.md for reporting vulnerabilities
Inventoros is open-source software licensed under the MIT license.
Built with:
- Laravel - The PHP Framework for Web Artisans
- Inertia.js - The Modern Monolith
- Vue.js - The Progressive JavaScript Framework
- Tailwind CSS - A utility-first CSS framework
Note: This is the open-source core of Inventoros. The hosted SaaS platform and marketplace (Inventoros Live) are maintained separately and are not part of this repository.