[bug] Better Auth addon generates legacy D1 binding access with SvelteKit 3 and Cloudflare adapter 8
Maintainers usually reply within 4 days
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 82/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- typescript
Research direction
Find the Better Auth addon template that generates src/hooks.server.ts for Cloudflare Workers and Drizzle D1. Start by searching the CLI templates for event.platform.env.DB and check how other Cloudflare templates access bindings. Update the generated hook to use the supported binding API, then verify a generated project starts and its routes return HTTP 200.
Written by the indexing model from the issue text.
Description
Describe the bug
When creating a new SvelteKit project using sv create with the Cloudflare Workers adapter, Drizzle (Cloudflare D1), and Better Auth (Email & Password) addons, the generated src/hooks.server.ts uses the legacy event.platform.env.DB API to access the D1 database binding.
With SvelteKit 3 and @sveltejs/adapter-cloudflare 8, Cloudflare-specific bindings are no longer exposed through event.platform.
As a result, the generated application fails with HTTP 500 errors during local development, even when the D1 binding is correctly configured.
Replacing event.platform.env.DB with env.DB imported from cloudflare:workers resolves the issue.
Steps to reproduce
-
Run:
npx [email protected] create -
Select the following options:
- Template:
SvelteKit minimal - TypeScript:
Yes - Adapter:
Cloudflare→Workers - Drizzle:
Cloudflare D1 - Better Auth:
Email & Password
- Template:
-
Configure the Cloudflare D1 binding and environment variables as instructed by the CLI.
-
Start the development server:
npm run dev -
Navigate to
http://localhost:5173/.
Actual behavior
The generated src/hooks.server.ts contains:
const handleBetterAuth: Handle = async ({ event, resolve }) => {
if (!event.platform?.env?.DB)
throw new Error('D1 binding "DB" not found - are you running with wrangler?');
event.locals.auth = createAuth(event.platform.env.DB);
// ...
};
The application throws the following runtime error:
Error: D1 binding "DB" not found - are you running with wrangler?
at handleBetterAuth (src/hooks.server.ts:23:9)
500 GET /
500 GET /favicon.ico
Expected behavior
The generated Better Auth integration should use the supported Cloudflare binding access API for SvelteKit 3 and @sveltejs/adapter-cloudflare 8.
A correctly configured project should start successfully without requiring manual modifications to the generated authentication hook.
Suggested fix
Import env directly from cloudflare:workers instead of accessing bindings through event.platform.env.
+ import { env } from 'cloudflare:workers';
const handleBetterAuth: Handle = async ({ event, resolve }) => {
- if (!event.platform?.env?.DB)
+ if (!env?.DB)
throw new Error('D1 binding "DB" not found - are you running with wrangler?');
- event.locals.auth = createAuth(event.platform.env.DB);
+ event.locals.auth = createAuth(env.DB);
// Remaining handler unchanged
};
After applying this change, the application successfully started, and the previously failing routes returned HTTP 200 instead of HTTP 500.
Environment
| Package | Version |
|---|---|
sv |
1.2.0 |
@sveltejs/kit |
3.1.1 |
@sveltejs/adapter-cloudflare |
8.0.2 |
better-auth |
1.7.16 |
| Database | Cloudflare D1 |
| ORM | Drizzle |
| Package manager | npm |
| OS | Windows (PowerShell) |
Additional context
The SvelteKit 3 migration guide documents the removal of Cloudflare-specific APIs from event.platform and recommends using imports from cloudflare:workers instead.
This appears to be a compatibility issue in the Svelte CLI Better Auth addon template when generating projects targeting SvelteKit 3 and Cloudflare Workers.
The addon template should be updated to generate the appropriate Cloudflare binding access code.
Note: The initial setup also reported a separate Drizzle schema mismatch involving missing Better Auth tables (user, session, account, and verification). This report specifically concerns the D1 binding access issue, which was resolved by the change described above.
- Dominant language
- TypeScript
- Stars
- 513
- Forks
- 110
- Avg merge
- 5d 1h
- Merged PRs (30d)
- 24
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from sveltejs/cli
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
Maintainers usually reply within 4 days
-
pkg:add
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
sveltejs/cli#1404 · 1 comment ·
Maintainers usually reply within 4 days
-
pkg:add
Difficulty 1/5 Under an hour Newbie friendliness 78/100
sveltejs/cli#1399 · 2 comments ·
Maintainers usually reply within 4 days
-
pkg:migrate
Difficulty 3/5 1-2 days Newbie friendliness 35/100
sveltejs/cli#1461 · 2 comments ·
Maintainers usually reply within 4 days
-
enhancement pkg:migrate
Difficulty 3/5 1-2 days Newbie friendliness 53/100
sveltejs/cli#1440 · 3 comments · 1 reaction ·
Maintainers usually reply within 4 days
Similar issues
-
[analytics-core] getQueryParams does not decode `+` as space and truncates values containing `=`Openbug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
amplitude/Amplitude-TypeScript#2179 · 1 comment ·
Maintainers usually reply within 2 days
-
ci good first issue severity: low
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
TMHSDigital/GH-Arcade#111 ·
-
AsnIntegerConverter.toASN coerces strings with +value, rounding integers outside safe-integer rangeOpen
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
PeculiarVentures/asn1-schema#189 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
anaisbetts/spawn-rx#38 ·