How mmcoms/penware works
PenWare is a browser-based firmware release monitor and device guide for security-research hardware. Users browse a catalog, scan watched feeds, compare results with locally saved baselines, and receive in-app alerts; device pages also provide install/recovery guidance and backup options. A separate six-hour watcher checks catalog feeds and opens an issue for new releases. The sampled code supports the app, scan, persistence, catalog-import, and USB-backup links; watcher details and some external wiring are documented in the README rather than shown in sampled source.
Main entry points: penware-app.tsx Fleet and device UI · check.ts Feed checker · routeTree.gen.ts Route tree · device-backup.tsx Device backup panel
Components 20
App experience
- Home route
src/routes/index.tsx - Fleet and device UI
src/components/penware/penware-app.tsx - Router setup
src/router.tsx - Route tree
src/routeTree.gen.ts - App shell
src/routes/__root.tsx - Error display
src/lib/error-component.tsx
Firmware monitoring
- Feed checker
src/lib/penware/check.ts - Scheduled watcher
scripts/watch.mjs
Catalog and state
- Device catalog
catalog.json - Catalog loader
src/lib/penware/catalog.ts - Browser state
src/lib/penware/store.ts
Backup tools
- Device backup panel
src/components/penware/device-backup.tsx
Other components
- Visitor
- GitHub releases
- Biscuit feed
- Hak5 feed
- GitHub issues
- Remote catalog
- ESP32 over USB
- Downloaded backup
Connections 21
- Visitor → Home route: opens
README.md - Home route → Fleet and device UI: renders
src/routes/index.tsx - Router setup → Route tree: uses
src/router.tsx - Router setup → Error display: configures errors
src/router.tsx - Route tree → App shell: registers route
src/routeTree.gen.ts - Route tree → Home route: registers route
src/routeTree.gen.ts - Fleet and device UI → Feed checker: requests scans
src/components/penware/penware-app.tsx - Feed checker → GitHub releases: fetches releases
src/lib/penware/check.ts - Feed checker → Biscuit feed: fetches manifests
src/lib/penware/check.ts - Feed checker → Hak5 feed: fetches firmware
src/lib/penware/check.ts - Fleet and device UI → Browser state: reads and updates
src/components/penware/penware-app.tsx - Browser state → Visitor: persists locally
README.md - Device catalog → Catalog loader: loaded by
src/lib/penware/catalog.ts - Fleet and device UI → Catalog loader: uses built-ins
src/components/penware/penware-app.tsx - Fleet and device UI → Feed checker: imports remote catalog
src/components/penware/penware-app.tsx - Feed checker → Remote catalog: fetches catalog
README.md - Scheduled watcher → Device catalog: reads catalog
README.md - Scheduled watcher → GitHub issues: opens issue
README.md - Fleet and device UI → Device backup panel: renders
src/components/penware/penware-app.tsx - Device backup panel → ESP32 over USB: reads flash
src/components/penware/device-backup.tsx - Device backup panel → Downloaded backup: saves backup
src/components/penware/device-backup.tsx