PHPackages                             hillelcoren/invoice-ninja - 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. [Payment Processing](/categories/payments)
4. /
5. hillelcoren/invoice-ninja

ActiveProject[Payment Processing](/categories/payments)

hillelcoren/invoice-ninja
=========================

Invoices, expenses & time-tracking built with Laravel

v5.13.2(2mo ago)9.7k1162.6k[900 issues](https://github.com/invoiceninja/invoiceninja/issues)[6 PRs](https://github.com/invoiceninja/invoiceninja/pulls)Elastic LicensePHPPHP >=8.2CI failing

Since Mar 19Pushed today211 watchersCompare

[ Source](https://github.com/invoiceninja/invoiceninja)[ Packagist](https://packagist.org/packages/hillelcoren/invoice-ninja)[ RSS](/packages/hillelcoren-invoice-ninja/feed)WikiDiscussions v5-stable Synced 1mo ago

READMEChangelog (10)Dependencies (189)Versions (966)Used By (0)Security (1)

[![Sublime's custom image](https://raw.githubusercontent.com/hillelcoren/invoice-ninja/master/public/images/round_logo.png)](https://www.youtube.com/watch?v=CxGxXiotv0I "Invoice Ninja Overview Video")

[![v5-develop phpunit](https://github.com/invoiceninja/invoiceninja/workflows/phpunit/badge.svg?branch=v5-develop)](https://github.com/invoiceninja/invoiceninja/workflows/phpunit/badge.svg?branch=v5-develop)[![Codacy Badge](https://camo.githubusercontent.com/d54bbdde42349b10ef257934264774261af83aeb74003d251aded20386a51ecd/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f47726164652f6431366337386161643835373434363662663833323332623531336566346662)](https://www.codacy.com/gh/turbo124/invoiceninja/dashboard?utm_source=github.com&utm_medium=referral&utm_content=turbo124/invoiceninja&utm_campaign=Badge_Grade)[![CLA assistant](https://camo.githubusercontent.com/1c0e13b36c13210aed1073080c9df42c7311e9fc0a8e970cf59382b11da92544/68747470733a2f2f636c612d617373697374616e742e696f2f726561646d652f62616467652f696e766f6963656e696e6a612f696e766f6963656e696e6a61)](https://cla-assistant.io/invoiceninja/invoiceninja)

Invoice Ninja 5
===============

[](#invoice-ninja-5)

Invoice Ninja Version 5 is here! We've taken the best parts of version 4 and added the most requested features to create an invoicing application like no other. Check the [Invoice Ninja YouTube Channel](https://www.youtube.com/@appinvoiceninja) to get up to speed, or try the [Demo](https://react.invoicing.co/demo) now.

**Choose your setup**

- [Hosted](https://www.invoiceninja.com): Our hosted version is a Software as a Service (SaaS) solution. You're up and running in under 5 minutes, with no need to worry about hosting or server infrastructure.
- [Self-Hosted](https://www.invoiceninja.org): For those who prefer to manage their own hosting and server infrastructure. This version gives you full control and flexibility.

All Pro and Enterprise features from the hosted app are included in the source-available code. We offer a $40 per year white-label license to remove the Invoice Ninja branding from client-facing parts of the app.

#### Get social with us

[](#get-social-with-us)

- [Support Forum](https://forum.invoiceninja.com)
- [Slack](http://slack.invoiceninja.com)
- [Discord](https://discord.gg/ZwEdtfCwXA)
- [Instagram](https://www.instagram.com/appinvoiceninja)

#### Documentation

[](#documentation)

- [Invoice Ninja - API](https://api-docs.invoicing.co/)
- [Invoice Ninja - Developer Guide](https://invoiceninja.github.io/en/developer-guide/)
- [Invoice Ninja - User Guide](https://invoiceninja.github.io/en/user-guide/)
- [Invoice Ninja - Self-Hosted Installation Guide](https://invoiceninja.github.io/en/self-host-installation/)

Installation Options and Clients
--------------------------------

[](#installation-options-and-clients)

### Mobile Apps

[](#mobile-apps)

- [iPhone](https://apps.apple.com/app/id1503970375?platform=iphone)
- [Android](https://play.google.com/store/apps/details?id=com.invoiceninja.app)
- [F-Droid](https://f-droid.org/en/packages/com.invoiceninja.app)

### Desktop Apps

[](#desktop-apps)

- [macOS](https://apps.apple.com/app/id1503970375?platform=mac)
- [Windows](https://microsoft.com/en-us/p/invoice-ninja/9n3f2bbcfdr6)
- [Linux - Snap](https://snapcraft.io/invoiceninja)
- [Linux - Flatpak](https://flathub.org/apps/com.invoiceninja.InvoiceNinja)

### Self-Hosted Server Installation

[](#self-hosted-server-installation)

**Note:** The self-hosted options do support the desktop and mobile apps.

- [Server or VM](https://invoiceninja.github.io/en/self-host-installation/)
- [Docker File](https://hub.docker.com/r/invoiceninja/invoiceninja/)
- [Cloudron](https://www.cloudron.io/store/com.invoiceninja.cloudronapp2.html)
- [Softaculous](https://www.softaculous.com/apps/ecommerce/Invoice_Ninja)
- [Elestio](https://elest.io/open-source/invoiceninja)
- [YunoHost](https://apps.yunohost.org/app/invoiceninja5)

### Recommended Providers

[](#recommended-providers)

- [Stripe](https://stripe.com/)
- [Postmark](https://postmarkapp.com/)

### SDKs available for easier API consumption

[](#sdks-available-for-easier-api-consumption)

- [Go SDK](https://github.com/AshkanYarmoradi/go-invoice-ninja)

\[Advanced\] Quick Hosting Setup
--------------------------------

[](#advanced-quick-hosting-setup)

In addition to the official [Invoice Ninja - Self-Hosted Installation Guide](https://invoiceninja.github.io/en/self-host-installation/) we have a few commands for you.

```
git clone --depth 1 -b v5.11.53 https://github.com/invoiceninja/invoiceninja.git
cp .env.example .env
composer i -o --no-dev
```

**Note** replace v5.11.53 with the latest tag version, you will also want to ensure that when performing updates, you use the latest tag version rather than a particular branch, ie v5-develop. This will ensure that you are not pulling in work in progress code.

Please Note: Your APP\_KEY in the .env file is used to encrypt data, if you lose this you will not be able to run the application.

Run if you want to load sample data, remember to configure .env

```
php artisan migrate:fresh --seed && php artisan db:seed && php artisan ninja:create-test-data
```

To run the web server

```
php artisan serve
```

Navigate to (replace localhost with the appropriate domain)

```
http://localhost:8000/setup - To setup your configuration if you did not load sample data.
http://localhost:8000/ - For Administrator Logon

user: small@example.com
pass: password

http://localhost:8000/client/login - For Client Portal

user: user@example.com
pass: password

```

Developers Guide
----------------

[](#developers-guide)

In addition to the official [Invoice Ninja - Developer Guide](https://invoiceninja.github.io/en/developer-guide/) we've got your back with some insights.

### App Design

[](#app-design)

The API and client portal have been developed using [Laravel](https://laravel.com) if you wish to contribute to this project familiarity with Laravel is essential.

When inspecting functionality of the API, the best place to start would be in the routes/api.php file which describes all of the availabe API endpoints. The controller methods then describe all the entry points into each domain of the application, ie InvoiceController / QuoteController

The average API request follows this path into the application.

- Middleware processes the request initially inspecting the domain being requested + provides the authentication layer.
- The request then passes into a Form Request (Type hinted in the controller methods) which is used to provide authorization and also validation of the request. If successful, the request is then passed into the controller method where it is digested, here is an example:

```
public function store(StoreInvoiceRequest $request)
{

    $invoice = $this->invoice_repo->save($request->all(), InvoiceFactory::create(auth()->user()->company()->id, auth()->user()->id));

    $invoice = $invoice->service()
                        ->fillDefaults()
                        ->triggeredActions($request)
                        ->adjustInventory()
                        ->save();

    event(new InvoiceWasCreated($invoice, $invoice->company, Ninja::eventVars(auth()->user() ? auth()->user()->id : null)));

    return $this->itemResponse($invoice);

}
```

Here for example we are storing a new invoice, we pass the validated request along with a factory into the invoice repository where it is processed and saved.

The returned invoice then passes through its service class (app/Services/Invoice) where various actions are performed.

A event is then fired which notifies listeners in the application (app/Providers/EventServiceProvider) which perform non blocking sub tasks

Finally the invoice is transformed (app/Transformers/) and returned as a response via Fractal.

### Developer environment

[](#developer-environment)

Using the Quick Hosting Setup describe above you can quickly get started building out your development environment. Instead of using

```
composer i -o --no-dev

```

use

```
composer i -o

```

This provides the developer tools including phpunit which allows the test suite to be run.

If you are considering contributing back to the main repository, please add in any tests for new functionality / modifications. This will greatly increase the chances of your PR being accepted

Also, if you plan any additions for the main repository, you may want to discuss this with us first on Slack where we can assist with any technical information and provide advice.

Credits
-------

[](#credits)

- [Hillel Coren](https://hillelcoren.com/)
- [David Bomba](https://github.com/turbo124)
- [Benjamin Beganović](https://github.com/beganovich)
- [All Contributors](https://github.com/invoiceninja/invoiceninja/graphs/contributors)

Want More?
----------

[](#want-more)

Checkout our other projects here!

[Event Schedule](https://www.eventschedule.com/)

Security
--------

[](#security)

If you find a security issue with this application, please send an email to . Please follow responsible disclosure procedures if you detect an issue. For further information on responsible disclosure please read [here](https://cheatsheetseries.owasp.org/cheatsheets/Vulnerability_Disclosure_Cheat_Sheet.html).

License
-------

[](#license)

Invoice Ninja is released under the Elastic License.
See [LICENSE](LICENSE) for details.

###  Health Score

72

—

ExcellentBetter than 100% of packages

Maintenance93

Actively maintained with recent releases

Popularity47

Moderate usage in the ecosystem

Community41

Growing community involvement

Maturity95

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 72.3% 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 ~4 days

Total

956

Last Release

62d ago

Major Versions

v4.5.46 → v5.3.292021-10-27

v4.5.47 → v5.3.352021-12-13

v4.5.48 → v5.3.452022-01-12

v4.5.49 → v5.3.562022-02-07

v4.5.50 → v5.3.752022-03-20

PHP version history (14 changes)v2.6.9PHP >=5.5.9

v4.0.0PHP >=7.0.0

v4.2.0PHP >=7.0.0 <7.2

v5.0PHP >=7.3

v5.0.33PHP ^7.3|^7.4

v4.5.34PHP >=7.1.0

v5.1.35PHP ^7.3|^7.4|^8.0

v5.3.0PHP ^7.4|^8.0

v4.5.46PHP >=7.3.0

v5.3.34PHP ^7.4|^8

v5.5.0PHP ^8.1

v5.7.34PHP ^8.1|^8.2

v5.9.0PHP ^8.2

v5.10.32PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/34fe480a7538132395e159b54174806e488eae487d24612c399a1c55e4275312?d=identicon)[tony13tv](/maintainers/tony13tv)

---

Top Contributors

[![turbo124](https://avatars.githubusercontent.com/u/5827962?v=4)](https://github.com/turbo124 "turbo124 (18679 commits)")[![hillelcoren](https://avatars.githubusercontent.com/u/4629496?v=4)](https://github.com/hillelcoren "hillelcoren (2993 commits)")[![beganovich](https://avatars.githubusercontent.com/u/13711415?v=4)](https://github.com/beganovich "beganovich (2852 commits)")[![LarsK1](https://avatars.githubusercontent.com/u/28981528?v=4)](https://github.com/LarsK1 "LarsK1 (374 commits)")[![paulwer](https://avatars.githubusercontent.com/u/52678724?v=4)](https://github.com/paulwer "paulwer (280 commits)")[![karneaud](https://avatars.githubusercontent.com/u/2140016?v=4)](https://github.com/karneaud "karneaud (175 commits)")[![CirkaN](https://avatars.githubusercontent.com/u/32557332?v=4)](https://github.com/CirkaN "CirkaN (124 commits)")[![cnohall](https://avatars.githubusercontent.com/u/36883813?v=4)](https://github.com/cnohall "cnohall (107 commits)")[![dshoreman](https://avatars.githubusercontent.com/u/1521802?v=4)](https://github.com/dshoreman "dshoreman (46 commits)")[![kishanmnpatel](https://avatars.githubusercontent.com/u/85978294?v=4)](https://github.com/kishanmnpatel "kishanmnpatel (26 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (22 commits)")[![joshuadwire](https://avatars.githubusercontent.com/u/3169995?v=4)](https://github.com/joshuadwire "joshuadwire (21 commits)")[![benbrummer](https://avatars.githubusercontent.com/u/24470839?v=4)](https://github.com/benbrummer "benbrummer (20 commits)")[![michael-hampton](https://avatars.githubusercontent.com/u/28355563?v=4)](https://github.com/michael-hampton "michael-hampton (13 commits)")[![Nisaba](https://avatars.githubusercontent.com/u/34550856?v=4)](https://github.com/Nisaba "Nisaba (11 commits)")[![svenbledt](https://avatars.githubusercontent.com/u/8340034?v=4)](https://github.com/svenbledt "svenbledt (10 commits)")[![Striffly](https://avatars.githubusercontent.com/u/13284087?v=4)](https://github.com/Striffly "Striffly (9 commits)")[![TechNoNerd87](https://avatars.githubusercontent.com/u/113461509?v=4)](https://github.com/TechNoNerd87 "TechNoNerd87 (9 commits)")[![jasonlbeggs](https://avatars.githubusercontent.com/u/25065083?v=4)](https://github.com/jasonlbeggs "jasonlbeggs (7 commits)")[![lwj5](https://avatars.githubusercontent.com/u/16207788?v=4)](https://github.com/lwj5 "lwj5 (6 commits)")

---

Tags

einvoicingexpensesflutterhacktoberfestinvoiceinvoiceninjainvoicesjavascriptkanbanlaravelpaymentsphpprojectsquotestaskstime-trackerlaravelsubscriptionsinvoicecrmprojectsinvoicingTasksinvoicesquotestime trackingfreelancerexpensesCredit card billingpurchase ordersstripe billing

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/hillelcoren-invoice-ninja/health.svg)

```
[![Health](https://phpackages.com/badges/hillelcoren-invoice-ninja/health.svg)](https://phpackages.com/packages/hillelcoren-invoice-ninja)
```

###  Alternatives

[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

22.8k69.3k](/packages/grumpydictator-firefly-iii)[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim

UnoPim Laravel PIM

9.4k1.8k](/packages/unopim-unopim)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)

PHPackages © 2026

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