diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..e670cb0
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,14 @@
+# Copie este arquivo para .env.development.local e preencha os valores.
+# O arquivo .local é ignorado pelo git — nunca commitar credenciais reais.
+
+# URL base da API REST
+VITE_API_URL=https://sistema.modumfiscal.com.br
+
+# Keycloak
+VITE_KEYCLOAK_URL=https://keycloakprod.modumfiscal.com.br
+VITE_KEYCLOAK_REALM=modumfiscal-dev
+VITE_KEYCLOAK_CLIENT_ID=portal-modumfiscal-web
+
+# Mock — define como true para rodar sem backend (sessão e dados falsos)
+# Quando ativo, o bootstrapPrefeitura é pulado e o interceptor de mock é carregado.
+VITE_USE_MOCK=false