From 81c0a8a971c2e6e82e6840199af4bc440586893e Mon Sep 17 00:00:00 2001
From: Linus Rath <139418639+rathlinus@users.noreply.github.com>
Date: Fri, 13 Mar 2026 19:18:55 +0100
Subject: [PATCH 1/2] chore: include .env.dev.example in .dockerignore

---
 .dockerignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.dockerignore b/.dockerignore
index 5f571036..35a0ac36 100644
--- a/.dockerignore
+++ b/.dockerignore
@@ -4,6 +4,7 @@ node_modules
 .gitignore
 .env*
 !.env.example
+!.env.dev.example
 .claude/
 scripts/
 TODO.md

From d49dcb52e6dbe1bfde28ea57bcc5f055581b10f8 Mon Sep 17 00:00:00 2001
From: Linus Rath <139418639+rathlinus@users.noreply.github.com>
Date: Fri, 13 Mar 2026 19:20:28 +0100
Subject: [PATCH 2/2] feat: add .env.dev.example for development configuration

---
 .env.dev.example | 49 ++++++++++++++++++++++++++++++++++++++++++++++++
 .gitignore       |  1 +
 2 files changed, 50 insertions(+)
 create mode 100644 .env.dev.example

diff --git a/.env.dev.example b/.env.dev.example
new file mode 100644
index 00000000..4ab88223
--- /dev/null
+++ b/.env.dev.example
@@ -0,0 +1,49 @@
+# Bulwark Webmail — Development Configuration
+# Copy this file to .env.local to run with the built-in mock JMAP server.
+# No external mail server required — great for UI development and testing.
+#
+# Usage:
+#   cp .env.dev.example .env.local
+#   npm run dev
+#   Open http://localhost:3000 — log in with any username/password.
+
+# =============================================================================
+# Mock JMAP Server
+# =============================================================================
+
+# Enable the built-in mock JMAP server (served at /api/dev-jmap)
+DEV_MOCK_JMAP=true
+
+# Point the app at its own mock endpoint.
+# IMPORTANT: This must match the origin the app runs on (default: port 3000).
+# Using a different port (e.g. 3001) will cause CORS errors.
+JMAP_SERVER_URL=/api/dev-jmap
+
+# =============================================================================
+# App
+# =============================================================================
+
+APP_NAME=Bulwark Webmail (Dev)
+
+# =============================================================================
+# Session & Settings Sync (optional for dev)
+# =============================================================================
+
+SESSION_SECRET=dev-secret-not-for-production
+SETTINGS_SYNC_ENABLED=true
+
+# =============================================================================
+# Logging (verbose for development)
+# =============================================================================
+
+LOG_FORMAT=text
+LOG_LEVEL=debug
+
+# =============================================================================
+# Login Page Customization (optional)
+# =============================================================================
+
+# LOGIN_COMPANY_NAME=Dev Team
+# LOGIN_IMPRINT_URL=https://example.com/imprint
+# LOGIN_PRIVACY_POLICY_URL=https://example.com/privacy
+# LOGIN_WEBSITE_URL=https://example.com
diff --git a/.gitignore b/.gitignore
index fd6cd363..22336596 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,6 +33,7 @@ yarn-error.log*
 # env files
 .env*
 !.env.example
+!.env.dev.example
 
 # vercel
 .vercel