Errors

No locale found

Paraglide JS was not able to resolve a locale. This can happen if:

1. Your strategy array is empty.

-strategy: []
+strategy: ["cookie", "baseLocale"]

2. You are using overwriteGetLocale() and overwriteSetLocale() but forgot to call them at the root/entrypoint of your app.

import { overwriteGetLocale, overwriteSetLocale } from "./paraglide/runtime.js";

// Call the overwrites before your app starts rendering.
overwriteGetLocale(() => "en");
overwriteSetLocale((locale) => console.log(`Set locale to ${locale}`));

// Your app rendering entrypoint.
export default function App() {
	return (
		<div>
			<p>Hello world</p>
		</div>
	);
}

3. You are using the url strategy but call messages outside of a request context.

strategy: ["url"]

// hello.ts
import { m } from "./paraglide/messages.js";

// 💥 there is no url in this context to retrieve
//    the locale from. 
console.log(m.hello()); 

Make sure to call messages within a request context that is set by the paraglideMiddleware:

// hello.ts
import { m } from "./paraglide/messages.js";

app.use(paraglideMiddleware)

// ✅ this will work
app.get("/", (req, res) => {
	console.log(m.hello());
});

4. You make API requests and only have strategy: ["url"] set.

Paraglide JS will only extract the locale from a URL if the request is a document request, indicated by Sec-Fetch-Dest: document to distinguish it from API requests.

Add cookie or baseLocale to your strategy array to ensure that the locale is always resolved in API requests as well.

-strategy: ["url"]
+strategy: ["url", "cookie", "baseLocale"]