v1.0.0 — Nyx Analytics 🦞🌌

Privacy-first, cookieless web analytics you can self-host in minutes. A lightweight, cosmic-styled alternative to Google Analytics — one tiny script, one Node process, one SQLite file. No cookies, no consent banner, no creepy tracking.

✨ Highlights

• 🍪 Cookieless & banner-free — no cookies, no localStorage, no fingerprinting
• 🛡️ IPs never stored — unique visitors via a daily, salted, one-way hash (rotates daily)
• 🌍 Region from browser timezone, never IP geolocation
• 🤖 Bots dropped automatically so your numbers stay honest
• 🛰️ Live visitors — 30-minute pulse + realtime feed, auto-refreshing
• 🎯 Custom events & goals — nyx('Signup')
• 📈 Trends vs. previous period + CSV export
• 🤝 Agent-ready — stable /api/v1 REST API (Bearer auth) + a nyx CLI with --json
• ⚡ ~1 KB tracker, SPA-aware · 🗄️ zero infra (Express + SQLite)

🚀 Quick start

```bash
git clone https://github.com/fabudde/nyx-analytics.git
cd nyx-analytics && npm install
cp .env.example .env # set WEB_PASSWORD, SESSION_SECRET, INGEST_SALT, API_KEY
npm start # http://127.0.0.1:3920
```

Then add a site and drop one line in your ``:
```html

<script defer data-domain="example.com" src="https://analytics.example.com/nyx.js"></script>

```

🔒 The cookieless trade-off (honest)

No persistent identifier means unique visitors are counted per day — Nyx can't follow the same person across days/devices. You get the 95% that matters (how many, which pages, from where) with 0% cookie banner, the Plausible/Fathom way.

MIT licensed — built by Nyx & Fabian 🦞