fix(adapter-netlify)!: write output conforming to Netlify Frameworks API by serhalp · Pull Request #15294 · sveltejs/kit

serhalp · 2026-02-10T03:32:15Z

~~(Stacked on top of #15203)~~

The current implementation of the Netlify adapter writes output to paths and config files that are under-documented and in some cases entirely undocumented.

18 months ago, Netlify addressed this by releasing the stable, documented Netlify Frameworks API](https://docs.netlify.com/build/frameworks/frameworks-api/).

This PR migrates the adapter to write output that conforms to this spec.

POTENTIALLY BREAKING CHANGE: Deploying and previewing with Netlify CLI now requires v17.31.0 or later. Run npm i -g netlify-cli@latest to upgrade.

Please don't delete this checklist! Before submitting the PR, please make sure you do the following:

It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs
This message body should clearly illustrate what problems it solves.
Ideally, include a test that fails without this PR but passes with it.

Tests

Run the tests with pnpm test and lint the project with pnpm lint and pnpm check

Changesets

If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running pnpm changeset and following the prompts. Changesets that add features should be minor and those that fix bugs should be patch. Please prefix changeset messages with feat:, fix:, or chore:.

Edits

Please ensure that 'Allow edits from maintainers' is checked. PRs without this option may be closed.

The Netlify adapter now generates "v2" Netlify Functions, which uses modern standards (ESM, Request, Response) instead of the legacy "Lambda-compatible" or "v1" format. Under the hood, this greatly simplifies the adapter code and improves maintainability. See more details in this guide: https://developers.netlify.com/guides/migrating-to-the-modern-netlify-functions/. Some key changes: - The use of Request/Resonse eliminated the need for special header parsing, special multi-value handling header, base64 encoding of binary responses, and more. - Configuration of function routing directly in code eliminated the need for `_redirects` file generation. - As a bonus, this removes the limitation that users cannot specify redirects in `netlify.toml`. BREAKING CHANGES: - `platform.context` type changed to https://docs.netlify.com/build/functions/api/#netlify-specific-context-object

Co-authored-by: Ben McCann <[email protected]>

This reverts commit 0d14399.

changeset-bot · 2026-02-10T03:32:20Z

🦋 Changeset detected

Latest commit: 74f639b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@sveltejs/adapter-netlify	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

svelte-docs-bot · 2026-02-10T03:33:40Z

Preview: https://svelte-dev-git-preview-kit-15294-svelte.vercel.app/

Co-authored-by: Tee Ming <[email protected]>

…serhalp/sveltejs-kit into refactor/netlify-frameworks-api

teemingc · 2026-02-18T19:38:22Z

+# build output because the Netlify dev plugin doesn't currently detect it
 [functions]
-directory = ".netlify/functions-internal"
+directory = ".netlify/v1/functions"


@serhalp is there any way we could get the Netlify dev plugin to work with the Netlify framework API so we no longer need this hack? Currently, I don't think it picks up these directories or config.json

Yes, I'm working on it actually! I actually realized the issue is that @netlify/dev isn't quite designed yet for a preview/serve context. It doesn't scan output directories, only source.

Should we go ahead with this test workaround and leave a todo to remove this once @netlify/dev supports it?

Added a TODO comment regarding @netlify/dev compatibility with the Netlify frameworks API.

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to version-3, this PR will be updated. ⚠️

⚠️

⚠️ `version-3` is currently in **pre mode** so this branch has prereleases rather than normal releases. If you want to exit prereleases, run `changeset pre exit` on `version-3`. ⚠️

⚠️

⚠️ # Releases ## @sveltejs/[email protected] ### Major Changes - breaking: require SvelteKit 3 ([#15506](#15506)) ### Patch Changes - Updated dependencies [[`fa335bd`](fa335bd), [`3031d89`](3031d89), [`cb9d416`](cb9d416), [`caf3a18`](caf3a18), [`4777827`](4777827), [`a2792e2`](a2792e2), [`ba36148`](ba36148), [`48e8710`](48e8710), [`e2f3075`](e2f3075), [`047d6a0`](047d6a0), [`87603d1`](87603d1), [`096962c`](096962c), [`d545970`](d545970), [`e2f3075`](e2f3075), [`d06affc`](d06affc), [`8af47eb`](8af47eb), [`e2f3075`](e2f3075), [`5c4d130`](5c4d130), [`3f11f35`](3f11f35), [`caf3a18`](caf3a18), [`8823037`](8823037), [`1d76212`](1d76212), [`0dc0548`](0dc0548), [`00d81fa`](00d81fa)]: - @sveltejs/[email protected] ## @sveltejs/[email protected] ### Major Changes - breaking: upgrade `@cloudflare/workers-types` to 4.20260219.0 ([#15347](#15347)) - breaking: upgrade minimum `wrangler` version to ^4.67.0 ([#15347](#15347)) - breaking: remove `platform.context` in favour of `platform.ctx` ([#15347](#15347)) - breaking: require SvelteKit 3 ([#15506](#15506)) ### Patch Changes - chore: check the `WORKERS_CI` environment variable to determine if we're building for Cloudflare Workers ([#13733](#13733)) - Updated dependencies [[`fa335bd`](fa335bd), [`3031d89`](3031d89), [`cb9d416`](cb9d416), [`caf3a18`](caf3a18), [`4777827`](4777827), [`a2792e2`](a2792e2), [`ba36148`](ba36148), [`48e8710`](48e8710), [`e2f3075`](e2f3075), [`047d6a0`](047d6a0), [`87603d1`](87603d1), [`096962c`](096962c), [`d545970`](d545970), [`e2f3075`](e2f3075), [`d06affc`](d06affc), [`8af47eb`](8af47eb), [`e2f3075`](e2f3075), [`5c4d130`](5c4d130), [`3f11f35`](3f11f35), [`caf3a18`](caf3a18), [`8823037`](8823037), [`1d76212`](1d76212), [`0dc0548`](0dc0548), [`00d81fa`](00d81fa)]: - @sveltejs/[email protected] ## @sveltejs/[email protected] ### Major Changes - chore: use `rolldown` for edge function bundling ([#15432](#15432)) - breaking: write output that conforms to the stable [Netlify Frameworks API](https://docs.netlify.com/build/frameworks/frameworks-api/). ([#15294](#15294)) Deploying and previewing with Netlify CLI now requires [v17.31.0](https://github.com/netlify/cli/releases/tag/v17.31.0) or later. Run `npm i -g netlify-cli@latest` to upgrade. - breaking: require SvelteKit 3 ([#15506](#15506)) - breaking: edge function build target is now `es2022` ([#15432](#15432)) ### Patch Changes - Updated dependencies [[`fa335bd`](fa335bd), [`3031d89`](3031d89), [`cb9d416`](cb9d416), [`caf3a18`](caf3a18), [`4777827`](4777827), [`a2792e2`](a2792e2), [`ba36148`](ba36148), [`48e8710`](48e8710), [`e2f3075`](e2f3075), [`047d6a0`](047d6a0), [`87603d1`](87603d1), [`096962c`](096962c), [`d545970`](d545970), [`e2f3075`](e2f3075), [`d06affc`](d06affc), [`8af47eb`](8af47eb), [`e2f3075`](e2f3075), [`5c4d130`](5c4d130), [`3f11f35`](3f11f35), [`caf3a18`](caf3a18), [`8823037`](8823037), [`1d76212`](1d76212), [`0dc0548`](0dc0548), [`00d81fa`](00d81fa)]: - @sveltejs/[email protected] ## @sveltejs/[email protected] ### Major Changes - chore: migrate from rollup to rolldown ([#15297](#15297)) - breaking: require SvelteKit 3 ([#15506](#15506)) ### Patch Changes - Updated dependencies [[`fa335bd`](fa335bd), [`3031d89`](3031d89), [`cb9d416`](cb9d416), [`caf3a18`](caf3a18), [`4777827`](4777827), [`a2792e2`](a2792e2), [`ba36148`](ba36148), [`48e8710`](48e8710), [`e2f3075`](e2f3075), [`047d6a0`](047d6a0), [`87603d1`](87603d1), [`096962c`](096962c), [`d545970`](d545970), [`e2f3075`](e2f3075), [`d06affc`](d06affc), [`8af47eb`](8af47eb), [`e2f3075`](e2f3075), [`5c4d130`](5c4d130), [`3f11f35`](3f11f35), [`caf3a18`](caf3a18), [`8823037`](8823037), [`1d76212`](1d76212), [`0dc0548`](0dc0548), [`00d81fa`](00d81fa)]: - @sveltejs/[email protected] ## @sveltejs/[email protected] ### Major Changes - breaking: require SvelteKit 3 ([#15506](#15506)) ### Patch Changes - Updated dependencies [[`fa335bd`](fa335bd), [`3031d89`](3031d89), [`cb9d416`](cb9d416), [`caf3a18`](caf3a18), [`4777827`](4777827), [`a2792e2`](a2792e2), [`ba36148`](ba36148), [`48e8710`](48e8710), [`e2f3075`](e2f3075), [`047d6a0`](047d6a0), [`87603d1`](87603d1), [`096962c`](096962c), [`d545970`](d545970), [`e2f3075`](e2f3075), [`d06affc`](d06affc), [`8af47eb`](8af47eb), [`e2f3075`](e2f3075), [`5c4d130`](5c4d130), [`3f11f35`](3f11f35), [`caf3a18`](caf3a18), [`8823037`](8823037), [`1d76212`](1d76212), [`0dc0548`](0dc0548), [`00d81fa`](00d81fa)]: - @sveltejs/[email protected] ## @sveltejs/[email protected] ### Major Changes - chore: use `rolldown` for edge function bundling ([#15432](#15432)) - breaking: edge function build target is now `es2022` ([#15432](#15432)) ### Patch Changes - Updated dependencies [[`fa335bd`](fa335bd), [`3031d89`](3031d89), [`cb9d416`](cb9d416), [`caf3a18`](caf3a18), [`4777827`](4777827), [`a2792e2`](a2792e2), [`ba36148`](ba36148), [`48e8710`](48e8710), [`e2f3075`](e2f3075), [`047d6a0`](047d6a0), [`87603d1`](87603d1), [`096962c`](096962c), [`d545970`](d545970), [`e2f3075`](e2f3075), [`d06affc`](d06affc), [`8af47eb`](8af47eb), [`e2f3075`](e2f3075), [`5c4d130`](5c4d130), [`3f11f35`](3f11f35), [`caf3a18`](caf3a18), [`8823037`](8823037), [`1d76212`](1d76212), [`0dc0548`](0dc0548), [`00d81fa`](00d81fa)]: - @sveltejs/[email protected] ## @sveltejs/[email protected] ### Major Changes - breaking: require Node 22 or newer ([#12548](#12548)) ### Minor Changes - breaking: require Vite 8 and `vite-plugin-svelte` 7 ([#15542](#15542)) ## @sveltejs/[email protected] ### Major Changes - breaking: TypeScript 6 is now the minimum required version ([#15930](#15930)) - breaking: upgrade to cookie v1. Cookie names must now contain only ASCII characters ([#13386](#13386)) - breaking: require Node 22 or newer ([#12548](#12548)) - breaking: remove the `preloadStrategy` option. `modulepreload` will always be used ([#15256](#15256)) - breaking: default the cookie `path` option to `'/'` ([#15398](#15398)) - breaking: remove `@sveltejs/kit/node/polyfills` ([#15430](#15430)) - breaking: add `config.kit.output.linkHeaderPreload` to preload using the `Link` header ([#15939](#15939)) - breaking: require `@sveltejs/vite-plugin-svelte` v7 ([#15371](#15371)) - breaking: remove `createEntries` from the `Builder` object passed to adapter functions ([#15509](#15509)) - breaking: remove the deprecated CSRF `checkOrigin` option in favor of `trustedOrigins` ([#15437](#15437)) - breaking: the `delta` property now only exists for `popstate` navigation events ([#15522](#15522)) - breaking: remove deprecated `pragma` header in version polling for improved CORS support ([#15428](#15428)) - breaking: require Svelte 5.48.0 or newer ([#15371](#15371)) - chore: change `error`, `isHttpError`, `redirect`, and `isRedirect` to refer to public type instead of internal class ([#15250](#15250)) - breaking: require Vite 8. Provides new functionality even for existing Vite 8 users such as faster builds with Vite hook filters and more powerful SvelteKit adapters with the Vite environment API ([#15371](#15371)) - breaking: remove `data-sveltekit-*` option `'off'` in favour of `false` ([#15907](#15907)) ### Minor Changes - feat: resolve paths using the Vite config `root` option instead of `process.cwd()` to better support monorepo configurations such as Vitest workspaces ([#15469](#15469)) - chore: deprecate `Response` helpers in favor of platform-provided alternatives ([#15448](#15448)) - feat: explicit env vars ([#15934](#15934)) ### Patch Changes - fix: remove check for svelte.config.js before running `sync` ([#15946](#15946)) - fix: generate a placeholder tsconfig.json to squelch sync-time warnings ([#15948](#15948)) - chore: remove dependency on kleur ([#12548](#12548)) - chore: remove dependency on `set-cookie-parser` ([#15384](#15384)) - fix: allow use of `$app/env/public` in service workers ([#15950](#15950)) ## @sveltejs/[email protected] ### Major Changes - breaking: require Node 22 or newer ([#12548](#12548)) ### Patch Changes - chore: remove dependency on kleur ([#12548](#12548)) Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

serhalp and others added 15 commits January 24, 2026 21:20

there are no unit tests anymore

0d14399

chore: better changesets

324129f

fix: exclude special .netlify/ path from generated function

312d3bf

Apply suggestion from @benmccann

3f81780

Co-authored-by: Ben McCann <[email protected]>

Apply suggestion from @benmccann

600efd1

Co-authored-by: Ben McCann <[email protected]>

Merge branch 'main' into refactor/netlify-functions-v2

afa9a10

add ambient types

4d06096

bump peer version of kit

ed8bc9d

chores

01184a9

fix: use modern, documented Netlify Frameworks API

12234c9

refactor: extract utils from adapter-netlify/index.js

85e7010

test: add some unit tests for adapter-netlify utils

47cac99

Revert "there are no unit tests anymore"

45348b4

This reverts commit 0d14399.

chore: add changeset

278ab1c

serhalp changed the title ~~fix(adapter-netlify)!: write output conforming to the documented Netlify Frameworks API~~ fix(adapter-netlify)!: write output conforming to Netlify Frameworks API Feb 10, 2026

serhalp commented Feb 10, 2026

View reviewed changes

Comment thread packages/adapter-netlify/index.js

fix: fix bad rebase

7039e2e

benmccann added the pkg:adapter-netlify label Feb 10, 2026

Merge branch 'main' into refactor/netlify-frameworks-api

ca0a9eb

teemingc reviewed Feb 12, 2026

View reviewed changes

Comment thread .changeset/fine-ghosts-camp.md Outdated

teemingc reviewed Feb 12, 2026

View reviewed changes

Comment thread .changeset/fine-ghosts-camp.md Outdated

teemingc and others added 3 commits February 13, 2026 02:31

Merge branch 'main' into refactor/netlify-frameworks-api

c6bbe95

Merge branch 'main' into refactor/netlify-frameworks-api

f5b01e3

Apply suggestions from code review

e29d240

Co-authored-by: Tee Ming <[email protected]>

teemingc mentioned this pull request Feb 18, 2026

fix: export Netlify config separately from the serverless function #15335

Merged

6 tasks

teemingc added 2 commits February 19, 2026 01:38

Merge branch 'main' into refactor/netlify-frameworks-api

2d31712

Merge branch 'main' into refactor/netlify-frameworks-api

832c45a

teemingc added 7 commits February 19, 2026 03:10

Merge branch 'main' into refactor/netlify-frameworks-api

e21558e

fix tests

2f22b89

Merge branch 'refactor/netlify-frameworks-api' of https://github.com/…

12164d9

…serhalp/sveltejs-kit into refactor/netlify-frameworks-api

Merge branch 'main' into refactor/netlify-frameworks-api

be919e6

fix lockfile

9871ba2

Merge branch 'main' into refactor/netlify-frameworks-api

03faae0

fix split test app

c3db1e4

teemingc reviewed Feb 18, 2026

View reviewed changes

teemingc mentioned this pull request Feb 18, 2026

fix: generate edge middleware to run reroute #12296

Draft

12 tasks

Merge branch 'main' into refactor/netlify-frameworks-api

4cc45b5

teemingc changed the base branch from main to version-3 February 20, 2026 14:26

teemingc marked this pull request as ready for review February 20, 2026 14:27

teemingc approved these changes Feb 20, 2026

View reviewed changes

teemingc added 3 commits February 20, 2026 22:28

Update netlify.toml

0250cbe

Update netlify.toml

34064f6

Add TODO comment for Netlify dev plugin issue

74f639b

Added a TODO comment regarding @netlify/dev compatibility with the Netlify frameworks API.

teemingc merged commit 0a194a0 into sveltejs:version-3 Feb 20, 2026
19 checks passed

github-actions Bot mentioned this pull request Feb 20, 2026

Version Packages (next) #15311

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

fix(adapter-netlify)!: write output conforming to Netlify Frameworks API#15294

fix(adapter-netlify)!: write output conforming to Netlify Frameworks API#15294
teemingc merged 33 commits into
sveltejs:version-3from
serhalp:refactor/netlify-frameworks-api

serhalp commented Feb 10, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Feb 10, 2026 •

edited

Loading

Uh oh!

svelte-docs-bot Bot commented Feb 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

teemingc Feb 18, 2026

Uh oh!

serhalp Feb 19, 2026

Uh oh!

teemingc Feb 19, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Uh oh!

Conversation

serhalp commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Please don't delete this checklist! Before submitting the PR, please make sure you do the following:

Tests

Changesets

Edits

Uh oh!

changeset-bot Bot commented Feb 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

svelte-docs-bot Bot commented Feb 10, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

teemingc Feb 18, 2026

Choose a reason for hiding this comment

Uh oh!

serhalp Feb 19, 2026

Choose a reason for hiding this comment

Uh oh!

teemingc Feb 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

serhalp commented Feb 10, 2026 •

edited

Loading

changeset-bot Bot commented Feb 10, 2026 •

edited

Loading

teemingc Feb 19, 2026 •

edited

Loading