From 2daf7f2d8e3b5e5a2e705b88b8ea866a3cd84883 Mon Sep 17 00:00:00 2001
From: iamdoubz <>
Date: Thu, 25 Jun 2026 14:21:17 -0500
Subject: [PATCH] Environment variable reference for all smart integrations

---
 .env.example | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 .env.example

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..fc94b37
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,45 @@
+# ── Stack Smart App Credentials ───────────────────────────────────────
+# Set these in .env.local (never commit .env.local).
+# Only needed for apps with `smart` config in src/lib/config.ts.
+
+# Portainer
+PORTAINER_URL=https://portainer.example.com
+PORTAINER_API_KEY=
+
+# Home Assistant
+HA_URL=https://ha.example.com
+HA_API_KEY=
+
+# Nextcloud
+NEXTCLOUD_URL=https://cloud.example.com
+NEXTCLOUD_USER=admin
+NEXTCLOUD_PASSWORD=
+
+# Paperless-ngx
+PAPERLESS_URL=https://paperless.example.com
+PAPERLESS_API_KEY=
+
+# Pi-hole (v6 — uses admin password, not the old API key)
+PIHOLE_URL=https://pihole.example.com
+PIHOLE_PASSWORD=
+
+# Plex
+PLEX_URL=https://
+PLEX_TOKEN=
+
+# Tautulli
+TAUTULLI_URL=https://
+TAUTULLI_API_KEY=
+
+# ── Interests / Social Feed ──────────────────────────────────────────
+# Only needed for platforms that require API keys.
+# Most platforms (GitHub, Mastodon, Bluesky, Reddit, Lemmy, PeerTube,
+# StackOverflow, Pixelfed, Misskey) work with just the username/instance
+# configured in src/lib/config.ts — no env vars needed.
+
+# X / Twitter (requires Basic API plan — $100/mo)
+TWITTER_BEARER_TOKEN=
+
+# Karakeep (self-hosted bookmarks)
+KARAKEEP_URL=https://karakeep.example.com
+KARAKEEP_API_KEY=