Search by

akaunting / laravel-apexcharts

denisdulicicuneytsenturk

ApexCharts package for Laravel

Package info

github.com/akaunting/laravel-apexcharts

pkg:composer/akaunting/laravel-apexcharts

Statistics

Installs: 429 746

Dependents: 0

Suggesters: 0

Stars: 84

Open Issues: 2

4.0.0 2026-05-17 19:32 UTC

This package is auto-updated.

Last update: 2026-11-16 23:30:10 UTC


README

Downloads Tests StyleCI License

This package allows you to generate modern and interactive charts using the ApexCharts library directly from Laravel without interacting with JavaScript, CSS, etc.

It covers all of the chart types and options available within the ApexCharts library.

Check out the Akaunting project to see it live.

Getting Started

1. Install

Run the following command:

composer require akaunting/laravel-apexcharts

2. Publish

Publish configuration

php artisan vendor:publish --tag=apexcharts

This also publishes ApexCharts to public/vendor/apexcharts. Re-publish it with --force after updating the package.

3. Configure

You can change the chart settings of your app from config/apexcharts.php file

The package ships with ApexCharts 4.7.0, the latest MIT licensed version. The @apexchartsScripts directive loads the published copy, or the same version from the CDN if it isn't published. If your document root is the project root instead of the public folder, change the script url:

'script' => [
    'file' => 'vendor/apexcharts/apexcharts.js',
    'url' => 'public/vendor/apexcharts/apexcharts.js',
    'cdn' => 'https://cdn.jsdelivr.net/npm/apexcharts@4.7.0/dist/apexcharts.min.js',
],

To use a newer ApexCharts version, set file to null and point cdn to that version, or set file and url to your own copy. Options without a dedicated setter can be passed with setOption():

$chart->setOption([
    'chart' => [
        'someNewOption' => true,
    ],
]);

Usage

Blade

Create an instance of the Chart class and set the data and options according to your needs.

use Akaunting\Apexcharts\Chart;

// ...

$chart = (new Chart)->setType('donut')
    ->setWidth('100%')
    ->setHeight(300)
    ->setLabels(['Sales', 'Deposit'])
    ->setDataset('Income by Category', 'donut', [1907, 1923]);

Then, include the JavaScript (on every page using charts).

<!-- layout.blade.php -->

<body>
    <!-- ... -->

    @apexchartsScripts
</body>

Finally, call the container and script method wherever you want to display the chart.

<!-- dashboard.blade.php -->

{!! $chart->container() !!}

{!! $chart->script() !!}

JavaScript Functions (Formatters)

Options like formatter expect a JavaScript function. Wrap it with Balping\JsonRaw\Raw so it is rendered as code instead of a string:

use Akaunting\Apexcharts\Chart;
use Balping\JsonRaw\Raw;

$chart = (new Chart)->setType('bar')
    ->setXaxisLabels([
        'formatter' => new Raw('function (value) { return value + "%"; }'),
    ])
    ->setTooltipY([
        'formatter' => new Raw('function (value) { return value + "%"; }'),
    ]);

Raw JavaScript only works with the Blade script() output. It can't be sent as JSON via toVue() / toJson(), so define formatters on the JavaScript side when using Vue.

Responsive

ApexCharts takes a list of breakpoints. Add one entry per breakpoint:

$chart = (new Chart)->setType('donut')
    ->addResponsive(480, [
        'chart' => ['width' => 200],
        'legend' => ['position' => 'bottom'],
    ])
    ->addResponsive(1024, [
        'chart' => ['width' => 400],
    ]);

// or set them all at once
$chart->setResponsive([
    ['breakpoint' => 480, 'options' => ['legend' => ['show' => false]]],
]);

Vue

If you're using Vue and Inertia, install Apexcharts and their Vue 3 adapter:

npm install --save apexcharts@4.7.0
npm install --save vue3-apexcharts@1.8.0

Later versions of both packages are not MIT licensed anymore. Check the ApexCharts license before upgrading.

// resources/js/app.js

import VueApexCharts from 'vue3-apexcharts';

createInertiaApp({
    // ...
    setup({el, App, props, plugin}) {
        return createApp({ render: () => h(App, props) })
            .use(VueApexCharts)
            .mount(el);
    },
});

Then, create a simple chart.vue component:

<!-- components/chart.vue -->

<template>
    <apexchart
        :id="chart.id"
        :key="chart.id"
        :type="chart.type"
        :width="chart.width"
        :height="chart.height"
        :series="chart.series"
        :options="chart.options"
    />
</template>

<script setup>
defineProps({
    chart: Object,
});
</script>

Create an instance of Chart and call toVue() before passing it to your page:

Route::get('dashboard', function () {
    $chart = (new Chart)->setType('...');

    return inertia('dashboard', [
        'chart' => $chart->toVue(),
    ]);
});

Finally, render the chart:

<!-- pages/dashboard.vue -->

<template>
    <Chart :chart="chart" />
</template>

<script setup>
import Chart from './components/chart.vue';

defineProps({
    chart: Object,
});
</script>

Testing

composer test

Changelog

Please see Releases for more information what has changed recently.

Contributing

Pull requests are more than welcome. You must follow the PSR coding standards.

Security

Please review our security policy on how to report security vulnerabilities.

Credits

License

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