Global layout

app/layout.tsx owns the HTML element, body, global metadata, font class, and theme bootstrap script.

The bootstrap script reads localStorage before hydration so theme and primary color are applied early.

Dashboard layout

app/app/layout.tsx wraps all /app pages with AppShell.

AppShell provides sidebar navigation, topbar, mobile drawer, notifications, user menu, command search, and customizer.

Standalone layouts

Auth and misc pages do not use AppShell. They are standalone pages by design.

This keeps login, registration, verification, error, and maintenance pages visually independent from the dashboard workspace.