Site analytics setup.

File Structure

project-root/
├── src/
│   └── config.ts            # Feature toggles
└── .env                     # Environment variables

Setup Steps

1. Create an Umami Site

0. Open the Umami dashboard. If you do not have an account yet, sign up first.
1. Click Add website.
2. Fill in:
   • Name – e.g. Twilight Blog
   • Domain – your production domain
3. Click Save.
4. Press Edit to grab the Tracking code.
5. Open Settings → API Keys and copy the Key.
6. Create a local .env file and configure:

   UMAMI_API_KEY=your-key
   UMAMI_TRACKING_CODE=your-tracking-code

2. Display Statistics

In src/config.ts:

export const umamiConfig = {
    enabled: false, // Toggle Umami analytics
    baseUrl: "https://api.umami.is", // Keep default unless using a self-hosted URL
};

3. Deploy

1. Push code to GitHub (or your VCS of choice).
2. Choose a hosting platform for deployment, inject the .env values into environment variables, then start deploying.

Troubleshooting

Common Issues

1. Stats are missing
   • Double-check the tracking code and API key.
   • Ensure environment variables are imported before deployment.
2. Dev server fails to start
   • Verify required environment variables exist locally.
   • Reinstall dependencies if necessary.

Getting Help

Open an Issue in the project repository if you need assistance.