working on guidelines

Author: taylorotwell

.ai/fluxui-free/core.blade.php

@@ -1,3 +1,5 @@
+## Flux UI Free
+
 - This project is using the free edition of Flux UI. It has full access to the free components and variants, but does not have access to the Pro components.
 - Flux UI is a component library for Livewire. Flux is a robust, hand-crafted, UI component library for your Livewire applications. It's built using Tailwind CSS and provides a set of components that are easy to use and customize.
 - You should use Flux UI components when available.
@@ -8,7 +10,7 @@
     <flux:button variant="primary"/>
 </code-snippet>
 
-## Available Components
+### Available Components
 This is correct as of Boost installation, but there may be additional components within the codebase.
 
 <available-flux-components>

.ai/fluxui-pro/core.blade.php

@@ -1,3 +1,5 @@
+## Flux UI Pro
+
 - This project is using the Pro version of Flux UI. It has full access to the free components and variants, as well as full access to the Pro components and variants.
 - Flux UI is a component library for Livewire. Flux is a robust, hand-crafted, UI component library for your Livewire applications. It's built using Tailwind CSS and provides a set of components that are easy to use and customize.
 - You should use Flux UI components when available.
@@ -8,7 +10,7 @@
     <flux:button variant="primary"/>
 </code-snippet>
 
-## Available Components
+### Available Components
 This is correct as of Boost installation, but there may be additional components within the codebase.
 
 <available-flux-components>

.ai/folio/core.blade.php

@@ -1,25 +1,26 @@
+## Laravel Folio
 
-- Laravel Folio is a file based router. With Laravel Folio, a new route is creatted for every Blade file within the correct directory. i.e. `Pages` are usually in in `resources/views/pages/` and the file structure determines routes:
-- `pages/index.blade.php` → `/`
-- `pages/profile/index.blade.php` → `/profile`
-- `pages/auth/login.blade.php` → `/auth/login`
-- List available Folio routes using `php artisan folio:list` or using Boost's `list-routes` tool.
+- Laravel Folio is a file based router. With Laravel Folio, a new route is created for every Blade file within the configured Folio directory. For example, pages are usually in in `resources/views/pages/` and the file structure determines routes:
+    - `pages/index.blade.php` → `/`
+    - `pages/profile/index.blade.php` → `/profile`
+    - `pages/auth/login.blade.php` → `/auth/login`
+- You may list available Folio routes using `php artisan folio:list` or using Boost's `list-routes` tool.
 
-### Folio: New pages & routes
+### New Pages & Routes
 - Always create new `folio` pages and routes using `artisan folio:page [name]` following existing naming conventions.
 
 @verbatim
-<code-snippet name="Example folio:page commands for automatic routing" lang="shell">
+<code-snippet name="Example folio:page Commands for Automatic Routing" lang="shell">
     // Creates: resources/views/pages/products.blade.php → /products
     php artisan folio:page 'products'
 
-
     // Creates: resources/views/pages/products/[id].blade.php → /products/{id}
     php artisan folio:page 'products/[id]'
 </code-snippet>
 @endverbatim
 
-- Add a 'name' to each new Folio page at the very top of the file, so it has a named route available for other parts of the codebase to use.
+- Add a 'name' to each new Folio page at the very top of the file so it has a named route available for other parts of the codebase to use.
+
 @verbatim
 <code-snippet name="Adding named route to Folio page" lang="php">
 use function Laravel\Folio\name;
@@ -28,13 +29,12 @@
 </code-snippet>
 @endverbatim
 
-
-### Folio: Support & Docs
+### Support & Documentation
 - Folio supports: middleware, serving pages from multiple paths, subdomain routing, named routes, nested routes, index routes, route parameters, and route model binding.
 - If available, use Boost's `search-docs` tool to use Folio to its full potential and help the user effectively.
 
 @verbatim
-<code-snippet name="Folio middleware example" lang="php">
+<code-snippet name="Folio Middleware Example" lang="php">
 use function Laravel\Folio\{name, middleware};
 
 name('admin.products');