Contributing

DBFlow is in public alpha. Useful contributions help validate the runtime, documentation, and Laravel / Filament developer experience before a stable release.

Useful contributions

  • Bug reports — reproducible steps on a Laravel or Filament app
  • Documentation fixes — unclear install steps, missing API details, broken links
  • Example workflows — real approval scenarios on Eloquent models
  • Laravel / Filament integration feedback — friction in your admin panel or service layer
  • Test cases — PHPUnit patterns that expose edge cases
  • DX suggestions — naming, defaults, error messages, and onboarding flow

Open issues on GitHub or email [email protected] for integration feedback.

Before proposing a feature

Ask whether the feature fits DBFlow's scope:

  • Is it model-first — attached to Eloquent business objects?
  • Is it useful for Laravel / Filament applications?
  • Does it help approval workflows — tasks, reject paths, audit trails?
  • Does it avoid turning DBFlow into a BPM platform?

If the answer is no, the feature likely belongs in application code or a different tool.

Not in scope for now

  • Full BPMN support
  • WordPress adapter
  • AI workflow generation
  • Generic form builder
  • Marketplace or plugin ecosystem
  • Enterprise orchestration suite

Related

Something wrong? Open an issue on GitHub