kitshn is an unofficial android client for the self-hosted Tandoor recipe management software. The app is built with Jetpack Compose and Material You to deliver a modern, intuitive and responsive user experience.

[!IMPORTANT] Please note that the app is currently in alpha phase. You can of course open issues for bugs, feedback, and feature ideas.

[!WARNING] I'm just a hobbyist developing this app in my spare time. This app not only might, but is guaranteed to contain spaghetti code and actively ignores best practices.

📦 Installation

<img src="/images/badge_github.png" alt="Get it on GitHub" height="80"> <img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80"> <img src="/images/badge_google.png" alt="Get it on Google Play" height="80">

🌍 l10n

You can help translate kitshn on Transifex. Contributions are very welcome 😊

💪 Features

• [x] Dynamic home screen with suggestions
• [x] Recipes
  • [x] Adding, importing, editing and deleting
    • [ ] Step editing
    • [x] Steps combining tool
    • [x] Share receiver for recipe imports via URL
  • [x] Extensive search
  • [x] Cooking mode
  • [x] Step-ingredient allocation tool
  • [x] App links
  • [x] Markdown supported
• [x] Meal plan
  • [x] Overview
  • [x] Adding, editing and deleting
• [x] Shopping list
  • [x] Adding and deleting
  • [x] Auto-Sync
• [x] Recipe books
  • [x] Adding and deleting
  • [x] Favorites feature
• [x] UI
  • [x] Built with Jetpack Compose
  • [x] Material You dynamic colors
  • [x] Responsive two pane layouts for tablets and foldables

🖼️ Impressions

🚧 Roadmap

• [ ] Home
  • [ ] Localize queries
  • [ ] Season-based recommendations
  • [ ] Commonly used keywords
• [ ] Recipes
  • [ ] Add step editing
• [ ] Shopping
  • [ ] Dialog for shopping list entries
  • [ ] Categories and supermarkets
  • [ ] Shopping mode
    • Bigger text and touch targets
  • [ ] Better layout
• [ ] Go stable

📜 License & Credits

GNU General Public License v3.0
Icon made by Freepik from www.flaticon.com