From 57ede8a707af6211d1b39a6dedcf86c3477d7d97 Mon Sep 17 00:00:00 2001
From: Anthony Ronning <101225832+AnthonyRonning@users.noreply.github.com>
Date: Sun, 14 Jun 2026 02:06:27 +0000
Subject: [PATCH] Document local OpenSecret API env

---
 .gitignore            |  1 +
 README.md             | 11 +++++++++--
 frontend/.env.example |  4 ++--
 3 files changed, 12 insertions(+), 4 deletions(-)

diff --git a/.gitignore b/.gitignore
index f43a6e0ea..d8903e8fb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,6 +12,7 @@ frontend/node_modules/
 .env.*.local
 .envrc
 .direnv/
+.local/
 *.key
 
 # IDE files
diff --git a/README.md b/README.md
index cd6952d83..ac1c9dd57 100644
--- a/README.md
+++ b/README.md
@@ -98,8 +98,15 @@ bun run dev
 bun tauri dev
 ```
 
-Expects a `VITE_OPEN_SECRET_API_URL` environment variable to be set. The public
-OpenSecret client id defaults to Maple's project id
+Expects a `VITE_OPEN_SECRET_API_URL` environment variable to be set. For local
+OpenSecret development, copy `frontend/.env.example` to `frontend/.env.local`
+and point it at the local API:
+
+```bash
+VITE_OPEN_SECRET_API_URL=http://127.0.0.1:3000
+```
+
+The public OpenSecret client id defaults to Maple's project id
 `ba5a14b5-d915-47b1-b7b1-afda52bc5fc6`, so `VITE_CLIENT_ID` is only needed to
 override the default. (See `.env.example`)
 
diff --git a/frontend/.env.example b/frontend/.env.example
index 0e58c8ddc..8dbf59d49 100644
--- a/frontend/.env.example
+++ b/frontend/.env.example
@@ -1,5 +1,5 @@
-VITE_OPEN_SECRET_API_URL=http://0.0.0.0:3000
 # Public OpenSecret project id. Optional; the app uses this value by default.
 VITE_CLIENT_ID=ba5a14b5-d915-47b1-b7b1-afda52bc5fc6
-#VITE_MAPLE_BILLING_API_URL=http://0.0.0.0:3001
+VITE_OPEN_SECRET_API_URL=http://127.0.0.1:3000
+#VITE_MAPLE_BILLING_API_URL=http://127.0.0.1:3001
 #VITE_DEV_MODEL_OVERRIDE=gpt-4o