```
### 4.2 Dynamic Routes
For `src/routes/blog/[slug]/+page.server.ts`:
```ts
import { document } from '#contentrain'
import { error } from '@sveltejs/kit'
import type { PageServerLoad } from './$types'
export const load: PageServerLoad = ({ params }) => {
const post = document('blog-article').locale('en').bySlug(params.slug)
if (!post) throw error(404, 'Post not found')
return { post }
}
```
### 4.3 Layout Data
Provide global content (navigation, footer) from a layout load function:
```ts
// src/routes/+layout.server.ts
import { singleton, dictionary } from '#contentrain'
import type { LayoutServerLoad } from './$types'
export const load: LayoutServerLoad = () => {
const nav = singleton('navigation').locale('en').get()
const footerLabels = dictionary('footer-labels').locale('en').get()
return { nav, footerLabels }
}
```
### 4.4 API Routes
SDK works in SvelteKit API routes:
```ts
// src/routes/api/posts/+server.ts
import { query } from '#contentrain'
import { json } from '@sveltejs/kit'
export function GET() {
const posts = query('blog-post').locale('en').all()
return json(posts)
}
```
---
## 5. i18n Integration
### 5.1 Locale from Route Parameters
For `src/routes/[locale]/blog/+page.server.ts`:
```ts
import { query } from '#contentrain'
import type { PageServerLoad } from './$types'
export const load: PageServerLoad = ({ params }) => {
const posts = query('blog-post').locale(params.locale).sort('publishedAt', 'desc').all()
return { posts, locale: params.locale }
}
```
### 5.2 Locale from locals
Set locale in a hook and access it via `locals`:
```ts
// src/hooks.server.ts
import type { Handle } from '@sveltejs/kit'
export const handle: Handle = ({ event, resolve }) => {
const locale = event.params.locale ?? 'en'
event.locals.locale = locale
return resolve(event)
}
```
Then in load functions:
```ts
export const load: PageServerLoad = ({ locals }) => {
const posts = query('blog-post').locale(locals.locale).all()
return { posts }
}
```
### 5.3 With sveltekit-i18n or Paraglide
Contentrain dictionaries can supplement i18n libraries. Use `dictionary()` for content-driven strings and the i18n library for app-level translations, or use Contentrain as the single source for all strings.
### 5.4 Dictionary Strings in Components
```svelte
{data.labels.welcome_message}
```
---
## 6. Markdown and Document Content
### 6.1 Rendering Markdown
For document-kind entries with markdown bodies, use `mdsvex` or a markdown renderer:
```svelte
{data.post.title}
{@html data.post.bodyHtml}
```
### 6.2 mdsvex Integration
If using `mdsvex` for `.svelte.md` files, you can point it at Contentrain markdown content or use the SDK to load document metadata and render bodies separately.
---
## 7. Prerendering and Deployment
### 7.1 Static Pages
Mark pages for prerendering:
```ts
// src/routes/blog/+page.server.ts
export const prerender = true
```
Or prerender the entire site:
```ts
// src/routes/+layout.server.ts
export const prerender = true
```
### 7.2 Entry Generator
For dynamic routes, provide all possible parameter values:
```ts
// src/routes/blog/[slug]/+page.server.ts
import { query } from '#contentrain'
export const prerender = true
export function entries() {
const posts = query('blog-post').locale('en').all()
return posts.map(post => ({ slug: post.slug }))
}
```
### 7.3 Build and Deploy
```bash
npx vite build
```
Use the appropriate SvelteKit adapter for your platform (`adapter-static`, `adapter-vercel`, `adapter-netlify`, `adapter-cloudflare`).
### 7.4 Deployment Flow
1. Content changes are committed to Git via MCP tools.
2. Push triggers platform rebuild.
3. `vite build` runs, SDK reads `.contentrain/` content.
4. Static or server output is produced with embedded content.
---
## 8. Type Safety
The generated client provides full TypeScript types:
```ts
import { query } from '#contentrain'
// Fully typed — autocomplete for all fields
const posts = query('blog-post').locale('en').all()
posts[0].title // string
posts[0].author // Author type when using .include('author')
```
Keep the generator running in watch mode during development to stay in sync with model changes.