Config

Persistence

Defines the strategy for persisting locale state.

Note
Currently, Intor provides cookie-based persistence as the only mechanism for preserving locale state.
Locale cookies are disabled by default. Applications must explicitly enable them with cookie.enabled: true.

cookie

Defines how locale state is persisted via cookies.

defineIntorConfig({
  cookie: {...},
});

enabled

Whether to enable reading and writing the locale cookie.

Defaults to false

When disabled, Intor does not read existing locale cookies or write locale cookies on the first visit or when switching locales.

To persist the locale in a cookie, explicitly enable it:

defineIntorConfig({
  cookie: {
    enabled: true,
  },
});

name

The name of the cookie used to store locale state.

Defaults to "intor.locale"

defineIntorConfig({
  cookie: {
    enabled: true,
    name: "my-cookie-name",
  },
});

domain

The domain scope of the cookie.

Defaults to undefined

path

The path scope of the cookie.

Defaults to "/"

maxAge

The cookie lifetime, in seconds.

Defaults to undefined

httpOnly

Whether to restrict the cookie to HTTP(S) access only.

Defaults to false

secure

Whether the cookie is only sent over secure (HTTPS) connections.

Defaults to process.env.NODE_ENV !== "development"

sameSite

The SameSite policy of the cookie.

Defaults to "lax"