> **error-tracking-svelte** — chapter 179 of 200 in [PostHog/skills](https://skillsdocs.com/PostHog/skills).
>
> Book (all chapters, one file): https://skillsdocs.com/PostHog/skills.md
> Machine manifest: https://skillsdocs.com/PostHog/skills/.well-known/agent-skills/index.json
> Install the book: `npx skills add PostHog/skills`
> Upstream: https://github.com/PostHog/skills/blob/main/skills/posthog/error-tracking/skills/svelte/SKILL.md @ `main`
> Raw bytes, no header: https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/SKILL.md
> Base for relative paths: https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/
> Licence: MIT — https://spdx.org/licenses/MIT.html
>
> Bundled files (6), referenced from this skill's directory:
>   - `references/alerts.md` — https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/references/alerts.md
>   - `references/assigning-issues.md` — https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/references/assigning-issues.md
>   - `references/fingerprints.md` — https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/references/fingerprints.md
>   - `references/monitoring.md` — https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/references/monitoring.md
>   - `references/svelte.md` — https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/references/svelte.md
>   - `references/upload-source-maps.md` — https://raw.githubusercontent.com/PostHog/skills/main/skills/posthog/error-tracking/skills/svelte/references/upload-source-maps.md
>
> Content © its authors, served unmodified. Takedown: https://github.com/kyleledbetter/skillsdocs/issues/new?labels=takedown&title=Takedown+request

<!-- Verbatim upstream SKILL.md follows, YAML frontmatter included. -->

---
name: error-tracking-svelte
description: PostHog error tracking for Svelte
metadata:
  author: PostHog
  version: 1.9.4
---

# PostHog error tracking for Svelte

This skill helps you add PostHog error tracking to Svelte applications.

## Reference files

- `references/svelte.md` - Sveltekit error tracking installation - docs
- `references/fingerprints.md` - Fingerprints - docs
- `references/alerts.md` - Send error tracking alerts - docs
- `references/monitoring.md` - Monitor and search issues - docs
- `references/assigning-issues.md` - Assign issues to teammates - docs
- `references/upload-source-maps.md` - Upload source maps - docs

Consult the documentation for API details and framework-specific patterns.

## Key principles

- **Environment variables**: Always use environment variables for PostHog keys and host URLs. Never hardcode them.
- **Minimal changes**: Add error tracking alongside existing error handling. Don't replace or restructure existing error handling code.
- **Autocapture first**: Enable exception autocapture in the SDK initialization before adding manual captures.
- **Source maps**: Upload source maps so stack traces resolve to original source code, not minified bundles.
- **Manual capture for boundaries**: Use `captureException()` at error boundaries and catch blocks for errors that don't propagate to the global handler.

## Framework guidelines

- Set paths.relative to false in svelte.config.js — this is required for PostHog session replay to work correctly with SSR and is easy to miss
- Use the Svelte MCP server tools to check Svelte documentation (list-sections, get-documentation) and validate components (svelte-autofixer) — always run svelte-autofixer on new or modified .svelte files before finishing