Help & Documentation

Everything you need to get SignalSplash working in your project.

Getting started

SignalSplash gives you web analytics, user analytics, product events, and Core Web Vitals in a single SDK — no cookies required. Here's how to get up and running in under 5 minutes.

Sign up at signalsplash.com/signup
Your first project (app ID) is created automatically
Install the SDK in your project (see below)
Visit your dashboard — data starts appearing within seconds of your first page view

Installing the SDK

Install via npm, yarn, or bun:

npm install @summoniq/analytics

For Next.js, wrap your app with the provider in your root layout:

// app/layout.tsx
import { AnalyticsProvider } from '@summoniq/analytics/react';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        <AnalyticsProvider
          appId="your-app-id"
          endpoint="https://api.signalsplash.com/api/events"
        >
          {children}
        </AnalyticsProvider>
      </body>
    </html>
  );
}

Page views are tracked automatically. To track custom events:

import { useAnalytics } from '@summoniq/analytics/react';

const { track } = useAnalytics();
track('button_clicked', { label: 'Sign up' });

To identify a logged-in user:

identify(user.id, {
  email: user.email,
  name: user.name,
  plan: 'pro',
});

API keys and app IDs

Each application you track has a unique app ID. This is passed as the appId prop on the provider and is the key used in all API calls and dashboard filtering.

Current app IDs tracked in SignalSplash:

signalsplash — this app
grabbatime — grabbatime.com
budgetbloom — budgetbloom.app
gimme-job — gimmejob.com
summoniq — summoniq.com

Events are sent to https://api.signalsplash.com/api/events. No authentication is required for event ingestion — the appId scopes the data.

Understanding your dashboard

Overview — aggregate stats, daily chart, top pages, referrers, countries, device breakdown
Sessions — individual session list with device, browser, duration, and page count
Events — raw event stream with type, path, and properties
Users — identified users with traits and activity history
Web Vitals — p75 LCP, CLS, INP, TTFB, FCP per app and page
Search — Google Search Console queries, impressions, CTR, and position (requires connecting your Google account)

Use the project dropdown at the top of the dashboard to switch between apps or view an aggregate "All Projects" view. The timeframe selector filters all data to Today, 7 days, 30 days, or all time. Both selections persist as you navigate between pages.

Contact & support

For bugs or feature requests: support@signalsplash.com

For privacy or data requests: privacy@signalsplash.com