FlyonUI Starter Kit

Overview Building modern web interfaces often feels like a forced march toward JavaScript frameworks. Many developers just want the power of Laravel Blade templates without the overhead of React or Vue. The FlyonUI Starter Kit fills this gap. It provides a pre-configured environment that merges the elegance of Tailwind CSS with a robust set of FlyonUI components. This allows for a rich, interactive dashboard experience while keeping the backend logic strictly within PHP. Prerequisites To effectively use this kit, you should have a solid grasp of: - **Laravel 12**: Familiarity with routing, controllers, and Blade syntax. - **Tailwind CSS**: Understanding utility-first styling. - **Composer & NPM**: Essential for managing PHP dependencies and asset bundling. Key Libraries & Tools - **Laravel 12**: The core framework providing the application skeleton. - **FlyonUI**: A headless UI component library that uses Tailwind CSS classes to deliver components like modals, accordions, and tables. - **Tailwind CSS**: The underlying styling engine. - **Vite/NPM**: Handles the compilation of assets and integration of JavaScript functionality. Code Walkthrough Installation You can spin up a new project using the Laravel installer by targeting the specific repository. Use the following terminal command: ```bash laravel new my-app --github="LaravelDaily/flyonui-starter-kit" ``` The Frontend Architecture In the `resources/views/layouts/app.blade.php` file, you will notice that FlyonUI components are integrated directly via standard HTML classes. Unlike Headless UI, these feel more like Bootstrap in their simplicity. ```html <!-- Example of a FlyonUI Button in a Blade file --> <button class="btn btn-primary"> Click Me </button> ``` In the `dashboard.blade.php` file, the kit implements a multi-level navigation system using standard Blade directives and FlyonUI classes to handle state and visibility without custom JS scripts. Syntax Notes FlyonUI relies heavily on specific utility classes that resemble traditional CSS frameworks. For example, using `btn` and `btn-primary` triggers complex Tailwind CSS layers under the hood. It also utilizes a CDN-based JavaScript approach for interactive components by default, though you can migrate this to an NPM-managed workflow within `app.js`. Practical Examples This kit is perfect for **Internal Admin Panels** where developer speed is more critical than complex client-side state management. It is also an excellent choice for **SaaS MVPs** that need a professional look immediately upon registration without the complexity of an Inertia.js stack. Tips & Gotchas Be mindful of the JavaScript dependencies. While the CSS is pure Tailwind, some components like dropdowns require the FlyonUI JS script to function. If you notice UI elements not responding, check that the script is properly linked in your main layout file. Always refer to the FlyonUI documentation when extending the kit, as certain components require specific nested HTML structures to render correctly.