Source-available dashboard to track, log, and analyze sensors in garages, workshops, attics, crawlspaces, and shops — Astro 7, Cloudflare Workers, Neon Postgres, and Stripe.
Runs in production at probeharbor.dev with 15-minute history polling, CI, Playwright smoke, and pnpm ops:smoke.
| App | probeharbor.dev |
| Live demo | probeharbor.dev/demo — no account |
| Start free | Create account → Devices — no credit card |
| Developer docs | probeharbor.dev/developers |
| Product guides | probeharbor.dev/guides |
| OpenAPI | probeharbor.dev/openapi.yaml |
| Contributing | CONTRIBUTING.md |
GitHub About → Website points at the live app. Architecture, env vars, cron, and deploy live in the developer docs.
ProbeHarbor connects probes in a garage, workshop, attic, or similar space, compares them with outdoor weather, keeps history you can chart and export, and alerts you when something goes wrong — freeze risk, a wet leak sensor, humidity spikes, silent feeds, or a custom rule you define.
Pull HTTPS JSON from a local probe server, or push from ESP/Arduino to a per-device ingest URL. Households share devices, invite family (including read-only viewers), and publish a free family live share link — Pro adds expanded share scopes, metrics API keys (read-only by default, or read-write), and automation webhooks.
- Live readings — temperature, humidity, air quality, doors, leaks, power, energy, motion
- Overview — Simple or Insights mode: 7-day probe curves with optional humidity/dew overlays, freeze hours and degree-hours, indoor−outdoor ΔT, probe spread, condensation risk, feed health, plus Insights cards for doors, power, motion, battery/RSSI, and air quality
- Alerts — freeze and leak alerts on every plan, plus a forecast-backed time-to-freeze clock that can warn on remaining hours before the probe crosses threshold; custom rules for doors, power, air quality, and more; email and chat-style channels (SMS, push, webhooks on Pro)
- History — charts, YoY overlay (local probe data, or outdoor Open-Meteo estimate when prior-year probes are missing), Member/Pro CSV export; Pro claims evidence pack
- Hardware — push ingest or pull JSON; sketches in
sketches/ - Households — invites, viewers, multi-property / Portfolio for landlords; free family live share link; Pro expands share scopes and status pages
Plans and limits: probeharbor.dev/pricing · comparison: probeharbor.dev/compare
Astro 7 + Preact islands + Tailwind v4 · Cloudflare Workers · Neon Postgres · Better Auth · Stripe · Cloudflare Email · Twilio SMS (Pro) · Web Push (Pro). Node.js 24 (>=24.11.0) and pnpm.
pnpm install
cp .env.example .env # fill in values — see developer docs
pnpm dev # http://localhost:4321
pnpm test
pnpm typecheckMore: Local development · Deploy & ops
pnpm build && pnpm deploy
pnpm test:e2e
pnpm audit:stripe # display prices vs live Stripe
pnpm ops:smoke # public smoke + sitemap pingsrc/pages/ Routes; API under pages/api/
src/lib/ Auth, devices, alerts, Stripe, ingest
src/worker.ts Cloudflare fetch + scheduled jobs (15-min poll)
src/actions/ Astro Actions (prefs, alerts, invites)
db/migrations/ Schema (pnpm db:migrate)
sketches/ Arduino / MicroPython / CircuitPython / Zephyr / WCHNET / AVR assembly ingest samples
docs/ VitePress developer docs (GitHub Pages)
- Create a free account (no credit card)
- Dashboard → Devices → create a push device and copy the ingest key from the callout
POSTto/api/ingest/<key>— sensor keys auto-import on first POST; rename on Devices afterward- Overview → Try without hardware saves the demo pull feed if you have no ESP or Pico yet
Step-by-step: Adding devices · ESP32 freeze kit BOM · Accessories · Pico W ingest · STM32 Zephyr · CH32V RISC-V · AVR assembly · Teensy 4.1 · PIC18 Ethernet · Cellular · sample sketches in sketches/
Pull feeds (HTTPS JSON we fetch): Devices → Pull feeds tab — add URL, Save pull setup, probes auto-import from the live feed.
Integrations: Home Assistant (HACS) · Matter / Apple Home · Node-RED · Influx / Telegraf · IFTTT / n8n · HACS repo · Matterbridge plugin · Developer docs
Operator launch checklist: docs/community/operator-checklist.md (forum post, thermostat OAuth, HACS default PR status)
curl -X POST "https://your-domain/api/ingest/YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"door1": true, "temp1": 42.5, "battery": 87, "rssi": -62}'Guides: Adding devices · Push ingest · Sketches · Ingest & webhooks
Related repos: arduino JSON probe · Python relay · Home Assistant integration · Matter / Apple Home · ProbeHarbor Desktop · Bay Buddy (mood glance) · Claim puck (RP2040-Zero) · Android app
Issue creation is currently restricted on this repo — bugs, feature ideas, and account/billing questions all go through the contact form. Code contributions are still welcome as PRs: see CONTRIBUTING.md and the Code of Conduct.
PRs should pass pnpm test and pnpm typecheck. CI also runs the Astro build and Playwright smoke. An import-guard Vitest suite fails the build if a page renders a component it never imports.
The app is licensed under the Functional Source License 1.1, ALv2 Future License (FSL-1.1-ALv2). You can read, run, self-host, and modify it for anything except offering a competing commercial service. Each release becomes Apache-2.0 two years after it is published.
The device-side code in sketches/ and firmware/ stays MIT, so you can copy it into your own projects freely. Code published before the license change (up to commit cef39a7) remains available under MIT.
Contributions are welcome. By opening a PR you agree your contribution is licensed under the same terms as the directory it changes.