Skip to content

feat(website): add Umami analytics integration#30

Merged
AmElmo merged 1 commit intomainfrom
AmElmo/add-umami-analytics
Feb 23, 2026
Merged

feat(website): add Umami analytics integration#30
AmElmo merged 1 commit intomainfrom
AmElmo/add-umami-analytics

Conversation

@AmElmo
Copy link
Copy Markdown
Owner

@AmElmo AmElmo commented Feb 23, 2026

Summary

Add Umami analytics tracking to the documentation website. Integrates a custom Next.js app wrapper that loads the Umami tracking script on all pages.

Changes

  • website/pages/_app.tsx: Custom app component that injects Umami script using next/script with afterInteractive strategy. Only loads when both env vars are configured.
  • website/.env.example: Documents required environment variables (NEXT_PUBLIC_UMAMI_URL and NEXT_PUBLIC_UMAMI_WEBSITE_ID).

Users can enable analytics by creating website/.env.local with their Umami instance URL and website ID from the Umami dashboard.

Notes

  • Script gracefully skips loading if env vars are missing—the site works fine without analytics configured.
  • Uses Next.js best practices for script loading (next/script component vs raw <script> tags).

Add custom _app.tsx with next/script for Umami tracking.
Uses NEXT_PUBLIC_UMAMI_URL and NEXT_PUBLIC_UMAMI_WEBSITE_ID
environment variables so the script only loads when configured.
@vercel
Copy link
Copy Markdown

vercel Bot commented Feb 23, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec-wright Ready Ready Preview, Comment Feb 23, 2026 10:49am

@AmElmo AmElmo merged commit 34ecc1d into main Feb 23, 2026
10 checks passed
github-actions Bot pushed a commit that referenced this pull request Feb 23, 2026
## [3.6.0](v3.5.0...v3.6.0) (2026-02-23)

### Features

* **website:** add Umami analytics integration ([#30](#30)) ([34ecc1d](34ecc1d))
@github-actions
Copy link
Copy Markdown

🎉 This PR is included in version 3.6.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant