https://github.com/flatroy/stupid-inventory-laravel
WIP: Simple stupid inventory and organization system built for the Home User. Inspired by Homebox. Build on top of FilamentPHP. Would be self-hosted and as SaaS. Demo:
https://github.com/flatroy/stupid-inventory-laravel
filament inventory inventory-management jetstream-laravel laravel livewire
Last synced: 7 months ago
JSON representation
WIP: Simple stupid inventory and organization system built for the Home User. Inspired by Homebox. Build on top of FilamentPHP. Would be self-hosted and as SaaS. Demo:
- Host: GitHub
- URL: https://github.com/flatroy/stupid-inventory-laravel
- Owner: Flatroy
- License: agpl-3.0
- Created: 2024-06-17T08:37:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-28T13:21:55.000Z (8 months ago)
- Last Synced: 2025-03-26T05:33:21.372Z (7 months ago)
- Topics: filament, inventory, inventory-management, jetstream-laravel, laravel, livewire
- Language: PHP
- Homepage: https://inventory.daneke.ge/login
- Size: 2.22 MB
- Stars: 46
- Watchers: 5
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
#
Simple stupid inventory system for home or small business
## How to run with Docker
**Command list**
In order to run the project with Docker you need to have Docker installed on your machine. If you don't have Docker installed you can follow the instructions on the official Docker website: https://docs.docker.com/get-docker/
The following commands will clone the repository
git clone https://github.com/flatroy/stupid-inventory-laravel.git
Go to the project directory
cd stupid-inventory-laravel
Copy the .env.example file to .env file with the following command or manually copy the file and rename it to .env
cp .env.example .env
Run the following command to install the dependencies for PHP
docker run --rm -it -v $PWD:/app composer:latest install --ignore-platform-req=ext-intl
Run the following command to install the dependencies for Node.js (only to build the frontend, you can skip this step if you don't want to build the frontend with Docker)
docker run --rm -it -v $PWD:/app node:latest /bin/sh -c "cd /app && npm install -g bun && bun install && bun run build"
Run the following command to build the Docker image or if you want to use docker compose you can skip this steps
docker build -t stupid-inventory .
docker run -v $PWD:/app -p 4431:443 -it --rm --name my-stupid-inventory stupid-inventory
If you want to use docker compose you can run the following command
docker-compose up -d
Still some part are in WIP status: I need to add queue worker to docker-compose.yml as well as building the frontend within docker
## How to run locally (if you have PHP 8.3 and composer installed)
**Command list**
git clone https://github.com/flatroy/stupid-inventory-laravel.git
cd stupid-inventory-laravel
composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate
npm run build
php artisan serve
## TODO list
- [x] Items - add/edit/delete/import/export
- [x] Locations - add/edit/delete
- [x] Users/Teams/Invite to team/Registration/Login - via Laravel Jetstream
- [ ] Add Dockerfile and docker-compose.yml - https://serversideup.net/open-source/docker-php/ or dunglas/frankenphp
- [x] Add Dockerfile
- [x] Add docker-compose.yml
- [ ] Add queue worker to docker-compose.yml
- [ ] Add ability to build frontend with docker
- [ ] Add docker-compose.yml for production, development, testing, CI/CD
- [ ] Add mounting volumes for sqlite database file/or mysql connection and storage
- [x] Add tags to items
- [ ] Add attachments to items - https://filamentphp.com/plugins/filament-spatie-media-library (for now we have custom field for files and images)
- [x] Show related items in Location and Tag pages
- [x] Add QR code to items
- [x] Add multi-tenancy support - https://filamentphp.com/docs/3.x/panels/tenancy
- [ ] Fix ItemImporter to support multi-tenancy with queue. Team ID is not set up correctly for now on async driver
- [x] Add better import/export of items with relation to locations
- [x] Add import of locations. if location by name not found it will create new one
- [ ] Support labels/tags during import
- [ ] Support attachments during import
- [ ] Support nested path exports (e.g. `Home / Office / Desk`)
- [ ] Support custom fields during import
- [x] Add Laravel Octane
- [ ] Add Laravel Pulse
- [x] Add nice Dashboard for home-screen
- [x] Add custom fields to items
- [x] Paragraph field
- [x] Text field
- [x] File(s) field
- [x] Image field
- [x] Add spotlight. Click: CTRL + K or CMD + K or CTRL + / or CMD + /
- [x] Add Label Generator
- [ ] Add REST API
- [ ] Add backup [via spatie package](https://github.com/shuvroroy/filament-spatie-laravel-backu)
- [ ] add https://github.com/CodeWithDennis/filament-select-tree
## Contributing
Thank you for choosing to contribute to the project! Any contribution is welcome.