ba75a44eb8
* Adopt Laravel coding style The Laravel framework adopts the PSR-2 coding style with some additions. Laravel apps *should* adopt this coding style as well. However, Shift allows you to customize the adopted coding style by adding your own [PHP CS Fixer][1] `.php_cs` config to your project. You may use [Shift's .php_cs][2] file as a base. [1]: https://github.com/FriendsOfPHP/PHP-CS-Fixer [2]: https://gist.github.com/laravel-shift/cab527923ed2a109dda047b97d53c200 * Shift bindings PHP 5.5.9+ adds the new static `class` property which provides the fully qualified class name. This is preferred over using class name strings as these references are checked by the parser. * Shift core files * Shift to Throwable * Add laravel/ui dependency * Unindent vendor mail templates * Shift config files * Default config files In an effort to make upgrading the constantly changing config files easier, Shift defaulted them so you can review the commit diff for changes. Moving forward, you should use ENV variables or create a separate config file to allow the core config files to remain automatically upgradeable. * Shift Laravel dependencies * Shift cleanup * Upgrade to Laravel 7 Co-authored-by: Laravel Shift <shift@laravelshift.com> |
||
|---|---|---|
| .github/workflows | ||
| app | ||
| bootstrap | ||
| config | ||
| cypress | ||
| database | ||
| public | ||
| resources | ||
| routes | ||
| storage | ||
| tests | ||
| .babelrc | ||
| .codacy.yml | ||
| .editorconfig | ||
| .env.ci | ||
| .env.dusk.example | ||
| .env.example | ||
| .env.travis | ||
| .gitattributes | ||
| .gitignore | ||
| .htaccess | ||
| .prettierrc | ||
| .travis.yml | ||
| LICENSE | ||
| README.md | ||
| VERSION.txt | ||
| artisan | ||
| codecov.yml | ||
| composer.json | ||
| composer.lock | ||
| cypress.json | ||
| package-lock.json | ||
| package.json | ||
| phpunit.xml | ||
| server.php | ||
| swagger.json | ||
| tailwind.config.js | ||
| webpack.mix.js | ||
README.md
Invoice Ninja version 5 is coming!
We will be using the lessons learnt in Invoice Ninja 4.0 to build a bigger better platform to work from. If you would like to contribute to the project we will gladly accept contributions for code, user guides, bug tracking and feedback! Please consider the following guidelines prior to submitting a pull request:
Quick Start
Currently the client portal and API are of alpha quality, to get started:
git clone https://github.com/invoiceninja/invoiceninja.git
git checkout v2
cp .env.example .env
cp .env.dusk.example .env.dusk.local
php artisan key:generate
composer update
npm i
npm run production
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 ninja.test as required)
http://ninja.test:8000/setup - To setup your configuration if you didn't load sample data.
http://ninja.test:8000/ - For Administrator Logon
user: small@example.com
pass: password
http://ninja.test:8000/client/login - For Client Portal
user: user@example.com
pass: password
Contribution guide.
Code Style to follow PSR-2 standards.
All methods names to be in CamelCase
All variables names to be in snake_case
Where practical code should be strongly typed, ie your methods must return a type ie
public function doThis() : void
PHP >= 7.3 allows the return type Nullable so there should be no circumstance a type cannot be return by using the following:
public function doThat() ?:string
To improve chances of PRs being merged please include tests to ensure your code works well and integrates with the rest of the project.
Documentation
API documentation is hosted using Swagger and can be found HERE
Current work in progress
Invoice Ninja is currently being written in a combination of Laravel for the API and Client Portal and Flutter for the front end management console. This will allow an immersive and consistent experience across any device: mobile, tablet or desktop.
To manage our workflow we will be creating separate branches for the client (Flutter) and server (Laravel API / Client Portal) and merge these into a release branch for deployments.