CookTrace v1.0.0-rc.1 — first public release

[thebigjoe1]

First public release of CookTrace — a self-hosted, fully-featured recipe manager for keeping every recipe you cook in one place, with the pantry, cook diary, shopping list, and Android app to match. Inspired by apps like Mealie, built as the third app in the Trace family alongside NutriTrace (nutrition) and LiftTrace (lifting). Runs as a single Docker container. AGPL-3.0, no telemetry, no cloud sync, no subscriptions.

Recipes

• Full recipe model: hero photo, ratings, ingredient groups, step-by-step instructions with per-step photos, kitchen gear, source / video URLs, rich-text notes
• Live scaling with snap-to-cooking-fractions math (1 ½ cup not 1.5 cup)
• Inline unit converter per ingredient (tsp / tbsp / cup / ml / g / oz / lb) with a built-in 250-entry density table so volume → grams resolves correctly for flours, oils, dairy, sugars, etc.
• Cook Mode with screen wake-lock, bigger fonts, persistent checkboxes for ingredients / gear / steps
• FDA-style Nutrition Facts box per recipe (31 nutriments, %DV column, sodium ↔ salt auto-derive)
• Cook log — date + notes + photo per cook, full per-recipe history
• Sharing — per-user grants, public-link share tokens, Pinterest-style recipe-card image, Kitchens for fanning shares to a whole household

Bring your existing library

If you already keep recipes somewhere, you don't have to start over:

• Any recipe URL — three engines you pick from: schema.org JSON-LD (fast), recipe-scrapers Python library (300+ site-specific extractors), and AI Smart mode for sites that block scrapers
• Photo import — snap a cookbook page, the AI assistant extracts the recipe
• Mealie / Tandoor / Paprika — paste-import single recipes from JSON, or bulk-import a full-backup zip. Picker shows thumbnails so you can choose exactly which 10 of 200 recipes to bring over
• NutriTrace foods → Pantry — search your NT food library and bulk-import into pantry with nutrition + image

Everything else

• Pantry with barcode scanning (ML Kit on Android, QuaggaJS on web), Open Food Facts + USDA lookup, stock + serving size + nutrition per item, and an "8 / 10 in pantry" match pill on every recipe card
• Cook Diary + Meal Planner — list and month-calendar views, drag-to-re-plan, one-tap mark as cooked
• Shopping list that pulls missing ingredients from a recipe and skips anything you already have stocked
• Trace AI assistant — bring your own Claude / OpenAI / Gemini key, or point at a local Ollama / LM Studio / LocalAI. Tool use across all providers reads + writes your real data; hold-to-record voice for hands-free logging
• NutriTrace federation — pull foods from your NT instance, log cooked recipes back to its diary
• Android app — standalone (fully offline) or server-connected with differential sync, biometric sign-in, native barcode scanner
• Multi-user — invites, password reset, OIDC SSO (Authentik, Keycloak, Authelia, Pocket-ID, Google), Kitchens
• Backup — scheduled auto-backups, full ZIP with restore safety, portable JSON, Android local-mode .zip for phone-to-phone transfer

Install

docker compose up -d

Default port http://localhost:3000. Plain-HTTP LAN deploys need INSECURE_COOKIES=1 in .env. Docker image is multi-arch (linux/amd64 + linux/arm64), so the same docker compose pull works on x86, Raspberry Pi 4 / 5, Apple Silicon, and ARM cloud. Signed Android APK on the release page.

First public release — bugs expected

Stable in solo testing for months, but real-world deployment surfaces things one person never will. Bug reports, feature requests, importer-failure URLs, and translation PRs are all genuinely wanted. Use the in-app Diagnostics view (Settings → Diagnostics → View Logs → Share) to attach logs to bug reports — it packages everything needed.

• Bugs / features: Issues
• Questions / setup help: Q&A
• Ideas: Ideas

Thanks in advance to anyone who tries it.