Weave Code
Kirana Laravel Package
kirana-style/kirana
Kirana is a Laravel/PHP package from kirana-style that offers a lightweight, straightforward way to add Kirana-style functionality to your application. It provides a clean integration point, simple setup, and a developer-friendly API for PHP and Laravel projects.
Kirana for server templates: the class map reader, a Blade directive for Laravel and a Twig function for Symfony.
Frequently asked questions about Kirana
- How do I install Kirana in a Laravel application?
- Install the package with Composer using kirana-style/kirana, then run the package's Artisan publish or install command to publish its config and assets. Kirana is built for Laravel Blade views and Tailwind CSS, so your app should already have a working Tailwind build. Check the README for the exact command name and supported Laravel versions before installing.
- Do I need to set up Tailwind CSS to use Kirana?
- Yes, Kirana's components are styled with Tailwind CSS, so your Laravel app needs a Tailwind build pipeline. The package's one-command setup publishes its config and assets, but you should confirm any Tailwind content paths or theme settings in the published files. This keeps component classes included in your compiled CSS.
- Can I customize Kirana's colors, spacing, and component views?
- Yes. Kirana is themeable, with colors and spacing controlled from a single theme file, and you can override component views. Publish the package files, edit the theme or published views, and keep your customizations in your app rather than modifying vendor files. Check the docs for the exact publish tags.
- Does Kirana support dark mode?
- Yes, every Kirana component ships with light and dark variants. You can use those variants in your Blade views without writing separate markup for each mode. Make sure your app's Tailwind dark mode configuration matches how you want to toggle themes.
- Are Kirana components accessible by default?
- Kirana includes ARIA attributes and keyboard support in its components by default. That helps with common accessibility needs in forms, modals, and navigation, but you should still test your final pages with your normal accessibility checks. Component defaults do not replace testing your specific content and interactions.
- What Blade components does Kirana include?
- Kirana provides ready-to-use components for forms, tables, modals, and navigation, styled with Tailwind CSS. You can drop them into any Blade view to build consistent interfaces without hand-writing all the markup and utility classes. The package is a component library, not a full admin panel or JavaScript framework.
- How do I override a Kirana component view?
- Use Laravel's standard vendor publish workflow to publish Kirana's views, then edit the copies in your application's resources/views/vendor directory. This lets you change markup while keeping the package's Blade component API. Confirm the package's publish tag in its documentation so you publish only the views you need.
- Is Kirana tested and safe to use in production?
- Kirana has Pest test coverage across its supported Laravel versions, and its components include accessibility and dark mode support. For production, review the published theme and assets, run your application's test suite, and confirm the supported Laravel and PHP versions in the package metadata. As with any UI package, test the exact component behavior in your app before release.
- Which Laravel versions does Kirana support?
- The package is tested with Pest across its supported Laravel versions, but the exact version range is defined in its composer.json and README. Check those files before installing to confirm compatibility with your app's Laravel and PHP versions. If you are on an older Laravel release, verify support rather than assuming it works.
- Can I use Kirana components in existing Blade views without rewriting my UI?
- Yes, Kirana is designed as a Blade component library you can drop into existing views. You can start with forms, tables, modals, or navigation and gradually replace hand-written Tailwind markup where it makes sense. Keep your app's layout and Tailwind setup, then customize the Kirana theme to match your design.
Weaver
How can I help you explore Laravel packages today?