Swarm Community Data Platform

Privacy-respecting community observability and triage for Swarm Foundation. Tracks contributor engagement across X, GitHub, Reddit, LinkedIn, Discord, and YouTube with a simulation-first design.

Run on localhost

pnpm install
pnpm dev

Then open http://localhost:3000 (or http://localhost:3001 if the script prints that port 3000 was busy).

Avoid port conflicts without killing PIDs:
pnpm dev:auto — uses 3000 if free, otherwise 3001.
Stale UI after pulling changes:
pnpm dev:clean:auto — deletes .next, then starts dev with auto port.

Watchpack EMFILE (too many open files):
pnpm dev / pnpm dev:clean:auto run Turbopack (next dev --turbo) by default so Watchpack isn’t used. To force classic webpack dev: CDP_WEBPACK_DEV=1 pnpm dev:webpack (uses WATCHPACK_POLLING + optional CDP_DEV_POLL=1 webpack poll in next.config.js). If anything still fails: ulimit -n 10240 then retry.

If the page looks wrong (white background, old “Observe and triage” copy, nav links run together)

That means an old Next bundle is still running or CSS didn’t load. Current home should be dark with title “Community Data Platform” only (no “Pick your path” block).

1. Stop every dev/prod server on port 3000 (and 3001 if you use it).
2. From repo root: pnpm --filter @swarm-cdp/web dev:clean
   Or manually: delete apps/web/.next, then pnpm dev.
3. Hard refresh the browser (cache disable or Cmd+Shift+R).
4. For production: pnpm --filter @swarm-cdp/web build then pnpm --filter @swarm-cdp/web start (never start without a fresh build after pulling changes).

• Home — Dashboard with event counts and links to Inbox, Recognition, Ecosystem Intel.
• Inbox — Conversations from all channels with status, priority, assignment.
• Recognition — Praise and contributor signals (PRs, helpful replies).
• Ecosystem Intel — Mentions, announcements, and ecosystem signals.

Data is from the simulator (fixtures for all six channels). No API keys or database required to run.

Stack

• Monorepo: pnpm workspaces, Turbo
• Apps: Next.js 14 (App Router) for the dashboard
• Packages: @swarm-cdp/core (event schema, privacy tiers, identity linking), @swarm-cdp/simulator-data (fixtures)

Project structure

• apps/web — Next.js dashboard (inbox, recognition, ecosystem-intel)
• packages/core — Canonical event types, privacy, identity-linking
• packages/simulator-data — Fixture events and conversations for all channels

Values (Swarm-aligned)

• Data minimization by default (metadata-first; raw content off unless needed).
• Admin-assisted identity linking only — no automated cross-platform fusion.
• Behavior-based recognition — no ideological or influence scoring.