/Grocy-SwiftUI

A client for Grocy for macOS and iOS, written with SwiftUI

Primary LanguageSwiftGNU General Public License v3.0GPL-3.0

Grocy-SwiftUI

Now available on App Store and Mac App Store! - Jetzt im App Store und Mac App Store erhältlich!

English

This app is a companion for Grocy. It doesn't run on it's own, so you have to have access to a running Grocy instance, preferably with the newest version.

The goal of this app is to provide a native interface for Grocy on Apple devices (iOS, macOS). Therefore is this app developed using the newest technologies available (SwiftUI 3, Multiplatform App, Combine) and therefore needs the newest XCode (13.1) as well as at least iOS(15.0) or macOS (Monterey 12.0) to compile and run. This means the oldest supported devices are iPhone SE (2016), iPad Air 2, MacBook Air/Pro 2015 or later, please refer to this pages: iOS, macOS.

To connect to your own server, Grocy version 3.1.3 is required, for developing purposes a demo server is available.

What works or doesn't?

  • Master Data: enter, edit or delete
  • Products: purchase, consume, open and transfer
  • Stock journal
  • Stock view and filtering
  • Shopping list
  • Onboarding and configuration
  • Quick-Scan mode with barcode (only on iOS)
  • Recipes, Meal plan, chores etc.

What features are planned?

  • Integration of OpenFoodFacts for adding new products
  • Widgets for iOS and macOS
  • Siri-Support
  • Offline shopping List (saved with CoreData)
  • own icons (not everything is possible with SF Symbols)
  • additional comfort features

Deutsch

Diese App ist eine Begleiter-App für Grocy. Sie ist nicht alleine lauffähig, daher musst du Zugriff auf eine laufende Grocy-Instanz haben, welche am besten die neueste Version benutzt.

Das Ziel dieser App ist, ein natives Interface für Grocy auf Apple-Geräten (iOS, macOS) anzubieten. Dazu wird diese App mit den neuesten Technologien entwickelt (SwiftUI 3, Multiplatform App, Combine) und benötigt daher das aktuelle XCode (13.1) sowie mindestens iOS (15.0) oder macOS (Monterey 12.0). Dies heißt, dass das älteste unterstützte Gerät dasiPhone SE (2016), iPad Air 2, und MacBook Air/Pro 2015 oder neuer sind, für weiteres bitte hier nachschauen: iOS, macOS.

Es wird ein Server mit Grocy 3.1.3 benötigt, es ist jedoch auch Zugriff auf einen Demo-Server möglich.

Was Funktioniert bzw. was funktioniert nicht?

  • Stammdaten eingeben, bearbeiten und löschen
  • Produkte einkaufen, verbrauchen, öffnen und transferieren
  • Bestandsjournal
  • Anzeige und Filterung des Bestands
  • Einkaufsliste
  • Onboarding und Konfiguration
  • Barcode-Scan (nur auf iOS)
  • Rezepte, Speiseplan, Hausarbeit etc.

Welche Features sind geplant?

  • Integration von OpenFoodFacts für neue Produkte
  • Widgets für iOS und macOS
  • Siri-Unterstützung
  • Offline Einkaufsliste (mit CoreData gespeichert)
  • eigene Icons (noch nicht alles machbar mit SF Symbols)
  • zusätzliche Komfortfunktionen (wie bei öffnen an anderen Ort transferieren)