Laravel Chart of Accounts

A comprehensive Chart of Accounts and full double-entry Accounting module for Laravel applications. Supports dual frontends (Inertia/React and Blade/Livewire), multi-currency, 10 financial reports, bank reconciliation, and a complete REST API.

Features

• ✅ Double-entry bookkeeping with journal entries and posting workflow
• ✅ Chart of Accounts with hierarchical tree structure
• ✅ Multi-currency support with exchange rates
• ✅ 10 Financial Reports: General Ledger, Trial Balance, Balance Sheet, Income Statement, Cash Flow, Aged Payables, Aged Receivables, Bank Book, Cash Book, Account Statement
• ✅ Bank Reconciliation with automated matching
• ✅ Dual Frontend: Inertia/React (default) or Blade/Livewire
• ✅ Full REST API with JSON resources
• ✅ 9 Artisan Commands for install, seed, sync, verify, health check
• ✅ Spatie Permission integration for role-based access control
• ✅ Accounting Periods with open/close/fiscal year workflow
• ✅ Cost Centers and Tax Codes/Rates
• ✅ Audit Logging for all accounting transactions

Requirements

• PHP ^8.2
• Laravel ^10.0 | ^11.0 | ^12.0 | ^13.0

Installation

Install via Composer:

composer require alimarchal/laravel-chart-of-accounts

Run the one-command installer (publishes migrations for this package and Spatie dependencies, runs them, seeds master data, and verifies):

php artisan accounting:install

Blade/Livewire apps (e.g. Jetstream Livewire): set ACCOUNTING_UI_DRIVER=blade in your .env before installing. Inertia/React apps: the default driver (inertia) works out of the box.

What accounting:install does automatically:

1. Publishes accounting migrations (--tag=accounting-migrations)
2. Publishes spatie/laravel-permission migrations (if not already present)
3. Publishes spatie/laravel-activitylog migrations (if not already present)
4. Runs php artisan migrate
5. Seeds all master data (account types, currencies, COA, permissions, tax codes, etc.)
6. Syncs database objects (functions, procedures)
7. Verifies the installation

After installation — grant access to your admin user:

// Add HasRoles trait to your User model (app/Models/User.php):
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use HasRoles;
    // ...
}

Then assign a role via tinker or a seeder:

php artisan tinker --execute 'App\Models\User::where("email", "admin@example.com")->first()->assignRole("super-admin");'

Available roles: super-admin (all access), admin, accountant, viewer.

Without assigning a role, users will receive a 403 Unauthorized when accessing accounting routes — this is intentional for security.

Manual step-by-step (if you prefer):

php artisan vendor:publish --tag=accounting-migrations
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
php artisan vendor:publish --provider="Spatie\Activitylog\ActivitylogServiceProvider" --tag="activitylog-migrations"
php artisan migrate
php artisan accounting:seed

Configuration

Publish the config file:

php artisan vendor:publish --tag=accounting-config

Key options in config/accounting.php:

return [
    // 'inertia' (default) or 'blade'
    'ui_driver' => env('ACCOUNTING_UI_DRIVER', 'inertia'),

    // Route prefix
    'route_prefix' => 'accounting',

    // Middleware applied to all accounting routes
    'middleware' => ['web', 'auth'],

    // Default currency
    'default_currency' => 'USD',

    // Enable/disable permission checks (requires spatie/laravel-permission)
    'use_permissions' => true,
];

Frontend Stack Selection

Inertia/React (default)

Install the required packages:

composer require inertiajs/inertia-laravel
npm install @inertiajs/react react react-dom

Publish JS pages:

php artisan vendor:publish --tag=accounting-js

Blade/Livewire

Set in your .env:

ACCOUNTING_UI_DRIVER=blade

Install Livewire:

composer require livewire/livewire

Publish views:

php artisan vendor:publish --tag=accounting-views

Artisan Commands

REST API

All API endpoints are prefixed with /api/accounting/v1.

Models

Permissions

When use_permissions is enabled, the package registers these Spatie permissions:

• accounting.view
• accounting.create
• accounting.edit
• accounting.delete
• accounting.post
• accounting.void
• accounting.reverse
• accounting.close-period
• accounting.reports

Assign them to roles via spatie/laravel-permission.

Testing

composer test

Or with PHPUnit:

vendor/bin/pest

Changelog

Please see CHANGELOG.md for recent changes.

License

The MIT License (MIT). Please see LICENSE for more information.