README

The core UI engine for laranail/license-verifier — a generator that scaffolds owned, themeable preset packages (Blade, Livewire, Filament, Vue) into your app under your namespace, at your path, in the CSS framework you choose. The generated preset subclasses this core, so you own a tiny surface while the logic and updates live here.

Requires PHP ^8.4.1 || ^8.5 on Laravel ^13.

Install

Require the preset you want — each is its own package that pulls this core automatically:

composer require laranail/license-verifier-ui-blade   # or -livewire / -filament / -vue

Quick start

Generate your owned preset package, then render it:

php artisan laranail::license-verifier-ui.install blade

Answer the prompts (theme, composer name, namespace, path, register mode) and the generator writes a small, self-contained Composer package into your app — auto-discovered, ready to use:

@include('license-verifier-blade::license-form')

Full tour: Getting started.

Presets & themes

Four presets ship as sub-packages of this monorepo, each with ready-to-use theme variants:

unstyled is semantic HTML with .lv-* hook classes; custom is the same skeleton with TODO markers for your design system. See Themes.

Documentation

Full documentation is at opensource.simtabi.com/documentation/laranail/license-verifier-ui.

Guides

• Installation — requiring a preset + running the generator.
• Getting started — how it works, generate, and render.
• Configuration — generator defaults, generated config keys, validation.
• Architecture — core engine, generator, registry, base classes.
• Release — tag-driven monorepo releases and versioning policy.

Reference

• Generator commands — install / uninstall / list / doctor, prompts, flags, what gets generated.
• Themes — the theme matrix and how to add one.
• Blade preset — routes, controller, views, progressive-enhancement JS.
• Livewire preset — the activation-form + status-widget components.
• Filament preset — the panel plugin, page, and widget.
• Vue preset — the SFC, JSON endpoints, and Vite entry.

Project

• Changelog — release history.

Stability

Pre-1.0 (0.x) — the public API may change between minor versions. Pin a version before bumping.

Local development

This repo is a monorepo whose root is the core package; the preset packages live under presets/* as path sub-packages, and a single suite covers everything. Run it from the root:

composer test     # Pest
composer lint     # pint --test + phpstan + rector --dry-run

Sister packages

• laranail/license-verifier — the headless verification client these UIs front.
• laranail/license-kit — the self-hosted PASETO/Ed25519 licensing server (issuer + seat registry).
• laranail/product-updater — license-gated product updates.
• laranail/demo-mode — demo/sandbox restrictions for licensed products.

Community

• Issues — bugs and feature requests.

Contributing & security

Issues and PRs are welcome — see CONTRIBUTING.md. Report vulnerabilities per SECURITY.md (opensource@simtabi.com); participation follows the Code of Conduct.

License

MIT © Simtabi LLC. See LICENSE.