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.

⭐6stars🔀0forks📁View on GitHub🕐Updated Dec 30, 2025

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.
namesveltekit-structure
# IMPORTANTKeep description on ONE line for Claude Code compatibility
descriptionSvelteKit 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

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 browser from $app/environment for client-only code
  • Last verified: 2025-01-11