birdycom / omniaui-blade-starter-kit

dev-main 2026-11-10 19:20 UTC

Requires

• php: ^8.3
• birdycom/omniaui-laravel: ^0.15.1
• laravel/chisel: ^0.1.0
• laravel/fortify: ^1.37.2
• laravel/framework: ^13.17
• laravel/tinker: ^3.0

Requires (Dev)

• fakerphp/faker: ^1.24
• larastan/larastan: ^3.9
• laravel/pail: ^1.2.5
• laravel/pao: ^1.0.6
• laravel/pint: ^1.27
• laravel/sail: ^1.53
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.9.3
• phpunit/phpunit: ^12.5.23

MIT

• laravel
• blade
• starter-kit
• omniacss
• omniaui

Published on Packagist.org on 2026-11-10 19:20 UTC

README

A Laravel 13 starter kit in plain Blade, built with OmniaCSS and OmniaUI instead of Tailwind. The features of Laravel's official Livewire kit, on Fortify, with plain controllers and forms: no Livewire, no SPA. Alpine.js handles the few interactive bits (passkeys, copy buttons).

• Log in, register, forgot / reset password, email verification, password confirmation
• Two-factor authentication (QR code, setup key, recovery codes) and passkeys
• Settings: profile, password, two-factor, passkeys, appearance (light / dark / system), delete account
• An app shell with a collapsible sidebar (a sheet on phones), a top-bar layout, and three auth layouts (simple, card, split)
• A dashboard made of free OmniaUI components: KPI tiles, an SVG line chart, status rows and a table

laravel new my-app --using=birdycom/omniaui-blade-starter-kit
cd my-app && composer run dev

How the styling works

• resources/css/app.css has two directives: @omniaui; (the OmniaUI components) and @omnia; (the OmniaCSS utilities). The PostCSS plugin replaces them with only the CSS your views use. The whole kit ships about 56 kB of CSS (11 kB gzip), components included.
• postcss.config.js scans resources/views and the OmniaUI Blade components your views use (<x-oc::button> …).
• Colors, radius and fonts are theme tokens: override them in resources/css/theme.css. Every component follows light and dark mode through light-dark(); Settings > Appearance stores the choice as data-theme on <html>.
• resources/css/layout.css holds the few layout rules of the kit itself (auth column, settings grid …).

Components

The views use the Blade components of birdycom/omniaui-laravel (<x-oc::…>). Modals are native <dialog> elements opened with command="show-modal". Add more with npx omniaui add <name> --framework blade, or copy the HTML of any component from omniaui.eu.

OmniaUI Pro blocks (CMS dashboard, charts, kanban …) work in this kit too once you have a license: install birdycom/omniaui-pro-laravel and they appear in the same @omniaui; build.

Icons

The icons are the OmniaCSS webicons, drawn by the iconify-icon web component. These Iconify sets are installed: Material Design Icons (mdi:), MDI Light (mdi-light:), Material Symbols (material-symbols:), SVG Spinners (svg-spinners:), Flags (flag:) and VSCode Icons (vscode-icons:). Write <x-icon name="mdi:cog-outline" /> (resources/views/components/icon.blade.php) anywhere in resources/; vite-icons.js finds every <set>:<name> and bundles only those icons, so the app never calls the Iconify API. Size an icon with classes (h-1 w-1), the default is 1.25rem. Find names on https://omniaui.eu/ui/webicons.

AI assistants

The kit is written so assistants can extend it without falling back to Tailwind:

claude mcp add omniacss -- npx -y @birdycom/omniacss-mcp

The MCP server checks every class and gives the reference markup of every component. Without MCP, point your assistant at https://omniacss.eu/llms.txt and https://omniaui.eu/llms.txt.

License

MIT. Based on the MIT-licensed laravel/livewire-starter-kit; the settings pages are rewritten as controllers.