{"record":{"id":"b05a03efd769ad2a","repo":"sveltejs/kit","slug":"sveltejs-adapter-netlify-2-x-possibly-installe","errorCode":null,"errorMessage":"@sveltejs/adapter-netlify >=2.x (possibly installed through @sveltejs/adapter-auto) requires @sveltejs/kit version 1.5 or higher. Either downgrade the adapter or upgrade @sveltejs/kit","messagePattern":"@sveltejs/adapter-netlify >=2\\.x \\(possibly installed through @sveltejs/adapter-auto\\) requires @sveltejs/kit version 1\\.5 or higher\\. Either downgrade the adapter or upgrade @sveltejs/kit","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/adapter-netlify/index.js","lineNumber":40,"sourceCode":"const files = fileURLToPath(new URL('./files', import.meta.url).href);\n\nconst edge_set_in_env_var =\n\tprocess.env.NETLIFY_SVELTEKIT_USE_EDGE === 'true' ||\n\tprocess.env.NETLIFY_SVELTEKIT_USE_EDGE === '1';\n\nconst netlify_framework_config_path = '.netlify/v1/config.json';\nconst netlify_framework_serverless_path = '.netlify/v1/functions';\nconst netlify_framework_edge_path = '.netlify/v1/edge-functions';\n\nconst FUNCTION_PREFIX = 'sveltekit-';\n\n/** @type {typeof import('./index.js').default} */\nexport default function ({ split = false, edge = edge_set_in_env_var } = {}) {\n\treturn {\n\t\tname,\n\t\tasync adapt(builder) {\n\t\t\tif (!builder.routes) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t'@sveltejs/adapter-netlify >=2.x (possibly installed through @sveltejs/adapter-auto) requires @sveltejs/kit version 1.5 or higher. ' +\n\t\t\t\t\t\t'Either downgrade the adapter or upgrade @sveltejs/kit'\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (existsSync(`${builder.config.files.assets}/_headers`)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`The _headers file should be placed in the project root rather than the ${builder.config.files.assets} directory`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tif (existsSync(`${builder.config.files.assets}/_redirects`)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`The _redirects file should be placed in the project root rather than the ${builder.config.files.assets} directory`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst netlify_config = get_netlify_config();","sourceCodeStart":22,"sourceCodeEnd":58,"githubUrl":"https://github.com/sveltejs/kit/blob/03f1687fe612ce3d2d9131139b5b188d9cf90c64/packages/adapter-netlify/index.js#L22-L58","documentation":"adapter-netlify 2.x relies on builder.routes, which was added to @sveltejs/kit in version 1.5 to support Netlify's split/redirect configuration. When the adapter runs with an older kit that lacks builder.routes, it throws this compatibility error during adapt().","triggerScenarios":"Running `vite build` with @sveltejs/adapter-netlify >= 2.x installed (often transitively via adapter-auto) while @sveltejs/kit is pinned below 1.5.0.","commonSituations":"Projects upgrading the adapter (or adapter-auto pulling a newer adapter) without updating kit; lockfiles pinning old kit versions; npm/yarn resolution keeping an outdated kit.","solutions":["Upgrade @sveltejs/kit to >= 1.5.0: pnpm install -D @sveltejs/kit@latest","Delete the lockfile and reinstall to resolve a consistent kit/adapter pair","Alternatively downgrade adapter-netlify to 1.x if you cannot upgrade kit"],"exampleFix":"// before (package.json)\n\"@sveltejs/kit\": \"^1.0.0\",\n\"@sveltejs/adapter-netlify\": \"^2.0.0\"\n// after\n\"@sveltejs/kit\": \"^1.5.0\",\n\"@sveltejs/adapter-netlify\": \"^2.0.0\"","handlingStrategy":"validation","validationCode":"import { version } from '@sveltejs/kit';\nconst [maj, min] = version.split('.').map(Number);\nif (maj < 1 || (maj === 1 && min < 5)) throw new Error('adapter-netlify 2.x requires @sveltejs/kit >= 1.5');","typeGuard":null,"tryCatchPattern":"try {\n  await vite.build();\n} catch (e) {\n  if (e.message.includes('requires @sveltejs/kit version 1.5')) {\n    console.error('Upgrade @sveltejs/kit: pnpm install -D @sveltejs/kit@latest');\n  }\n  throw e;\n}","preventionTips":["Keep @sveltejs/kit and adapters in sync via a single lockfile","Check installed versions with `pnpm ls @sveltejs/kit @sveltejs/adapter-netlify` after upgrades","Use a semver range (^1.5.0) rather than a pinned old version"],"tags":["version-compatibility","netlify","build"],"backgroundTag":"peer-dependency-version-mismatch","analyzedSha":"03f1687fe612ce3d2d9131139b5b188d9cf90c64","analyzedAt":"2026-09-02T02:01:50.504Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-09T06:17:21.866Z"}