Shared Infrastructure & Reliability
Local App Kit
Public Package · v0.1.0
A shared TypeScript runtime for local apps that centralizes file writes, conflict checks, request validation, live updates, and service recovery.
Developer Library
Key DecisionExtract repeated infrastructure only after multiple apps need it.
The Case Study
- Problem
- Several local apps needed the same file storage, request validation, and recovery behavior. With separate implementations, a fix in one app could leave the same issue unresolved in another.
- What I Built
- A small, versioned library for atomic JSON writes with ETags, a guarded static server, server-sent events, and single-server locking, with no runtime dependencies.
- How It Works
- Each app keeps its own product logic while using explicit interfaces to the shared storage and server library. Tests send requests through actual HTTP sockets to check that extracting the library preserves how the apps behave.
- Where It Stands
- Version 0.1.0 is released and used by AI Usage Tracker. Other planned consumers have not yet migrated; this is an incremental extraction.
- Evidence and Limits
- Parity tests check consumer behavior through actual HTTP sockets.
- One application has migrated. The package is not presented as a completed migration of every local app.
- Localhost guards and conflict checks address specific risks; they are not a claim of absolute security.
- Product Stack
- TypeScript · Node.js · HTTP · ETags · Server-Sent Events
- Evidence As Of
- 2026-10-27