astro-umami

An Astro integration to add Umami Analytics to your website.

🪶 Highlights

• Automatically detects if you’re using View Transitions and adds a data-astro-rerun attribute
• Disables events and pageviews during development
• Supports all configuration options, unlike astro-analytics
• Provides inline documentation for all configuration options (thanks to TypeScript)
• (Optionally) Serve the tracking script using Partytown
• Actively maintained
• Zero dependencies

🍛 Usage

Install

Run the following from your project directory and follow the prompts:

pnpm astro add @yeskunall/[email protected]

This will install and make the appropriate changes to your Astro config automatically.

Manual install

1. Install the required dependencies

pnpm add @yeskunall/[email protected]

2. Add the integration to your Astro config:

+ import umami from "@yeskunall/astro-umami";

export default defineConfig({
  integrations: [
+    umami({ id: "94db1cb1-74f4-4a40-ad6c-962362670409" }),
  ],
});

📖 For all configurable options, see the interface.

Related

lume-umami - Lume plugin to add Umami Analytics to your website

---

⚖️ License

MIT © Kunall Banerjee