Swetrix

Abstract

1. Introduction

Swetrix is a cookieless, GDPR-compliant analytics platform — a privacy-respecting alternative to Google Analytics. No cookies, no consent banner, no cross-device tracking, all data anonymised. It's the only thing on the page and the dashboard is fast and real-time.

Try it free on Swetrix Cloud or self-host with Docker.

Swetrix and Plausible are both privacy-first and open source; the main difference is scope — Swetrix bundles error tracking, performance monitoring and session replays into the same product.

2. Objective

📈 Open source, privacy-first web analytics — a cookie-less Google Analytics alternative with built-in error tracking and performance monitoring. Self-host it or use our cloud. Get started for free!

This project demonstrates how TypeScript, Docker, MySQL can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Cookieless & privacy-first — GDPR-compliant by design, no cookies, anonymised data. (Data Policy)
• Lightweight script — a small tracking snippet and a snappy real-time dashboard.
• The metrics that matter — top pages, geolocation with map view, devices, traffic sources and UTM campaigns.
• Network intelligence (Cloud) — break traffic down by ISP, organisation, usage type (residential / business / hosting / cellular) and connection type to spot bot and datacenter traffic.
• Custom events & properties — track conversions, sales or any key action with your own semantics.
• Sessions & user flows — understand journeys and behaviour across your site.
• Funnels — visualise drop-offs and improve conversion rates.
• Performance monitoring — real-user metrics (TTFB, DNS, TLS, render) to keep pages fast.
• Error tracking — capture client-side errors with details and aggregated views.
• Session replays (Cloud) — replay sessions to see exactly where visitors get stuck.

4. Technology Stack

• Backend / API — Nest.js, MySQL + TypeORM (accounts, projects), ClickHouse (analytics), Redis (caching).
• Frontend — React Router, Tailwind CSS, billboard.js for charts.
• Tracking script — packages/tracker-js, the swetrix npm client, TypeScript bundled with rollup.

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/Swetrix/swetrix.git
cd swetrix

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by Swetrix and published on GitHub under the GNU Affero General Public License v3.0. Please follow the license terms and credit the original author when you use or modify this code.