Environment variable reference for all smart integrations

.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=