- What is jonpurvis/flux-radial used for?
- It is a companion package for Flux UI that adds radial progress rings plus donut and pie charts styled to match Flux's look and feel. You use it to visualize percentages, goal completion, and simple proportional breakdowns directly in Blade and Livewire views. It is a presentation-level component package, so it renders UI rather than handling persistence or business logic.
- How do I install jonpurvis/flux-radial in a Laravel app?
- Install it with Composer using composer require jonpurvis/flux-radial. The package is auto-discovered through Laravel's package discovery mechanism, so you do not need to register a service provider manually. If the README documents publishable config or view files, publish them with the vendor:publish command. You will also need Flux UI installed, since radial is a companion to it.
- Does flux-radial work inside Livewire components?
- Yes. The charts render as Blade components, so they work inside Livewire components and re-render as part of the normal Livewire lifecycle. That means you can bind a percentage or dataset to a public property and have the ring or chart update when the value changes. Check the README for any notes on how the component behaves on re-render.
- Can I customize colors and size to match my theme?
- The package is designed to match Flux's styling and exposes options for adapting rings and charts to your own theme. Typical adjustments are colors, thickness or size, and labels, all documented in the README. Because Flux supports theming, matching dark mode and brand palettes usually means reusing the design tokens you already have.
- Which Laravel versions does jonpurvis/flux-radial support?
- Version 1.1.0 widened the Composer constraint to allow laravel/framework ^13.0 alongside the previously supported majors. Applications on Laravel 11 or 12 need no action, because the change is additive and the package's behavior is unchanged. If you are moving to Laravel 13, upgrade the package first so Composer can resolve both together.
- Is Laravel 13 support in flux-radial actually verified?
- Version 1.1.0 adds Laravel 13 support through a Composer constraint change, which is backward compatible and correctly released as a minor bump. Treat that as an assertion of compatibility rather than proof: check the repository's CI configuration to confirm the test suite really runs against 13.x. Pin a minor version and run a smoke test in your app after upgrading.
- Do I need Node or a JavaScript build step to use it?
- No. The package ships as a standard Laravel Composer dependency and renders through Blade components, so it fits into your existing toolchain without a separate runtime or asset pipeline. Any JavaScript and styling comes from Flux UI, which you would already have installed.
- Is flux-radial a replacement for Chart.js or other charting libraries?
- No. It is a focused presentation component for radial progress, donut, and pie visuals that match Flux styling, not a general-purpose charting engine. If you need axes, tooltips, animations, or large time-series datasets, use a dedicated charting library instead. Radial is the better fit when you want a small, theme-consistent indicator without extra dependencies.
- How do I test components that use flux-radial?
- Write feature tests that render the Blade or Livewire component and assert the rendered output or the values passed in, since the package adds no runtime of its own to mock. Because it is presentation-only, most of your testing effort belongs in verifying that the correct data reaches the component. If you render Flux components in tests, follow Flux's own testing guidance for your Laravel version.
- Is jonpurvis/flux-radial safe to use in production?
- It is architecturally low risk: it is a Composer package discovered by Laravel that inherits your application's container, config, and deployment topology rather than adding a service or datastore. The main consideration is maintenance continuity, since the package is maintained by a single author with no visible external contributor base yet. Pin a minor version, watch for releases, and smoke test after major Laravel upgrades.