How julianpoy/recipesage works
RecipeSage is a collaborative recipe organizer spanning web/mobile clients, API services, and asynchronous jobs. A typical import starts with a user submitting a recipe source, proceeds through API upload and queued parsing, and ends with recipes available for collection and search. The product also supports meal planning, shopping lists, social collaboration, discovery, nutrition, and AI cooking assistance. The README establishes these capabilities; source-level links below are limited to relationships visible in excerpts or the source index, so unsampled feature wiring is not asserted.
Main entry points: trpc.ts TRPC procedures · app.routes.ts RecipeSage UI · app.ts HTTP server · cookbookmanagercom.ts Import upload
Components 19
Client applications
- RecipeSage UI
packages/frontend/src/app/app.routes.ts
API and domain
- HTTP server
packages/backend/src/app.ts - REST handlers
packages/express/src/defineHandler.ts - Import upload
packages/express/src/routes/import/job/cookbookmanagercom.ts - TRPC procedures
packages/trpc/src/trpc.ts - Recipe operations
packages/trpc/src/procedures/recipes/recipesRouter.ts - Account operations
packages/trpc/src/procedures/users/usersRouter.ts - Shopping lists
packages/trpc/src/procedures/shoppingLists/shoppingListsRouter.ts - Meal planning
packages/trpc/src/procedures/mealPlans/mealPlansRouter.ts - Recipe discovery
packages/trpc/src/procedures/discover/discoverRouter.ts - AI and extraction
packages/trpc/src/procedures/ml/mlRouter.ts - Sharing and profiles
packages/trpc/src/procedures/messages/messagesRouter.ts
Background processing
- Queue worker
packages/queue-worker/src/worker.ts - Job dispatcher
packages/util/server/src/general/queue/processWorkerJob.ts - Import dispatcher
packages/util/server/src/general/queue/import/processImportJob.ts - Cookbook parser
packages/util/server/src/general/queue/import/handlers/cookbookManagerComImportJobHandler.ts - Job queue
packages/util/server/src/general/queue/JobQueueItem.ts
Local and shared data
- Offline storage
packages/frontend/src/app/utils/appIdbStorageManager.ts
Other components
- Recipe user
Connections 21
- Recipe user → RecipeSage UI: uses
README.md - RecipeSage UI → HTTP server: requests API
- HTTP server → REST handlers: mounts routes
packages/backend/src/app.ts - HTTP server → TRPC procedures: mounts middleware
packages/backend/src/app.ts - REST handlers → Import upload: defines handlers
packages/express/src/routes/import/job/cookbookmanagercom.ts - Recipe user → Import upload: uploads source
README.md - Import upload → Job queue: enqueues job
packages/express/src/routes/import/job/cookbookmanagercom.ts - Queue worker → Job dispatcher: processes jobs
packages/queue-worker/src/worker.ts - Job dispatcher → Import dispatcher: dispatches imports
packages/util/server/src/general/queue/processWorkerJob.ts - Import dispatcher → Cookbook parser: dispatches format
packages/util/server/src/general/queue/import/processImportJob.ts - TRPC procedures → Recipe operations: registers procedures
packages/trpc/src/procedures/recipes/recipesRouter.ts - TRPC procedures → Account operations: registers procedures
packages/trpc/src/procedures/users/usersRouter.ts - TRPC procedures → Shopping lists: registers procedures
packages/trpc/src/procedures/shoppingLists/shoppingListsRouter.ts - Recipe user → Meal planning: plans meals
README.md - Recipe user → Shopping lists: organizes shopping
README.md - Recipe user → Recipe discovery: discovers recipes
README.md - Recipe user → AI and extraction: uses cooking assistant
README.md - Recipe user → Sharing and profiles: shares and collaborates
README.md - RecipeSage UI → Offline storage: restores session
packages/frontend/src/app/utils/appIdbStorageManager.ts - Offline storage → TRPC procedures: queries user
packages/frontend/src/app/utils/appIdbStorageManager.ts - Recipe user → RecipeSage UI: works offline
README.md