Skip to content

Latest commit

 

History

History
99 lines (82 loc) · 3.55 KB

README.md

File metadata and controls

99 lines (82 loc) · 3.55 KB

kitshn (for Tandoor) kitshn (for Tandoor)

GitHub GitHub release (latest by date)

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

Although kitshn is available to multiple platforms, the main focus is still on Android. Some features are exclusive to that platform.

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.

Tip

GrapheneOS users might need to disable the "Hardened memory allocator" or enable the "Exploit protection compatibility mode" for the app to run.

📦 Installation

Get it on GitHub Get it on F-Droid Get it on Google Play

🌍 l10n

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

💪 Features

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

🖼️ Impressions

Screenshots light Screenshots dark Screenshots tablet light Screenshots tablet dark View light mode View dark mode

🚧 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