What names of .env files does SvelteKit support?

[vekunz]

The documentation of SvelteKit for the env key in the configuration says this to .env files:

dir — the directory to search for .env files.

It clearly says "files" in the plural form. But which files does this mean, since there cannot be multiple files with the same name in one folder? In our projects, we have a .env file and locally a .env.local file also. Does "files" mean that SvelteKit reads the .env.local file also? And if yes, which file overrides which file, if both files contain the same keys?

[j4w8n]

SvelteKit uses Vite's loadEnv() to load the files. Per the function here, it will read the following:

/** default file */ `.env`,
/** local file */ `.env.local`,
/** mode file */ `.env.${mode}`,
/** mode local file */ `.env.${mode}.local`

[j4w8n]

Based on the code, it processes the files in the above order. Therefore, for example, the value of key API_KEY in .env.local would override the same key in .env.

I have not tested this.