new-pantry-management-android-app/README.md

Keeply for Android

A native Android version of the Keeply pantry manager, built with Kotlin and Jetpack Compose. It talks directly to the same ASP.NET API as new-pantry-management-frontend; it is not a WebView or React Native wrapper.

Included

• JWT sign-in, registration, encrypted token storage, session restore, and automatic token refresh
• Pantry summary, search, freshness/location filters, grouped product entries, and item CRUD
• Native Google barcode scanner with manual-entry fallback and barcode-first quick add
• Location CRUD
• Household creation/editing, member invites, and leave-household flow
• Role-gated site administrator user management
• Profile, email, name, and password settings
• Adaptive navigation for phones and tablets

Open and run

Open this folder in Android Studio, allow Gradle sync to finish, and run the app configuration on an Android 6.0 (API 23) or newer device/emulator.

The production API is used by default:

https://api.pantrymanager.kitchen

To use a different API, pass a Gradle property. Android emulators reach the host machine at 10.0.2.2:

.\gradlew.bat assembleDebug -PKEEPLY_API_BASE_URL=http://10.0.2.2:5000

Debug builds permit cleartext HTTP for local development. Release builds require HTTPS.

Validate

.\gradlew.bat testDebugUnitTest lintDebug assembleDebug

The debug APK is written to app\build\outputs\apk\debug\app-debug.apk.