Skip to content

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

Latest
Latest

Choose a tag to compare

View all tags
@thebigjoe1 thebigjoe1 released this 25 Jun 12:24
v1.0.0-rc.1
a8e069f

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

Self-hosted recipe, pantry, and cooking tracker. Single Docker container, AGPL-3.0, no telemetry, no cloud sync, all data on your hardware. Third app in the Trace family alongside NutriTrace and LiftTrace.

📷 Screenshots · 📦 Docker image · 📖 Deploy guide · 🔐 Privacy

After several months of private dev as the v0.x-beta series, CookTrace is going public for wider testing. This release candidate snapshots the dev branch at feature completeness — Recipes, Pantry, Cook Diary, Meal Planner, Shopping, importers, federation, AI assistant, and a native Android app are all end-to-end.

What's in v1.0.0-rc.1

Aggregate feature surface (everything below is shipped):

  • Recipes — full model (hero photo, rating, favorite, yield, prep / cook / total time, servings, ingredient groups, step list, kitchen gear, source / video URLs, rich-text notes), per-step photos, inline markdown formatting, live recipe scaling with snap-to-fraction quantities, inline unit converter with 250-entry density table, Cook Mode (Screen Wake Lock + bigger fonts + persistent checkboxes), per-recipe cook history, FDA-style Nutrition Facts box with sodium ↔ salt auto-derive
  • Recipe Editor — drag-to-reorder ingredients + steps, pantry-link button per ingredient row, Add-from-Pantry picker, auto-save drafts to localStorage, sticky save bar, sanitized rich-text Notes
  • Pantry — slide-up details sheet with in-place edit, inline nutrient editing, Grid + List view modes, bulk multi-select, Open Food Facts + USDA lookup, native barcode scanner (ML Kit on Android, QuaggaJS on web), pantry-match pill on every recipe card
  • Diary — Cook Diary + Meal Planner: list view (60 back / 30 forward), month calendar with drag-to-re-plan, per-recipe history, one-tap planned → cooked
  • Shopping — aisle-grouped list, from-recipe pull (skips stocked items), bulk clear-checked, cross-recipe dedup
  • Importers — three URL engines (schema.org JSON-LD, recipe-scrapers Python lib with 300+ extractors, AI Smart Mode), AI photo import, Mealie / Tandoor / Paprika exports + bulk-zip with thumbnail picker, category carry-over, NutriTrace foods → Pantry
  • NutriTrace federation — bidirectional integration: search NT's food library + bulk-import as pantry items, link recipe ingredients to NT foods, log cooked recipes back to NT's diary. Tokens never reach the browser
  • Trace AI assistant — Claude / OpenAI / Gemini / OpenAI-compatible (Ollama, LM Studio, LocalAI, DeepSeek, Groq), tool use across all providers with 18 tools (real recipe / pantry / diary / shopping / cookbook reads + writes), hold-to-record voice Smart Log, image attach, persistent cross-device chat history
  • Multi-user — wizard onboarding (local-only or connect-to-server), invite tokens, SMTP-backed password reset, OIDC SSO with multi-provider admin UI + encrypted client secrets + RP-initiated logout (Authentik / Keycloak / Authelia / Pocket-ID / Google / etc.), Kitchens (multi-user soft groups), optional strong-password policy, biometric sign-in on Android
  • Android app — Capacitor 8, runs standalone (fully offline, on-device SQLite) or server-connected (differential sync engine, merge dialog on connect), Health Connect for Trace family parity, native ML Kit barcode scanner, native notifications, biometric sign-in, OIDC deep-link SSO
  • Branding & display — 12 named accent colors + HSL/RGB/Hex picker, light / dark / system theme, imperial / metric × kcal / kJ unit independence (locale-aware default), persistent sidebar on desktop, skeleton loaders, sticky search + filter
  • Backup & restore — full ZIP backup (admin, server mode) with zip-slip + zip-bomb defenses, scheduled auto-backups (off / daily / weekly / monthly + retention), portable JSON, Android local-mode self-contained .zip for phone-to-phone transfer
  • Diagnostics — in-app 500-line log ring buffer, crash report banner, file logging on Android (7-day retention)
  • Print — Cmd-P on a recipe view yields a clean one- or two-page recipe card

Distribution

  • Source: github.com/traceapps/cooktrace (AGPL-3.0)
  • Docker image (multi-arch: linux/amd64 + linux/arm64): ghcr.io/traceapps/cooktrace:1.0.0-rc.1 and :latest
  • Android APK: attached to this release, signed with the shared TraceApps release keystore (same cert as NutriTrace and LiftTrace, so all three apps install side-by-side with no reinstall)
docker compose pull && docker compose up -d

Known limitations

  • iOS — not currently available. Pending hardware + Apple Developer account access
  • Local / self-hosted LLM via OpenAI-compatible adapter — works today for AI chat + tool use; image-import (photo of a recipe page) is most accurate against cloud providers (Claude / OpenAI / Gemini) with vision support

Reporting bugs

Settings → Diagnostics → View Logs → Copy / Share → attach to a GitHub issue.

Assets 3
Loading