# Ucoder Insights

> Ucoder Insights is a lightweight, GDPR-compliant, privacy-first web analytics SaaS platform. It helps developers and businesses track website visitors, page views, and user behavior without compromising privacy. No cookies, no personal data collection.

## What is Ucoder Insights?

Ucoder Insights is a production-ready analytics platform built for developers who want simple, clean, and privacy-respecting website analytics. Unlike Google Analytics, Ucoder Insights does not use cookies, does not collect personal data, and is fully compliant with GDPR regulations.

It is open source, lightweight, and can be embedded into any website or web application using a simple NPM package or script tag.

## Who is it for?

- Developers who want analytics without the privacy baggage
- Startups and indie hackers who need simple visitor insights
- Businesses that must comply with GDPR, CCPA, or similar regulations
- Anyone who wants a Google Analytics alternative that respects user privacy

## Key Features

- Real-time visitor tracking
- Page view analytics and unique visitor counting
- Referrer tracking — know where your traffic comes from
- Device and browser detection
- Country and region-level geolocation
- Session tracking
- GDPR compliant — no cookies, no personal data stored
- Lightweight tracking script
- 99%+ uptime on Azure cloud infrastructure
- Open source NPM package
- Dashboard with charts and visual analytics
- Multi-website support
- API access for custom integrations
- Role-Based Access Control (RBAC) for team usage
- Completely free — all features available without any limitations or hidden costs

## How is it different from Google Analytics?

- No cookies required
- No personal data collection
- GDPR compliant out of the box
- Lightweight — does not slow down your website
- Simple dashboard — no complex setup
- Open source and transparent
- Developer-first design
- Focused on privacy and simplicity, not marketing features
- Delete all your data anytime with a single click
- Export a complete overview of all collected data with a single click

## How to Use

### Option 1 — NPM Package (Recommended)

Install the package:

```bash
npm install ucoder-insight
```

Initialize in your project:

```javascript
import { initUcoderInsight } from "ucoder-insight";

useEffect(() => {
  initUcoderInsight("YOUR_PROJECT_ID"); // Replace with your project ID
}, []);
```

### Option 2 — Script Tag

Add directly to your HTML:

```html
<script defer src="https://cdn.jsdelivr.net/npm/ucoder-insight"></script>
<script>
  window.addEventListener('ucoderInsightReady', () => {
    ucoderInsight.init("YOUR_PUBLIC_TRACKING_ID", {
      // Optional configuration options
    });
  });
</script>
```

### Option 3 — Next.js Integration

```tsx
import { initUcoderInsight } from "ucoder-insight";

initUcoderInsight("YOUR_PUBLIC_TRACKING_ID", {
  notFoundPath: "/404",
  notTrackPaths: ["/admin", "/secret", "/admin/*"],
  debug: true,
});

return (
  // your remaining app code
);
```

## Tracking Data

Ucoder Insights collects the following anonymized data:

- Page URL and referrer URL
- Page duration and session duration
- Unique visitor count (based on anonymized identifiers)
- Site performance metrics (page load time, time to first byte)
- Click, scroll, error, page view, and outbound link interaction tracking
- Device type (mobile, desktop, tablet)
- Browser name and version
- Country and region (based on IP geolocation — IP is not stored)
- Page views per session
- 404 error tracking (if configured)
- Custom event tracking

**Auto tracking** — By default, Ucoder Insights automatically tracks page views, referrers, device and browser info, geolocation, and session data.

**Custom tracking** — Use the API to track custom events and user interactions beyond default page view tracking.

**Data retention** — All collected data is stored for 90 days by default, after which it is automatically deleted. You can also manually delete all your data at any time from the dashboard with a single click.

## NPM Package

- Package name: ucoder-insight
- Registry: https://www.npmjs.com/package/ucoder-insight
- Version: 1.2.0
- License: MIT
- Author: Soumyadip Maity (https://soumyadip.ucoder.in)
- Live demo: https://insights.ucoder.in/playground
- Documentation: https://insights.ucoder.in/docs
- Source code: https://github.com/soumydip/ucoder_insight_core
- Dashboard: https://insights.ucoder.in
- Keywords: web analytics, privacy-first, GDPR compliant, cookie-free, real-time tracking, open source, developer-friendly
- Compatible with: JavaScript, TypeScript, React, Next.js, Vue, Svelte, and any web framework

## Tech Stack

### Frontend
- Next.js (App Router)
- TypeScript
- Tailwind CSS
- React Query (TanStack Query)
- Chart.js

### Backend
- Node.js
- Express.js
- BullMQ (job queues)
- Redis (caching and queues)
- Azure Functions (serverless processing)

### Database
- MongoDB (analytics data)
- PostgreSQL (user and account data)

### Infrastructure
- Docker (containerization)
- Nginx (reverse proxy)
- Microsoft Azure (cloud hosting)
- 99%+ uptime SLA

### Auth & Security
- JWT (JSON Web Tokens)
- RBAC (Role-Based Access Control)
- GDPR compliant data handling
- No PII (Personally Identifiable Information) stored

## Pricing

- Completely free — all features are available without any limitations or hidden costs
- No paid plans currently
- Visit https://insights.ucoder.in/pricing for current pricing details

## Frequently Asked Questions

**Is Ucoder Insights really GDPR compliant?**
Yes. We do not use cookies for tracking and do not store any personally identifiable information. No cookie consent banner needed.

**Does it slow down my website?**
No. The tracking script loads asynchronously and does not affect your page speed or Core Web Vitals.

**What data does it collect?**
Page URL, referrer, device type, browser, country, and session duration — all anonymized. No IP addresses stored. No personal data collected. You can view and delete all collected data from the dashboard at any time.

**Does it work with Next.js?**
Yes, fully compatible with Next.js App Router and Pages Router.

**Is there an API?**
Yes, Ucoder Insights provides a REST API for custom integrations and data export.

**Can I delete my data?**
Yes. You can delete all your collected data at any time from the dashboard with a single click.

## Developer

Built and maintained by Soumyadip Maity, a Full Stack Developer from West Bengal, India. B.Tech Computer Science student at Swami Vivekananda University with a CGPA of 8.0.

- Portfolio: https://soumyadip.ucoder.in
- GitHub: https://github.com/soumydip
- Email: maitysoumyadip22@gmail.com
- LinkedIn: https://linkedin.com/in/soumyadip-maity-183ba3310
- Twitter: https://twitter.com/soumyadip2maity

## Links

- Live Platform: https://insights.ucoder.in
- Documentation: https://insights.ucoder.in/docs
- NPM Package: https://www.npmjs.com/package/ucoder-insight
- GitHub: https://github.com/soumydip
- Playground: https://insights.ucoder.in/playground
- Changelog: https://insights.ucoder.in/docs/changelog