User guide

PulsePoint — how to use it

Start here for the sandbox demo (safe practice) or school / live (real rosters). Bookmark the URLs with the correct port — :13002 for sandbox, :3002 for live.

Which URL do I use?

StackUse forStart here
Sandbox / demo Training, district demos, experiments — not real student data Instructions → Dev Hub
School / live Daily teaching — real Mongo roster PulsePoint Hub

Sandbox (this machine — include :13002):

http://127.0.0.1:13002/dev/

Sandbox (Chromebook / Tailscale — public Funnel, no port needed):

https://ariss-macbook-pro.sunfish-bearded.ts.net/dev/

School / live:

http://127.0.0.1:3002/
Wrong: http://127.0.0.1/dev/ — no port → connection refused. Always use :13002 for sandbox or :3002 for live.

Open in Chrome (not only the IDE)

Links inside Cursor often open the built-in browser. That works because Cursor forwards ports over SSH. Google Chrome needs the full URL above — copy it from this page or the Dev Hub sidebar.

  • Paste http://127.0.0.1:13002/dev/ into the Chrome address bar on the Mac that runs Docker.
  • From another laptop: use the public Tailscale Funnel URL (see box above) or Tailscale IP with :13002 on the tailnet.
  • In Cursor: right-click a link → Open in External Browser, or use the Ports panel and forward 13002.

Teacher workflow — sandbox demo (~15 min)

Roster starts empty. Create your first student with IEP PDF import — not bulk seed.
  1. Open Dev Hub — bookmark /dev/. You should see the green Demo · sandbox tag.
  2. Import one student — IEP PDF import: upload a text-based IEP PDF → Ollama draft → Preview → Commit (staff passcode below).
  3. Optional: on Dev Hub, add supports (extended time, etc.) or an assignment for that student.
  4. Student view — Student login: pick the student → dashboard & assignments (Chromebook-friendly).
  5. Teacher view — Staff gate → Teacher Hub: live monitor, gradebook, behavior, IEP tools (demo data only).
  6. Reset — Dev Hub → Wipe sandbox (DB + metrics) before the next demo.
Dev Hub IEP PDF import Student login Assignments Teacher Hub

One-line pitch for leadership: “We upload an IEP, PulsePoint drafts goals, we show the student Chromebook experience, then Teacher Hub — all on a sandbox that never touches live rosters.”

Teacher workflow — school day

Use port 3002 (or your school server URL), not the sandbox.

More detail: Ways teachers use PulsePoint.

Staff passcode

Default staff passcode: tunson (from control-center-config.json, case-insensitive).

  • Dev Hub on port 13002 — no passcode required.
  • Staff gate — Teacher Hub, therapist portal, some staff-only pages.
  • IEP PDF Commit — required when writing to the sandbox Mongo DB.

This guide does not require a passcode to read.

Troubleshooting

ProblemFix
Connection refused Add :13002 (sandbox) or :3002 (live). Start stack: docker compose -f docker/compose/docker-compose.pulsepoint-dev.yml up -d from repo root.
Works in IDE, not Chrome Copy the full URL from this page; use Tailscale URL from another device.
Wrong passcode / loop Use tunson; hard refresh (Cmd+Shift+R); try /dev/ directly on sandbox.
No students on login Sandbox roster is empty until IEP PDF import commit or manual add on Dev Hub.
API offline on Dev Hub Wait 30s after up -d; check /api/health.