- What is Tomato Invoices and what does it add to Laravel?
- Tomato Invoices is a Laravel package for creating, managing, and tracking invoices in TomatoPHP and Filament admin panels. It covers clients, line items, taxes, totals, statuses, and PDF-ready output from a billing interface. It is aimed at Laravel applications that want invoice management without building the billing domain from scratch.
- How do I install tomatophp/tomato-invoices with Composer?
- Install it with Composer using composer require tomatophp/tomato-invoices, then follow the package documentation for any required config, assets, or migrations. Because v1.0.5 changes the products route, clear route and config caches after installation. Validate the install in a staging branch before using it in production.
- Which Laravel and PHP versions are supported by Tomato Invoices?
- The provided release context does not list exact Laravel and PHP version constraints, so check the package composer.json and README before installing. Confirm compatibility with your host application’s Laravel, PHP, and dependency versions. If constraints are missing or unclear, test the package in an isolated Laravel app first.
- Does Tomato Invoices integrate with Filament and TomatoPHP admin panels?
- Yes, the package is described as working in TomatoPHP and Filament admin panels for invoice billing workflows. Confirm the expected Filament version and panel setup in the package docs. If your app uses a different admin stack, verify the UI integration before adopting it.
- How do I create invoices with clients, line items, taxes, and totals?
- In the Filament or TomatoPHP admin interface, create an invoice, assign a client, add product or line items, and let the package calculate taxes and totals. Use invoice statuses to track progress through the billing workflow. Review the package docs for exact field names and any required configuration.
- Can Tomato Invoices generate PDF-ready invoice output?
- Tomato Invoices provides PDF-ready invoice output as part of its billing interface. Check the package documentation for the supported PDF rendering approach and any required configuration. Test a generated invoice with your real tax, currency, and line-item data before production.
- What changed in v1.0.5 and does it fix the products route?
- v1.0.5 is described as a narrow maintenance release that fixes the products route. The context does not include the root cause, affected versions, or regression test evidence, so review the repository changelog for details. Regression testing should focus on invoice creation and editing when product lookup is part of line-item entry.
- Will Tomato Invoices product routes conflict with my existing Laravel routes?
- The package registers product-related routes, and a products route fix can matter if your application already uses /products or resource routes. Compare php artisan route:list before and after installation or upgrade, and check route names, prefixes, and middleware. Also verify behavior with route:cache enabled.
- Can I use my existing product catalog with Tomato Invoices invoices?
- The package supports product-based invoice line items, but the context does not confirm whether it can reference an existing host product catalog instead of package-managed products. Verify this in the package models and docs before adopting it alongside an existing product system. If not supported, you may need custom integration or duplication.
- How should I test Tomato Invoices before deploying to production?
- Install v1.0.5 in staging, back up database and configuration, and run invoice workflow smoke tests: create invoice, add product line item, edit invoice, remove product, and recalculate taxes and totals. Compare registered routes before and after, especially product routes, and test route and config caching. Deploy during a normal release window after confirming migrations, config, and assets.