velmphp/app

Official Velm Laravel application — greenfield ERP host with addons, panel, and setup scripts

v1.0.0-rc2 2026-06-06 05:37 UTC

Requires

• php: ^8.3
• laravel/framework: ^13.8
• laravel/tinker: ^3.0
• velmphp/framework: ^1.0@dev
• wikimedia/composer-merge-plugin: ^2.1

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.2.5
• laravel/pint: ^1.27
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• phpunit/phpunit: ^12.5.12

MIT

• admin
• laravel
• ERP
• Velm

README

Minimal Laravel host for a Velm ERP — Livewire panel, empty addons/, and bootstrap setup (base + admin).

Published on Packagist as velmphp/app. Monorepo path: apps/app/.

Packagist install

composer create-project velmphp/app my_app -s rc
cd my_app
composer run setup
composer run dev

Open http://127.0.0.1:8000/velm and sign in with [e-mail] / password.

See the installation guide.

Monorepo development

From the repository root:

composer install
cd apps/app
composer update
cp composer.local.json.example composer.local.json
composer update
composer run setup
composer run dev

composer.local.json adds path repositories to ../../packages/* (gitignored). Run composer update again after copying it so the merge plugin (already in vendor/) symlinks monorepo packages.

For the full reference app with demo addons, use apps/demo/ instead.

What composer run setup does

1. composer velm-build-css — publish prebuilt Velm shell assets
2. php artisan migrate — Laravel tables
3. php artisan velm:migrate — bootstrap modules (base, admin)
4. php artisan db:seed — admin user

Install more modules at /velm/apps or php artisan velm:module:install <name>.

Resetting the Velm schema

php artisan velm:migrate:fresh --yes
php artisan velm:seed

Maintainer checklist: PACKAGIST.md.