How lifeforge-app/lifeforge works
LifeForge is a self-hosted personal management system whose extensible modules provide productivity, finance, lifestyle, and learning features. A user enters through the web client; authentication and module availability determine the routes presented, while the API handles requests and exposes core services. The repository also includes account security, personalization, backups, and API-key management. The graph highlights documented product areas and sampled runtime relationships; some feature internals are represented by their exact source directories because their implementation was not excerpted.
Main entry points: core.routes.ts Core API routes · useAppRouter.ts App routing · routerFactory.tsx Route factory · auth Authentication
Components 24
Web experience
- Web client
apps/web/src/index.tsx - App routing
apps/web/src/core/routing/hooks/useAppRouter.ts - Route factory
apps/web/src/core/routing/utils/routerFactory.tsx - Module routes
apps/web/src/core/routing/utils/routeBuilder.tsx - Dashboard
apps/web/src/system/dashboard - Personalization
apps/web/src/system/personalization
Module platform
- Module federation
packages/federation/src/providers/FederationProvider.tsx - Server module loader
apps/api/src/core/functions/modules/loadAndRegisterModuleRoutes.ts - Module metadata
apps/api/src/core/functions/modules/gatherModuleMetadata.ts
API services
- API application
apps/api/src/core/app.ts - Core API routes
apps/api/src/core/routes/core.routes.ts - Route controller
apps/api/src/core/functions/routes/functions/controllerLogic.ts - Request processing
apps/api/src/core/functions/routes/utils/parsePayload.ts - Response handling
apps/api/src/core/functions/routes/utils/response.ts - Database services
apps/api/src/lib/database - Font services
apps/api/src/lib/fonts - AI services
apps/api/src/lib/ai - User services
apps/api/src/lib/user
Identity and settings
- Authentication
apps/api/src/lib/auth - Account settings
apps/web/src/system/accountSettings - API keys
apps/api/src/lib/apiKeys - Backups
apps/api/src/lib/backups
Other components
- User
- Self-hosted server
Connections 24
- User → Web client: uses
README.md - Web client → App routing: starts
- App routing → Module federation: reads modules
apps/web/src/core/routing/hooks/useAppRouter.ts - App routing → Authentication: checks session
apps/web/src/core/routing/hooks/useAppRouter.ts - App routing → Route factory: builds routes
apps/web/src/core/routing/hooks/useAppRouter.ts - Route factory → Module routes: creates routes
apps/web/src/core/routing/utils/routerFactory.tsx - Route factory → Dashboard: redirects to
apps/web/src/core/routing/utils/routerFactory.tsx - Module federation → App routing: provides modules
- Server module loader → Module metadata: gathers metadata
apps/api/src/core/functions/modules/loadAndRegisterModuleRoutes.ts - User → Dashboard: manages life
README.md - User → Personalization: customizes experience
README.md - User → Account settings: manages account
- API application → Core API routes: mounts routes
apps/api/src/core/app.ts - Core API routes → Authentication: routes to
apps/api/src/core/routes/core.routes.ts - Core API routes → Database services: routes to
apps/api/src/core/routes/core.routes.ts - Core API routes → User services: routes to
apps/api/src/core/routes/core.routes.ts - Core API routes → API keys: routes to
apps/api/src/core/routes/core.routes.ts - Core API routes → Font services: routes to
apps/api/src/core/routes/core.routes.ts - Core API routes → AI services: routes to
apps/api/src/core/routes/core.routes.ts - Route controller → Request processing: parses payload
apps/api/src/core/functions/routes/functions/controllerLogic.ts - Route controller → Response handling: sends response
apps/api/src/core/functions/routes/functions/controllerLogic.ts - User → Self-hosted server: controls data
README.md - Backups → Self-hosted server: backs up data
- Account settings → Authentication: configures security