business management system with ERP, POS, invoicing, and CMS features. Laravel-based, Docker-ready. Still in active development
Samarium - Business Management System
---
About Samarium
Samarium is a work-in-progress business management system that aims to help small businesses handle basic operations like invoicing, inventory, and customer management in one place. While it's still in active development with many features being refined and added, it might be useful for simple business needs.
The project started as a learning exercise but has grown into something that could potentially help others who need basic business management tools without the complexity or cost of enterprise solutions.
Current Features
**Please note**: Many features are still being developed and improved. What's available now:
Basic ERP Functions
- Simple invoice generation
- Basic financial tracking (income/expenses)
- Customer database management
- Basic inventory tracking
Point of Sale
- Simple checkout process
- Basic receipt generation
- Product management
Website Management
- Simple CMS functionality
- Basic pages (About, Contact, etc.)
- Basic content management
Additional Tools
- Task management (basic)
- Calendar system
- Notice board
- Simple analytics dashboard
Customization Options
- Modular architecture (enable/disable features)
- Basic theme customization
- Configuration options
Who Might Find This Useful
This might be helpful for:
- Small businesses looking for a simple, free alternative to expensive software
- Developers wanting to to or learn from a Laravel-based business system
- Anyone needing basic business management tools while understanding this is still evolving
First-time setup only
docker exec -it samarium_app npm run dev
docker exec -it samarium_app composer dump-autoload
docker exec -it samarium_app php artisan migrate
docker exec -it samarium_app php artisan key:generate
docker exec -it samarium_app php artisan storage:link
docker exec -it samarium_app php artisan db:seed
Visit: http://127.0.0.1:8000 (website)
Dashboard: http://127.0.0.1:8000/dashboard
```
Installation
Manual Installation (requires PHP, MySQL, etc.)
Requirements
- PHP >= 8.2
- MySQL >= 8.0
- Composer
- Node.js & npm
Steps
```bash
git clone
cd samarium
cp .env.example .env
Create database and update .env with your database credentials:
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password
composer install
npm install
npm run dev
php artisan migrate
php artisan key:generate
php artisan storage:link
php artisan db:seed
php artisan serve
```
Access at `http://127.0.0.1:8000`
Configuration
You can enable or disable modules in `config/app.php`:
```php
'modules' => [
'dashboard' => true,
'product' => true,
'shop' => true,
'calendar' => true,
'analytics' => false, // Disable unused features
],
```
Theme colors can be customized in the same file:
```php
'app_menu_bg_color' => 'bg-dark',
'app_top_menu_bg_color' => 'bg-light',
```
Current Limitations
Being honest about where things stand:
- Many features are still basic and need improvement
- Documentation could be much better
- Some modules are incomplete
- UI/UX needs work in many areas
- Testing coverage is limited
- Performance optimizations are needed
Technical Details
- **Backend**: Laravel (PHP), Livewire
- **Frontend**: Bootstrap, Livewire
- **Database**: MySQL
- **Containerization**: Docker support included
A Note
This project is still evolving. While it works for basic needs, please consider it as "early stage" software. If you try it and encounter issues or have suggestions, feedback would be genuinely helpful for making it better.
Thanks for taking a look at this project.