semust-js
v1.5.0
Published
Semust-js event tracking.
Maintainers
Readme
Semust.js
Lightweight, privacy-focused web analytics tracking script.
Features
✅ Page view tracking - Traditional and SPA route changes ✅ Event tracking - Clicks, form submissions, custom events ✅ Performance monitoring - Web Vitals (FCP, LCP, CLS, TTFB, INP) ✅ User fingerprinting - Privacy-friendly visitor identification ✅ Session management - Automatic session tracking ✅ Bot detection - Filter out bots and crawlers
Installation
Via CDN
<script src="https://cdn.jsdelivr.net/npm/semust-js@latest/dist/semust-js.min.js"
data-token="YOUR_TOKEN_HERE"></script>Self-Hosted
<script src="/path/to/semust-js.min.js"
data-token="YOUR_TOKEN_HERE"></script>Quick Start
- Get your access token from semust.com
- Add the script to your website with your token
- That's it! Analytics data will automatically be collected
Configuration
Basic Setup
<script src="semust-js.min.js" data-token="your-token-123"></script>Cookieless Mode
<script src="semust-js.min.js"
data-token="your-token-123"
data-cookieless="1"></script>What's Tracked?
- Page Views: Initial loads and SPA route changes
- Clicks: User interactions with elements
- Forms: Form submissions
- Performance: Core Web Vitals metrics
- Sessions: User visit sessions
- Device Info: Browser, OS, screen resolution
Privacy & Security
- ✅ No PII collected - No personal data tracked
- ✅ GDPR compliant - Respects user privacy
- ✅ Bot filtering - Automatic bot detection
- ✅ Cookieless option - Works without cookies
Documentation
For detailed documentation, API reference, and advanced configuration:
Support
- Website: semust.com
License
ISC © Ramazan Umutlu
