41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# 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:
|
|
|
|
```text
|
|
https://api.pantrymanager.kitchen
|
|
```
|
|
|
|
To use a different API, pass a Gradle property. Android emulators reach the host machine at `10.0.2.2`:
|
|
|
|
```powershell
|
|
.\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
|
|
|
|
```powershell
|
|
.\gradlew.bat testDebugUnitTest lintDebug assembleDebug
|
|
```
|
|
|
|
The debug APK is written to `app\build\outputs\apk\debug\app-debug.apk`.
|