/invoice-ninja

An open-source invoicing site built with Laravel

Primary LanguageJavaScriptOtherNOASSERTION

Invoice Ninja

Simple, Intuitive Invoicing

If you'd like to use our code to sell your own invoicing app get in touch.

Introduction

Most online invoicing sites are expensive. They shouldn't be. The aim of this project is to provide a free, open-source alternative. Additionally, the hope is the codebase will serve as a sample site for Laravel as well as other JavaScript technologies.

This guide is the simplest way to setup the site. The high level instructions for setting up the site using Git are below but there's also a more detailed setup guide. To deploy the app with Docker you can use this project.

To connect follow @invoiceninja or join the Facebook Group. For discussion of the code please use the Google Group.

If you'd like to translate the site please use caouecs/Laravel4-long for the starter files.

Site design by kantorp-wegl.in

Features

  • Core application built using Laravel 4.1
  • Invoice PDF generation directly in the browser
  • Integrates with many payment providers
  • Recurring invoices
  • Tax rates and payment terms
  • Multi-user support

Steps to setup

If you plan on submitting changes it's best to fork the repo, otherwise you can just checkout the code.

git clone https://github.com/hillelcoren/invoice-ninja.git ninja
cd ninja

Install Laravel packages using Composer

Note: you may be prompted for your Github user/pass due to their API limits.

composer install

Install JavaScript and HTML packages using Bower

bower install

Create the development environment configurations

mkdir app/config/development
cp app/config/app.php app/config/development/
cp app/config/database.php app/config/development/
cp app/config/mail.php app/config/development/

Create database user and a database for ninja

CREATE SCHEMA `ninja` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'ninja'@'localhost' IDENTIFIED BY 'ninja';
GRANT ALL PRIVILEGES ON `ninja`.* TO 'ninja'@'localhost';
FLUSH PRIVILEGES;

Configure development/config/database.php and development/config/mail.php and initialize the database.

php artisan migrate --seed

Add public/ to your web server root

Frameworks/Libraries

Ubuntu Notes

# Install php-mcrypt
apt-get install php5-mcrypt
sudo php5enmod mcrypt

# Install Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# Install Bower
sudo apt-get install npm nodejs-legacy
sudo npm install -g bower
sudo ln -s /usr/local/lib/node_modules/bower/bin/bower /usr/local/bin/bower