A micro-analytics JavaScript SDK that developers can drop into any website.
- 🚀 Micro SDK: < 2KB gzip, framework-agnostic
- 📦 Tree-shakable: ESM + UMD bundles
- ⚡ Zero dependencies: Pure JavaScript
- 🔧 TypeScript: Full type support
- 🎯 Simple API: Just 3 functions -
init(),trackPageview(),track() - 🔌 Next.js adapter: Drop-in component for automatic page tracking
npm install better-analyticsimport { init, track, trackPageview } from 'better-analytics';
// Initialize with your endpoint
init({ endpoint: 'https://your-api.com/collect' });
// Track custom events
track('button_click', { button: 'signup' });
// Manual page view tracking
trackPageview();npm install better-analytics// app/layout.tsx
import { Analytics } from 'better-analytics/next';
export default function RootLayout({ children }) {
return (
<html>
<body>
<Analytics api="/api/collect" />
{children}
</body>
</html>
);
}Or using the endpoint prop:
// app/layout.tsx
import { Analytics } from 'better-analytics/next';
export default function RootLayout({ children }) {
return (
<html>
<body>
<Analytics endpoint="/api/collect" />
{children}
</body>
</html>
);
}This monorepo contains:
better-analytics- Core SDK with subpath exports (packages/sdk)better-analytics- Core functionalitybetter-analytics/next- Next.js adapter
web- Demo Next.js app (apps/web)
# Install dependencies
pnpm install
# Build all packages
pnpm build
# Run tests
pnpm test
# Start development server
pnpm devThe apps/web directory contains a working Next.js demo that shows the SDK in action. Run pnpm dev and visit http://localhost:3000 to see analytics events being tracked in real-time.
"npm install, paste five lines, events reach my own URL." ✅
- Framework-agnostic core: Works with vanilla JS, React, Vue, Svelte, etc.
- Compressed JSON: All events sent via POST with minimal payload
- Your own endpoint: Complete control over data storage and processing
- No external dependencies: No tracking pixels, no third-party services
MIT