Scope Analytics

Zero-code analytics with AI-powered insights. Install analytics in under 5 minutes without modifying your application code.

Installation

# Run after building your application
npx scope-analytics install --key YOUR_PUBLIC_KEY

# Or use environment variable
export SCOPE_PUBLIC_KEY=your_public_key
npx scope-analytics install

How it Works

Scope Analytics modifies your built HTML files to inject our lightweight SDK. This approach:

• ✅ Works with any framework or build tool
• ✅ No code changes required
• ✅ Automatic tracking of all user interactions
• ✅ Compatible with all major hosting platforms

Platform-Specific Setup

Vercel

// vercel.json
{
  "buildCommand": "npm run build && npx scope-analytics install"
}

Netlify

# netlify.toml
[build]
command = "npm run build && npx scope-analytics install"

Render

Set build command: npm run build && npx scope-analytics install

Next.js

// package.json
{
  "scripts": {
    "build": "next build && npx scope-analytics install --dir .next"
  }
}

Commands

Install

npx scope-analytics install [options]

Options:
  -k, --key <apiKey>      Your Scope Analytics public key
  -d, --dir <directory>   Build output directory (default: dist)
  -e, --endpoint <url>    Custom API endpoint
  --no-api-tracking       Disable API call tracking
  --debug                 Enable debug mode

Uninstall

npx scope-analytics uninstall [options]

Options:
  -d, --dir <directory>   Build output directory (default: dist)

Validate

npx scope-analytics validate [options]

Options:
  -d, --dir <directory>   Build output directory (default: dist)

What Gets Tracked

• 📊 Page views and navigation
• 🖱️ Clicks and interactions
• 📜 Scroll behavior and reading time
• ⏱️ Performance metrics
• 🔗 API calls (optional)
• ❌ Errors and exceptions

Features

• AI-Powered Insights: Ask questions in natural language
• Automatic Tracking: No manual event setup required
• Privacy-First: No personal data collection
• Lightweight: < 30KB gzipped
• Real-Time: See events as they happen

Support

• Documentation: Coming soon at https://scopeai.dev
• Email: Contact via https://scopeai.dev
• Issues: Please report issues via our website

License

MIT