How truthfool30/hearth works
Hearth is a self-hosted family hub. A member signs in, selects or joins a family, then uses the app’s feature modules; requests reach the server’s authenticated family APIs and persistent SQLite data, with live updates shared across devices. The product’s major branches cover the home wall, calendar, lists, chat, photos, meals, budget, locator, and vault. The README documents these capabilities; several feature implementations were not sampled, so their client-to-server links are left unverified rather than inferred.
Main entry points: registry.tsx Feature registry · index.js API module router · App.tsx App routing · app.js HTTP application
Components 19
Client experience
- App routing
client/src/App.tsx - App shell
client/src/layout/AppShell.tsx - Feature registry
client/src/modules/registry.tsx
Identity and platform
- Client auth
client/src/lib/auth.tsx - API client
client/src/lib/api.ts - HTTP application
server/src/app.js - Auth and families
server/src/core/auth.js - API module router
server/src/modules/index.js - SQLite data
server/src/db.js
Family features
- Home wall
client/src/modules/wall - Calendar
client/src/modules/calendar - Lists and tasks
client/src/modules/lists - Messages
client/src/modules/messages - Shared photos
client/src/modules/photos - Meals and recipes
client/src/modules/meals
Household tools
- Budget
server/src/modules/budget.js - Locator
client/src/modules/locator - Contacts and vault
server/src/modules/vault.js
Other components
- Family member
Connections 28
- Family member → App routing: uses
README.md - App routing → Client auth: checks session
client/src/App.tsx - App routing → App shell: renders
client/src/App.tsx - App routing → Feature registry: routes features
client/src/App.tsx - Client auth → API client: requests identity
client/src/lib/auth.tsx - Client auth → HTTP application: uses API
- HTTP application → Auth and families: mounts auth routes
server/src/app.js - HTTP application → API module router: mounts feature routes
server/src/app.js - HTTP application → SQLite data: receives database
server/src/app.js - Auth and families → SQLite data: reads and writes
- Feature registry → Home wall: registers
client/src/modules/registry.tsx - Feature registry → Calendar: registers
client/src/modules/registry.tsx - Feature registry → Lists and tasks: registers
client/src/modules/registry.tsx - Feature registry → Messages: registers
client/src/modules/registry.tsx - Feature registry → Shared photos: registers
client/src/modules/registry.tsx - Feature registry → Meals and recipes: registers
client/src/modules/registry.tsx - Feature registry → Budget: registers
client/src/modules/registry.tsx - Feature registry → Locator: registers
client/src/modules/registry.tsx - Feature registry → Contacts and vault: registers
client/src/modules/registry.tsx - Home wall → API module router: uses feature API
- Calendar → API module router: uses feature API
- Lists and tasks → API module router: uses feature API
- Messages → API module router: uses feature API
- Shared photos → API module router: uses feature API
- Meals and recipes → API module router: uses feature API
- Budget → API module router: registered by
server/src/modules/budget.js - Locator → API module router: uses feature API
- Contacts and vault → API module router: registered by
server/src/modules/index.js