Clean Slate

Clean Slate is an open-source calorie tracker web application designed for fast, compassionate food logging. It emphasizes caloric awareness while minimizing perfectionism by tracking only calories and protein and by encouraging a daily "fresh start" approach.

Key Features

• Simple food search and quick-add calories/protein for fast logging
• Barcode scanning powered by Open Food Facts to import product nutrition
• Create and log custom foods and recipes; track meals and exercise
• GraphQL API (Hasura) for querying logs, foods, recipes, and profiles
• Two authentication options: simple apiToken-based auth or optional Firebase social login
• Deployable via Docker Compose with PostgreSQL backend and Caddy reverse proxy
• Mobile-friendly web client built in TypeScript with a lightweight, speed-first UX

Use Cases

• Personal calorie and protein tracking for weight management or nutrition awareness
• Support for people recovering from disordered eating who need a gentle, non-judgmental tracker
• Self-hosted deployments for users requiring privacy and control over their data

Limitations and Considerations

• Default apiToken auth stores long tokens in the database and lacks email/password flows; Firebase adds complexity to set up
• Barcode coverage depends on Open Food Facts data; some products may be missing or incomplete
• No official native mobile apps; the service is primarily a responsive web client

Clean Slate is focused on simplicity and evidence-based education to teach sustainable tracking habits. It is suitable for individuals who want a fast, privacy-conscious tracker and for operators who prefer self-hosted deployment via Docker Compose.