PHPackages                             team-nifty-gmbh/flux-erp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. team-nifty-gmbh/flux-erp

ActiveLibrary[Admin Panels](/categories/admin)

team-nifty-gmbh/flux-erp
========================

v1.7.2(2w ago)417.4k↓38.9%1[7 issues](https://github.com/Team-Nifty-GmbH/flux-core/issues)[13 PRs](https://github.com/Team-Nifty-GmbH/flux-core/pulls)4MITPHPPHP ^8.4CI passing

Since Jul 25Pushed 1w ago1 watchersCompare

[ Source](https://github.com/Team-Nifty-GmbH/flux-core)[ Packagist](https://packagist.org/packages/team-nifty-gmbh/flux-erp)[ Docs](https://flux-erp.com)[ RSS](/packages/team-nifty-gmbh-flux-erp/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (10)Dependencies (189)Versions (225)Used By (4)

[![](https://user-images.githubusercontent.com/40495041/160839207-0e1593e0-ff3d-4407-b9d2-d3513c366ab9.svg)](https://team-nifty.com)

Flux ERP
========

[](#flux-erp)

Flux ERP is a modern, open-source ERP built on Laravel and Livewire. It ships as a **Composer package** that you install into a Laravel application.

Important

Flux is a **package, not a standalone app.** That is why this repository has no `artisan` file and no `bootstrap/app.php` — those belong to the Laravel host application. You cannot run `php artisan …` inside this repository directly. Install it into a fresh Laravel app as shown below.

Requirements
------------

[](#requirements)

- PHP **8.4** (`bcmath`, `intl`, `json`, `pdo`, `zip`)
- MySQL 8 / MariaDB
- [Meilisearch](https://www.meilisearch.com/) — search (Laravel Scout)
- Composer 2

No Node.js or frontend build is needed on the project side. Flux serves its compiled assets straight from the package at runtime.

Installation
------------

[](#installation)

```
# 1. Create a fresh Laravel app
composer create-project laravel/laravel flux-app
cd flux-app

# 2. Require Flux (service provider, migrations, routes and assets auto-register)
composer require team-nifty-gmbh/flux-erp

# 3. Require the license package (provides the install wizard)
composer require team-nifty-gmbh/flux-license

# 4. Run the interactive install wizard
php artisan flux:install

# 5. Link storage for uploaded media
php artisan storage:link
```

Configure your database, Meilisearch and mail credentials in `.env` before running the wizard, and remove the default welcome route from `routes/web.php` (Flux registers its own).

The `php artisan flux:install` wizard guides you through the remaining setup (migrations, roles and permissions, base data, payment types, and so on). If you prefer to run the steps manually instead, use `php artisan migrate` and `php artisan init:permissions`.

### Seeding base data

[](#seeding-base-data)

Add the seeder to `database/seeders/DatabaseSeeder.php`:

```
$this->call(\FluxErp\Database\Seeders\FluxSeeder::class);
```

then run `php artisan db:seed`.

Serve the app with `php artisan serve` (or Sail) and log in.

Frontend assets
---------------

[](#frontend-assets)

Assets are compiled inside the package and served through its own `/flux/…` routes. The `@fluxStyles` and `@fluxScripts` Blade directives inject them — add these to your `` and before `` only if you use a custom layout instead of the shipped one. Nothing to build or publish.

Realtime (Laravel Reverb)
-------------------------

[](#realtime-laravel-reverb)

Flux uses [Laravel Reverb](https://reverb.laravel.com/) for realtime features. Broadcasting credentials are read from `.env` at runtime, so no rebuild is required when they change.

```
php artisan reverb:start
```

```
REVERB_APP_ID=local
REVERB_APP_KEY=local
REVERB_APP_SECRET=local
REVERB_HOST=your.domain.com
REVERB_SCHEME=https
REVERB_PORT=443
```

In production run Reverb behind your web server as a reverse proxy so websocket traffic reaches it on port 443.

Publishing package resources (optional)
---------------------------------------

[](#publishing-package-resources-optional)

Only needed to override defaults:

TagPublishes`flux-config``config/flux.php``flux-views`Blade views into `resources/views/vendor/flux``flux-translations`Language files`flux-migrations`Migrations into `database/migrations``flux-seeders`Seeders into `database/seeders``flux-docker`Docker/Sail setup```
php artisan vendor:publish --tag=flux-config
```

Development
-----------

[](#development)

Flux publishes a Docker/Sail setup that runs nginx instead of `artisan serve`:

```
php artisan vendor:publish --tag=flux-docker
```

Run the package test suite (uses [Testbench](https://github.com/orchestral/testbench)) from the package directory:

```
composer install
composer test
```

Documentation
-------------

[](#documentation)

Guides for extending Flux live in [`docs`](./docs): [routes](./docs/routes.md), [views](./docs/views.md), [widgets](./docs/widgets.md), [print views](./docs/print-views.md), [monitorable jobs](./docs/monitorable-jobs.md), [backend customization](./docs/customizing-backend.md).

License
-------

[](#license)

Flux ERP is open-sourced software licensed under the [MIT license](LICENSE.md).

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance77

Regular maintenance activity

Popularity32

Limited adoption so far

Community25

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 68.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~14 days

Recently: every ~4 days

Total

75

Last Release

19d ago

Major Versions

v0.5.2 → v1.0.02026-04-03

PHP version history (3 changes)v0.0.1PHP ^8.2

v0.5.0PHP ^8.3

v1.0.0PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/315f809551baee16f7c5531f89a864b4d5b59bde8882779c30d4a01ae36e718e?d=identicon)[team-nifty](/maintainers/team-nifty)

---

Top Contributors

[![patrickweh](https://avatars.githubusercontent.com/u/40495041?v=4)](https://github.com/patrickweh "patrickweh (3866 commits)")[![SirSplasch](https://avatars.githubusercontent.com/u/27318897?v=4)](https://github.com/SirSplasch "SirSplasch (865 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (257 commits)")[![Slupi](https://avatars.githubusercontent.com/u/866949?v=4)](https://github.com/Slupi "Slupi (191 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (181 commits)")[![sajberkurajber90](https://avatars.githubusercontent.com/u/55606412?v=4)](https://github.com/sajberkurajber90 "sajberkurajber90 (157 commits)")[![ktownmaxi](https://avatars.githubusercontent.com/u/112746096?v=4)](https://github.com/ktownmaxi "ktownmaxi (68 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (61 commits)")[![benefarr](https://avatars.githubusercontent.com/u/86836319?v=4)](https://github.com/benefarr "benefarr (22 commits)")[![mumumuri](https://avatars.githubusercontent.com/u/112871629?v=4)](https://github.com/mumumuri "mumumuri (4 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/team-nifty-gmbh-flux-erp/health.svg)

```
[![Health](https://phpackages.com/badges/team-nifty-gmbh-flux-erp/health.svg)](https://phpackages.com/packages/team-nifty-gmbh-flux-erp)
```

###  Alternatives

[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[typicms/base

A modular multilingual CMS built with Laravel, enabling developers to manage structured content like pages, news, events, and more.

1.6k20.4k](/packages/typicms-base)[unopim/unopim

UnoPim Laravel PIM

10.8k2.5k](/packages/unopim-unopim)[team-nifty-gmbh/tall-datatables

Server-side rendered datatables for Laravel and Livewire

1422.0k5](/packages/team-nifty-gmbh-tall-datatables)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
