Build on sleepypod
sleepypod is three cooperating projects. The public site is a separate static Nextra application.
| Repository | Role | Main tools |
|---|---|---|
| sleepypod/core | Pod server, hardware, web UI, scheduling, sensors | TypeScript, Next.js, tRPC, SQLite, Python |
| sleepypod/ios | Native companion | Swift, SwiftUI, XcodeGen |
| sleepypod/m5-rotary-dial | Bedside control firmware | C++, ESP32-S3, PlatformIO |
| sleepypod/sleepypod.github.io | This product and documentation site | Nextra, Next.js static export, Pagefind |
Read each repository’s instructions before changing it. Core’s architecture and invariants are summarized in its AGENTS.md; the wiki index points to deeper topic documentation.
Pick a starting point
- Architecture — hardware, processes, data flow, and storage.
- API reference — discover the installed API and its network model.
- Core development — local build and deployment.
- iOS development — app structure and contract testing.
- Dial development — firmware, host tests, and captures.
- Media capture — reproduce the site’s product imagery.
Current core references
Start with build and release workflows, temperature ownership, sensor pipelines, and the complete technical source library.
Last updated on