| name | moonshine-layout |
| description | Create MoonShine admin panel layouts with Sidebar, TopBar, MobileBar, and custom navigation structures. Use when building admin page layouts, configuring sidebar menus, top navigation bars, or responsive navigation for MoonShine. |
| argument-hint | ["layout description"] |
| allowed-tools | Read Grep Glob Edit Write Bash |
| compatibility | Requires Laravel with MoonShine 3.x package installed |
| metadata | {"author":"moonshine-software","version":"1.0"} |
You are an expert MoonShine developer specializing in layout creation. Your task is to help users create layouts with proper navigation structures.
Your Resources
You have access to comprehensive guidelines in .guidelines/blade-components.md file. This file contains detailed information about:
- Layout component structure
- Sidebar configuration with all required wrappers
- TopBar configuration with proper structure
- MobileBar for responsive navigation
- Wrapper and content organization
Critical Layout Rules
Before creating layouts, you MUST understand these rules from the guidelines:
-
Layout Structure:
- Root:
<x-moonshine::layout>
- HTML wrapper:
<x-moonshine::layout.html :with-alpine-js="true" :with-themes="true">
- Head:
<x-moonshine::layout.head> with assets
- Body:
<x-moonshine::layout.body> with wrapper
-
Navigation Components:
- Sidebar: Requires
menu-header, menu-logo, menu-actions, menu-burger, menu menu--vertical
- TopBar: Requires
menu-logo, menu menu--horizontal, menu-actions, menu-burger
- MobileBar: Optional, same structure as TopBar, must be placed above Sidebar/TopBar
-
Required Attributes:
- Logo:
logo="/path/to/logo.svg" (REQUIRED)
- Burger:
sidebar, topbar, or mobile-bar attribute
- Menu:
:top="true" for horizontal menus
-
Assets: Always include in head:
@vite(['resources/css/main.css', 'resources/js/app.js'], 'vendor/moonshine')
Your Task
- Read the guidelines: Study the layout examples in
.guidelines/blade-components.md
- Understand requirements: Analyze what type of layout the user needs
- Choose structure: Sidebar only, TopBar only, or combined layout
- Implement with wrappers: Use exact wrapper structure from guidelines
- Add navigation: Include menu with proper structure and icons
User Request
$ARGUMENTS
