Deploying to Netlify

Netlify is a first-class target for the SvelteKit starter: @sveltejs/adapter-auto detects Netlify and uses the Netlify adapter automatically.

1. Push the repo

Push your copy of the starter to GitHub (or GitLab/Bitbucket).

2. Create the site

In the Netlify dashboard, Add new site → Import an existing project, pick the repo. Netlify detects SvelteKit; the defaults (npm run build) are correct.

3. Set the environment variables

Set these under Site configuration → Environment variables before building — the starter reads them from $env/static/private, which is inlined at build time:

Variable	Value
AGILITY_GUID	Your instance GUID (Settings → API Keys)
AGILITY_API_FETCH_KEY	Fetch (live) API key
AGILITY_API_PREVIEW_KEY	Preview API key
AGILITY_SITEMAP	Sitemap/channel reference name (e.g. website)
AGILITY_LOCALES	Locale code (e.g. en-us)

Trigger the first deploy — the sitemap prerenders at build time.

4. Rebuild when editors publish

Published changes appear after a rebuild (the starter prerenders — see Routing & Sitemaps):

1. In Netlify: Site configuration → Build & deploy → Build hooks → add a hook and copy its URL.
2. In Agility: Settings → Webhooks → add a webhook on publish events pointing at the Build Hook URL.

Optional: pin the adapter

npm i -D @sveltejs/adapter-netlify@6

The starter uses SvelteKit 2. @sveltejs/adapter-netlify 7 and later require SvelteKit 3, so install version 6 until you upgrade the starter to SvelteKit 3.

// svelte.config.js
import adapter from '@sveltejs/adapter-netlify';
export default { kit: { adapter: adapter() } };

Preview mode note: the starter's preview toggle is for local dev. Production serves published content; review staged content locally with npm run dev, or stand up a second Netlify site built with the preview key.