README

Larapex Charts is a Laravel wrapper for the ApexCharts JavaScript charting library.

This package is the gigerIT-maintained fork of arielmejiadev/larapex-charts. It continues the original package with ongoing maintenance, compatibility updates, code cleanups, optimizations, and support for current Laravel versions, including Laravel 13.

It is a drop-in replacement for the original package. Existing applications do not need code changes, namespace changes, config changes, or view changes. The public API, service provider, facade, publishable assets, and generated chart stubs remain compatible with the original package.

Check the upstream documentation on: Larapex Chart Docs.

About this fork

This fork keeps Larapex Charts usable in modern Laravel applications while preserving the original developer experience. The goal is to provide a reliable maintenance path for projects that already depend on Larapex Charts and for new projects that want the same simple chart-building API.

Maintained improvements include:

Laravel 13 compatibility, alongside the currently supported Laravel versions.
Composer metadata updates so the package can be installed as gigerit/larapex-charts from Packagist.
CI coverage for PHPUnit, PHPStan static analysis, and a Laravel/PHP compatibility matrix.
Package cleanups to remove generated files, IDE metadata, logs, test reports, and other local artifacts from distributed releases.
Repository and release hygiene improvements for cleaner installs and more predictable package archives.
Ongoing maintenance, fixes, and optimizations while keeping the package compatible with existing usage.

Drop-in replacement

Use this fork when you want a maintained version of Larapex Charts without rewriting existing application code.

If your application currently uses arielmejiadev/larapex-charts, replace the Composer dependency with this fork:

composer remove arielmejiadev/larapex-charts
composer require gigerit/larapex-charts

No PHP imports need to change. Continue using the existing namespace:

use ArielMejiaDev\LarapexCharts\Facades\LarapexChart;

The package also declares a Composer replacement for the original package name, so downstream packages that require arielmejiadev/larapex-charts can be satisfied by this fork.

Installation

Install the maintained fork with Composer:

composer require gigerit/larapex-charts

Usage

Basic example

In your controller add:

$chart = (new LarapexChart)->setTitle('Posts')
                   ->setDataset([150, 120])
                   ->setLabels(['Published', 'No Published']);

Remember to import the Facade to your controller with:

use ArielMejiaDev\LarapexCharts\Facades\LarapexChart;

Or importing the LarapexChart class:

use ArielMejiaDev\LarapexCharts\LarapexChart;

Then in your view (Blade file) add:

 <!doctype html>
 <html lang="en">
 <head>
     <meta charset="UTF-8">
     <meta name="viewport"
           content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
     <meta http-equiv="X-UA-Compatible" content="ie=edge">
     <title>Chart Sample</title>
 </head>
 <body>
 
     {!! $chart->container() !!}
 
     <script src="{{ $chart->cdn() }}"></script>
 
     {{ $chart->script() }}
 </body>
 </html>

More complex example

$chart = (new LarapexChart)->setType('area')
        ->setTitle('Total Users Monthly')
        ->setSubtitle('From January to March')
        ->setXAxis([
            'Jan', 'Feb', 'Mar'
        ])
        ->setDataset([
            [
                'name'  =>  'Active Users',
                'data'  =>  [250, 700, 1200]
            ]
        ]);

You can create a variety of charts including: Line, Area, Bar, Horizontal Bar, Heatmap, pie, donut and Radialbar.

More examples

Check the documentation on: Larapex Chart Docs

Laravel Boost

This package ships a Laravel Boost skill for AI-assisted development. When an application has both gigerit/larapex-charts and laravel/boost installed, Boost can discover the package skill from resources/boost/skills/larapex-charts-development/SKILL.md and install it for supported agents during php artisan boost:install or php artisan boost:update --discover.

Contributing

This fork is maintained by gigerIT. Contributions that improve compatibility, reliability, tests, documentation, or package hygiene are welcome.

Before submitting changes, run the test suite and static analysis:

composer test
composer test:types

The package was originally created by Ariel Mejia Dev. This fork preserves the original package API and credits while continuing maintenance for modern Laravel projects.

License

MIT

Roadmap for future versions

Add blade directive @apexchartscdn
Add blade directive @script($chart)
Expand setOptions() documentation with advanced ApexCharts examples
Continue modernizing internals while preserving the drop-in API
Add ReactJS + Inertia Support
Add More complex charts
Add More complex boilerplate code using Laravel/Prompts
Add more complex boilerplate code examples using Laravel Trends Package

gigerit/larapex-charts

包简介

关键字：

README 文档