diff --git a/app/.env.example b/app/.env.example index 2a54579..92f3757 100644 --- a/app/.env.example +++ b/app/.env.example @@ -79,3 +79,12 @@ SMTP_SECURE=false SMTP_FROM= SMTP_REPLY_TO= APP_URL=http://localhost:3000 + +# ============================================ +# Analytics (optional) +# ============================================ +# Self-hosted Umami analytics. Set both to enable tracking. +# Privacy-friendly, GDPR-compliant, no cookies. +# https://umami.is/ +UMAMI_URL= +UMAMI_WEBSITE_ID= diff --git a/app/nuxt.config.ts b/app/nuxt.config.ts index fbcd504..f84ac79 100755 --- a/app/nuxt.config.ts +++ b/app/nuxt.config.ts @@ -146,6 +146,16 @@ export default defineNuxtConfig({ { rel: "icon", type: "image/png", href: "/favicon.png" }, { rel: "apple-touch-icon", href: "/icons/icon-192.png" }, ], + // Optional analytics - configured via UMAMI_URL and UMAMI_WEBSITE_ID env vars + script: process.env["UMAMI_URL"] && process.env["UMAMI_WEBSITE_ID"] + ? [ + { + src: process.env["UMAMI_URL"], + defer: true, + "data-website-id": process.env["UMAMI_WEBSITE_ID"], + }, + ] + : [], }, }, diff --git a/docs/ENVIRONMENTS.md b/docs/ENVIRONMENTS.md index c1fa01a..4b83171 100644 --- a/docs/ENVIRONMENTS.md +++ b/docs/ENVIRONMENTS.md @@ -115,13 +115,26 @@ volumes: ### Environment Variables -| Variable | Required | Default | Purpose | -| --------------- | ----------- | ----------------------- | --------------------------- | -| `DATABASE_URL` | No | `file:/data/db.sqlite` | Database path | -| `NODE_ENV` | No | `production` | Environment mode | -| `APP_URL` | Recommended | `http://localhost:3000` | Public URL for emails/links | -| `VOICE_ENABLED` | No | `true` | Enable voice input | -| `GROQ_API_KEY` | No | - | Voice transcription API | +| Variable | Required | Default | Purpose | +| ------------------- | ----------- | ----------------------- | ------------------------------------ | +| `DATABASE_URL` | No | `file:/data/db.sqlite` | Database path | +| `NODE_ENV` | No | `production` | Environment mode | +| `APP_URL` | Recommended | `http://localhost:3000` | Public URL for emails/links | +| `VOICE_ENABLED` | No | `true` | Enable voice input | +| `GROQ_API_KEY` | No | - | Voice transcription API | +| `UMAMI_URL` | No | - | Umami analytics script URL | +| `UMAMI_WEBSITE_ID` | No | - | Umami website ID for tracking | + +#### Analytics (Optional) + +To enable [Umami](https://umami.is/) analytics, set both environment variables: + +```bash +UMAMI_URL=https://your-umami-instance.com/script.js +UMAMI_WEBSITE_ID=your-website-uuid +``` + +This is optional and privacy-friendly — no data is collected unless you configure it. ---