This project is developed with the help of AI. Grocy KMP is a very large undertaking: a complete client for every part of Grocy on phones, tablets, watches and the web. I wouldn't have the time to build it alone, and without AI it would have cost at least several years of my spare time. Every change is still planned, reviewed and tested by me.
Grocy KMP is an open-source client for Grocy (source code), a self-hosted grocery and household management solution for your home.
It is the successor of Grocy Android, rebuilt from the ground up with Kotlin Multiplatform and Compose Multiplatform. It brings all the features Grocy Android was missing, uses the most modern technologies and follows current best practices: Material 3 Expressive, layouts for every screen size, offline-first data and thorough tests. The same code powers the Android app, the Wear OS app and the web app.
Grocy KMP uses Grocy's official API. Its pages, forms and lists match Grocy's web frontend, so you find your way immediately, with a native interface, powerful barcode scanning and as few taps as possible.
This app requires a running self-hosted instance of the Grocy server application.
It is a companion app, therefore it cannot run standalone or manage products itself.
You can try it using the demo option available on the login screen.
If you want to try new features right after development, you can download a nightly build APK for that.
Grocy KMP is a new app with its own package name, so it does not update Grocy Android. Install it next to it, log in once and uninstall Grocy Android when everything works.
The Wear OS app is installed from Google Play on your watch; it takes the login from the Google Play version of the phone app by itself.
The web app runs in every current browser, without installing anything: open grocy.patrickzedler.com and log in. The newest development state runs at grocy-nightly.patrickzedler.com, with its own logins and data.
To use it like an app, install it from the browser: in Chrome or Edge with "Install" in the address bar or the menu, on Android with "Add to home screen", in Safari on iPhone or iPad with "Share" › "Add to Home Screen". It then opens in its own window, starts without loading the app again and updates itself after asking you.
Your Grocy server must be reachable with https, because browsers block plain http requests from a secure page. Logging in through Home Assistant ingress is not possible in browsers; assign a port to the Grocy add-on instead.
The web app only delivers its files: your browser talks to your Grocy server directly, your data never passes through the server of the web app.
If you run Grocy on your own server, you can serve the web app from it too. Every release comes as a Docker image for amd64 and arm64, an nginx without root rights on port 8080:
services:
grocy-kmp-web:
image: ghcr.io/patzly/grocy-kmp-web:latest
restart: unless-stopped
ports:
- "8080:8080"Without Docker, unpack Grocy-web-<version>.zip of a release into any static web server. It needs no configuration; only very old servers lack the type application/wasm for .wasm files.
Put it behind your reverse proxy with https, like Grocy itself: browsers allow the camera, installing and offline use only on secure pages. A path below Grocy's own address, e.g. https://grocy.example.com/app/, works too and keeps everything on one address. Updates come with a new image or ZIP; installed web apps notice them by themselves.
Grocy's web frontend works in any browser and covers everything. Grocy KMP shows the same pages, forms and lists, made for your phone, tablet and watch:
- Barcode scanning with a native camera scanner right in every form; with the unlock app also the due dates printed on packages
- Offline shopping: check off items without a connection, they are sent when you are back online without overwriting what others changed
- Everything at a glance on the start screen: what is due, what is missing, what is planned for today
- Notifications every day about due products, chores, tasks and batteries
- Home screen widgets and a Wear OS app with a tile for the shopping list
- NFC tags and QR codes with
grocy://links, e.g. one at the pantry that opens Consume for a product, or one at the washing machine that tracks a chore - New products filled in from Open Food Facts and its sister databases
- Several accounts and servers, switched with one swipe
- Material 3 Expressive design with dynamic colors, dark mode and layouts for every screen size, from phones to desktops
- Accessibility in every screen: labels for screen readers, headings, announced errors, large touch targets and full keyboard and mouse support
- Start screen with an overview of everything, in the order you choose
- Stock overview with reports, stock entries and stock journal
- Purchase, consume, transfer and inventory
- Shopping lists with offline support and in-store shopping mode
- Recipes with their cards and the meal plan
- Chores, tasks, batteries, equipment and calendar
- Editing of all master data, including userfields and userentities
- Fast barcode scanning, also of Grocycodes
- Open Food Facts and its sister databases fill in new products
- Daily notifications about what is due
- Home screen widgets for the shopping list, tasks and calendar
- Wear OS app with the shopping list and a tile
- Web app that works like the Android app
- Several accounts and servers, quick switching between them
- Layouts for phones, foldables, tablets and desktops
- Dark mode and dynamic color support
- Accessible with screen readers, keyboard and mouse
- No ads or analytics
The unlock app is a small purchase on Google Play that supports the development. It is the same one as for Grocy Android, so if you already bought it, it works here too. Once installed, the Google Play version of Grocy KMP can use the ML Kit barcode scanner and scan the due dates printed on packages.
Grocy KMP requires at least Android 7.0 Nougat on phones and tablets and Wear OS 3 on watches. The GitHub version works properly on devices without any Google service installed.
It is also possible to use the Grocy add-on of a Home Assistant server; the login supports its ingress directly.
This app supports https encryption
- if your server uses a certificate which is signed by a public and trusted certificate authority (CA). To meet this requirement, you can use a free certificate from letsencrypt.org for your server.
- if your server uses a self-signed certificate. In this case the certificate must be stored in the Android user certificate store.
- if your server requires a client certificate, which you can add in the server settings of the app.
Connections can also go through an HTTP proxy or Tor.
If you run into a bug or miss a feature, please open an issue in this repository.
Like the grocy project, Grocy KMP can be translated, too. The main language is English, but I also maintain the German translation because it's my mother tongue. You can help translate this project at Transifex, if your language is incomplete, contains typos or is not available yet.
Thanks for your contributions!
Grocy KMP is developed by me, Patrick Zedler. It continues Grocy Android, which my brother Dominic Zedler and I started in 2020.
I'd like to thank the developer of Grocy, Bernd Bestel, without whose great work this app would never have been possible.
Copyright © 2026 Patrick Zedler. All rights reserved.
GNU General Public License version 3
Grocy KMP is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Grocy KMP is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.


