Weave Code
Lararoi Laravel Package
aichadigital/lararoi
LaraROI is a Laravel package for measuring the return on investment of AI features. Track token usage and costs, attribute value or savings, and generate clear reports so you can see which AI integrations actually pay off, all through a simple, configurable API.
aichadigital/lararoi brings return-on-investment calculations to any Laravel application. It provides a clean, fluent API for modelling costs and returns, so you can compute ROI, profit margins and payback periods without scattering arithmetic across your codebase.
- Fluent ROI and profit helpers for any numeric input
- Configurable cost and revenue components
- Percentage and ratio outputs ready for reporting
- Framework-native design that fits Laravel conventions
- Lightweight, dependency-free core
Ideal for dashboards, campaign tracking and financial reporting where consistent ROI figures matter.
Frequently asked questions about Lararoi
- What is Lararoi and what does it do?
- Lararoi is a Laravel package by Aichadigital for measuring return on investment inside your applications. It provides a simple API to define investments and returns, calculate ROI metrics, and track profitability over time. The goal is to let you add financial insight to a Laravel project without building your own ROI math layer.
- How do I install aichadigital/lararoi with Composer?
- Install it with Composer using composer require aichadigital/lararoi. Because the public repository is a distribution mirror, make sure the package is reachable through Packagist or your own Composer repository configuration. After installation, check the package source for any service provider or configuration publishing steps, since the README excerpt is not included here.
- Which Laravel versions does Lararoi support?
- The exact Laravel and PHP version constraints are defined in the package's composer.json, so check that file or the Packagist listing before installing. There is no CI badge or public build matrix to rely on, because the mirror does not run CI. Confirm compatibility against your application's framework version rather than assuming it.
- Why is the GitHub repository read-only with no issues or pull requests?
- The public repository is a distribution mirror only. Development happens on gitlab.castris.com/aichadigital/lararoi, so issues, pull requests, and CI are intentionally disabled on the mirror. Treat the mirror as a place to download code, not as a place to contribute.
- Where do I report a bug or request a feature for Lararoi?
- Since the mirror accepts no issues or pull requests, any bug report or feature request needs to go through the upstream project at gitlab.castris.com/aichadigital/lararoi. Check that repository first to see whether the problem is already known. If you have a fix, propose it upstream rather than against the mirror.
- How do I define an investment and a return with Lararoi?
- Lararoi exposes a simple API for defining investments and the returns associated with them, which you then use to calculate ROI metrics. The exact method names and model structure come from the package source, so read the classes after installing. A typical flow is to record a cost, record the resulting revenue or benefit, and let the package compute the ratio.
- Can Lararoi track profitability over time?
- Yes, tracking profitability over time is part of the package's stated purpose. It is designed for measuring return on investment and following how that figure changes as new investments and returns are recorded. How granular the time series is depends on how you store and query the underlying records in your application.
- How should I test ROI calculations in my Laravel application?
- Write feature tests that create known investments and returns, then assert the computed ROI values against expected figures. Because the mirror provides no CI or test suite guarantees, you should not assume upstream coverage and should build your own regression tests. Use deterministic fixture data so rounding behaviour in the ratio calculations is predictable.
- Is Lararoi suitable for production use?
- The package is a focused utility for ROI calculation, but the read-only mirror has no public CI, no issue tracker, and no release automation signals, so evaluate it carefully. Pin the version in composer.json and review the source before deploying. If the package is central to financial reporting in your app, wrap it behind your own service layer so you can swap or patch it.
- What are the alternatives to Lararoi if it does not fit my needs?
- If you only need basic ROI math, a small custom service class or a generic finance or money library may be simpler than adding a dependency. Lararoi makes sense when you want Laravel-native handling of investments, returns, and profitability tracking out of the box. Compare against maintaining your own model layer before committing, especially given the limited public maintenance surface of the mirror.
Weaver
How can I help you explore Laravel packages today?