Dashboard

The fluidsoul dashboard gives you a real-time view of user behavior across your workspace. It's available at /dashboard after signing in with Clerk.

Pages

Overview

The landing page after selecting a workspace. Shows key metrics at a glance:

• Event volume — total events over time (day/week/month granularity)
• Active users — unique users who triggered events
• New users — first-time users in each period
• Real-time stream — live SSE feed of events and context transitions

Use the date range picker and granularity toggle to adjust the time-series view.

Users

Search and browse all users with computed context. Each row shows the user's current dimensions (category, engagement level, maturity, preferred mode) and event count.

• Search — filter by user ID substring
• Filter by dimension — select a dimension and value to narrow results
• Sort — by recency, event count, or oldest
• User detail — click a user to see their full profile: context dimensions, event history, context history timeline, and event type breakdown

Features

Feature adoption broken down by user segment. Select a dimension (e.g. engagement_level) to see which features each segment uses most.

Each feature shows:

• Number of users per segment who used it
• Adoption rate relative to segment size
• Top features sorted by total usage

Cohorts

Cohort retention analysis. Users are grouped into weekly (or monthly) cohorts based on their first event, then tracked across subsequent periods.

The retention table shows:

• Cohort — the week/month the cohort started
• Size — number of users in the cohort
• Period columns — retention rate at each period (0 = signup period, 1 = next period, etc.)

Use the granularity toggle and period count to customize the view.

Insights

Behavioral insights automatically generated by the fluidsoul engine. Each insight includes:

• Title — what was detected
• Description — detailed explanation
• Severity — critical, warning, or info
• Confidence — how certain the detection is (0–1)
• Supporting data — the underlying metrics

Insights can be dismissed individually. Click "Generate insights" to trigger a fresh analysis.

Insight types include engagement drops, segment shifts, inactive user detection, and adoption trends.

Settings

Workspace configuration page. Edit your rules config (dimensions, signals, thresholds) directly in the dashboard. Changes take effect immediately for all subsequent context computations.

Real-time updates

The dashboard uses Server-Sent Events (SSE) to stream live updates. When events are ingested or context transitions occur, the relevant dashboard panels update automatically without a page refresh.

SSE connections are limited to 100 concurrent connections per server instance to prevent resource exhaustion.