sveltekit-structure
SvelteKit structure guidance. Use for routing, layouts, error handling, and SSR. Covers file naming (+page vs +layout vs +server), nested layouts, error boundaries, and hydration.
When & Why to Use This Skill
This Claude skill provides expert guidance on SvelteKit project architecture, focusing on essential patterns for routing, nested layouts, and server-side rendering (SSR). It helps developers implement best practices for file naming conventions—such as +page, +layout, and +server—while ensuring robust error handling and efficient hydration management for modern web applications.
Use Cases
- Designing complex directory structures for SvelteKit projects using nested layouts and dynamic routing.
- Implementing API endpoints and server-side logic using +server.ts files within the route hierarchy.
- Setting up granular error boundaries with +error.svelte to improve application resilience and user experience.
- Optimizing performance by managing SSR and client-side hydration through environment-specific code execution.
- Standardizing project organization for teams to ensure consistent file naming and routing patterns.
| name | sveltekit-structure |
|---|---|
| # IMPORTANT | Keep description on ONE line for Claude Code compatibility |
| description | SvelteKit structure guidance. Use for routing, layouts, error handling, and SSR. Covers file naming (+page vs +layout vs +server), nested layouts, error boundaries, and hydration. |
SvelteKit Structure
Quick Start
File types: +page.svelte (page) | +layout.svelte (wrapper) |
+error.svelte (error boundary) | +server.ts (API endpoint)
Routes: src/routes/about/+page.svelte → /about |
src/routes/posts/[id]/+page.svelte → /posts/123
Layouts: Apply to all child routes. +layout.svelte at any level
wraps descendants.
Example
src/routes/
├── +layout.svelte # Root layout (all pages)
├── +page.svelte # Homepage /
├── about/+page.svelte # /about
└── dashboard/
├── +layout.svelte # Dashboard layout (dashboard pages only)
├── +page.svelte # /dashboard
└── settings/+page.svelte # /dashboard/settings
<!-- +layout.svelte -->
<script>
let { children } = $props();
</script>
<nav><!-- Navigation --></nav>
<main>{@render children()}</main>
<footer><!-- Footer --></footer>
Reference Files
- references/file-naming.md - File naming conventions
- references/layout-patterns.md - Nested layouts
- references/error-handling.md - Error boundary placement
- references/ssr-hydration.md - SSR and browser-only code
Notes
- Layouts must render
{@render children()}in Svelte 5 - Error boundaries (+error.svelte) must be above failing route
- Use
(groups)for layout organization without affecting URL - Check
browserfrom$app/environmentfor client-only code - Last verified: 2025-01-11