- How do I install flatroy/nova-progressbar-field in my Laravel Nova app?
- Install it with Composer using composer require flatroy/nova-progressbar-field, then add the field class to the fields() method of a Nova resource. There are no migrations, service providers, or configuration files involved beyond Composer autoloading. Because it is a display-only Nova field, you can add it to one resource first and verify rendering before widening usage. Pin an explicit version such as 0.0.6 if you want to avoid unexpected changes from a 0.0.x minor bump.
- Does flatroy/nova-progressbar-field support Laravel Nova 4?
- Yes, the package is described as a Laravel Nova v4 progress bar field, so Nova 4 is the intended target. Nova is a commercial product versioned separately from Laravel, and field packages depend on Nova's internal field API. Check the composer.json requirement in the tagged release to confirm the exact Nova constraint before adopting it. If you are planning a Nova 5 upgrade, treat this dependency as gated on the maintainer following that major version.
- How do I change the progress bar color, label, and value formatting in a Nova resource?
- The field exposes configurable colors, labels, and value formatting, so you set these through the field's fluent methods when adding it to your resource's fields() array. Values are percentage-based, and the same field renders in index and detail views. Consult the README for the exact method names, because the field API is small but package-specific. Keep the configuration in the resource class so the presentation stays close to where the field is declared.
- Can I set a custom width for the progress bar field?
- Version 0.0.6 added an optional width parameter through a first-time contributor's pull request. The change is additive, so existing field definitions that omit width should render as before. You pass the width value when defining the field in the resource, but confirm in the source or README whether the value is a CSS length, a percentage, or a numeric column width. Because this is a 0.0.x release, pin the exact version rather than using a caret range.
- Is flatroy/nova-progressbar-field compatible with Nova 5?
- The package is documented as a Nova v4 field, and no Nova 5 support is stated in the available release context. Nova field packages commonly require rewrites across major versions because they hook into Nova's internal field API. Before any Nova 5 upgrade, verify the package's composer.json constraint and whether a compatible release exists. If not, plan to vendor the field or reimplement it, since it is a thin PHP field class plus a Vue component.
- How do I show a percentage progress bar in a Nova index view?
- Add the field to the resource's fields() method and ensure the underlying model attribute contains a percentage value. The package is built for percentage-based progress and renders in index and detail views. You can apply colors, labels, and value formatting to make the bar readable at a glance in a table. Because it is display-only, it cannot alter the stored value or trigger any background processing.
- Is the width parameter in 0.0.6 validated, or does it pass straight to an inline style?
- The available release information only says a custom width parameter was added; it does not describe validation or sanitisation. The safe assumption is to treat an arbitrary width value as a presentation concern and test it with the values you intend to use. Review the Vue component and PHP field class in the repository to see how width is bound to the element. If you accept user-supplied width values, validate them in your own application layer first.
- Does this package have tests or a CI workflow?
- The release notes are auto-generated changelog output and provide no evidence of automated verification, including for the new width path. The repository is the place to check for a test suite, a CI workflow, and whether it ran against pull request #4. Given the low-volume maintenance profile, assume manual verification is required before you rely on a new release. For a display-only field, a quick visual check in a staging Nova resource is usually sufficient.
- What is the risk of adopting a 0.0.x Nova field package?
- At 0.0.x, SemVer gives no stability signal and the maintainer can make breaking changes on any minor bump, so pin an exact version. This package also has a bus factor of one, with a single maintainer and a first external contribution in 0.0.6. The blast radius is low because the field has no persistence layer, migrations, or background processing, and it sits only in Nova's presentation tier. The main upgrade risk is coupling to Nova's proprietary field API, not the package touching your domain code.
- What are the alternatives if I want to remove this dependency?
- A progress bar field is roughly a PHP Field class plus a Vue component, so vendoring or reimplementing it in-house is realistic. Check whether Nova core or a better-maintained package already offers a progress-bar or badge-style field that covers your use case. Because the field is display-only, adoption and removal are reversible in a single commit, with the only durable artifact being a composer.json entry and lockfile pin. If you replace it, keep the percentage formatting logic in the resource so the rendered output stays consistent.