@yeskunall/astro-umami
Version:
Add Umami Analytics to your Astro website
54 lines (37 loc) • 2.26 kB
Markdown
# astro-umami
> An [Astro integration](https://docs.astro.build/en/guides/integrations-guide/) to add [Umami Analytics](https://umami.is/) to your website.
[](https://deepwiki.com/yeskunall/astro-umami)
[](https://github.com/yeskunall/astro-umami/actions/workflows/test.yml)
[](https://github.com/yeskunall/astro-umami/blob/main/license)
[](https://badge.fury.io/js/@yeskunall%2Fastro-umami)
## Highlights
- Automatically detects if you’re using [View Transitions](https://docs.astro.build/en/guides/view-transitions/) and adds a [`data-astro-rerun`](https://docs.astro.build/en/guides/view-transitions/#data-astro-rerun) attribute
- Disables events and pageviews during development
- Supports all [configuration](https://umami.is/docs/tracker-configuration) options, unlike [`astro-analytics`](https://github.com/Destiner/astro-analytics)
- Provides inline documentation for all configuration options (thanks to [TypeScript](https://github.com/yeskunall/astro-umami/blob/main/packages/astro-umami/src/index.ts#L7))
- (_Optionally_) Serve the tracking script using [Partytown](https://partytown.qwik.dev/) (v0.0.5 onwards)
- **Actively maintained**
- **Zero dependencies**
## Usage
### Install
Run the following from your project directory and follow the prompts:
```sh
pnpm astro add @yeskunall/astro-umami@0.0.8
```
This will install and make the appropriate changes to your Astro config automatically.
### Manual install
1. Install the required dependencies
```sh
pnpm add @yeskunall/astro-umami@0.0.8
```
2. Add the integration to your Astro config:
```diff
+ import umami from "@yeskunall/astro-umami";
export default defineConfig({
integrations: [
+ umami({ id: "94db1cb1-74f4-4a40-ad6c-962362670409" }),
],
});
```
###### For all configurable options, see the [interface](https://github.com/yeskunall/astro-umami/blob/main/packages/astro-umami/src/index.ts#L7).