How ncastaldi/opinionated-recipes works
Opinionated Recipes is an early-stage, self-hosted Cooklang recipe manager. The current product is a walking skeleton: the web shell, Fastify API with liveness routing, and BullMQ worker run, but recipe features are not implemented. The documented target workflow accepts typed, imported, or migrated recipes, normalizes them to house style, and stores canonical Cooklang in Postgres; optional embeddings and chat are also planned. The graph distinguishes implemented components from documented capabilities. Recipe-stage links rely on the README, not inspected implementations.
Main entry points: server.ts API server · src House-style normalization · worker.ts Job worker · jobs.ts Job dispatch
Components 19
Web experience
- Recipe SPA
apps/web/src/app.tsx - Web nginx
apps/web
API service
- API server
apps/api/src/server.ts - Fastify app
apps/api/src/app.ts - Liveness route
apps/api/src/routes/health.ts - Environment config
packages/config/src/index.ts
Recipe processing
- Recipe inputs
apps/worker/src - House-style normalization
apps/worker/src - Cooklang parser
packages/engine/src/parse.ts - Job worker
apps/worker/src/worker.ts - Job dispatch
apps/worker/src/jobs.ts
State and AI
- Database client
packages/db/src/index.ts - Postgres
- Redis queue
- Local embeddings
apps/worker/src - Ollama
- Recipe chat
apps/api/src - Claude API
Other components
- Household user
Connections 18
- Household user → Recipe SPA: uses
README.md - Recipe SPA → Web nginx: served by
README.md - Web nginx → API server: proxies requests
README.md - API server → Environment config: loads config
apps/api/src/server.ts - API server → Fastify app: builds app
apps/api/src/server.ts - Fastify app → Liveness route: registers route
apps/api/src/app.ts - API server → Redis queue: enqueues jobs
README.md - Redis queue → Job worker: delivers jobs
README.md - Job worker → Environment config: loads config
apps/worker/src/worker.ts - Job worker → Job dispatch: dispatches job
apps/worker/src/worker.ts - Recipe inputs → House-style normalization: normalizes
README.md - House-style normalization → Cooklang parser: parses Cooklang
README.md - House-style normalization → Database client: saves canonical recipe
README.md - Database client → Postgres: reads and writes
README.md - Job dispatch → House-style normalization: dispatches processing
README.md - Job dispatch → Local embeddings: dispatches embedding
README.md - Local embeddings → Ollama: requests embeddings
README.md - Recipe chat → Claude API: requests chat
README.md