Anarchyukz/PantryPal

Kotlin

0

65 commits

updated Oct 15, 2026

See the code

See what people are saying

SourceMessageScoreDate

I’m building PantryPal — a free, open-source Android recipe app 🍳 (r/SideProject)

Hi everyone! I’ve been building PantryPal, a recipe app for Android, and I’d love to get some feedback from people who enjoy cooking or like trying out independent apps. The idea is to have one place to keep your recipes, discover new ones and organise your cooking without needing an account or…

0

Oct 14, 2026

README

PantryPal

Your recipes, your kitchen. PantryPal is a free, open-source Android recipe organiser built with Kotlin and Jetpack Compose. The MVP stores recipes locally and imports from websites that publish Schema.org Recipe JSON-LD data.

Features

  • Add, edit, search and delete recipes.
  • Local device storage; no account or server required.
  • Import recipe name, description, ingredients and instructions from supported recipe pages.
  • Nutrition details, recipe website browsing and themed discovery.
  • GitHub Actions builds an installable APK when code is updated.
  • Versioned APK releases can be published from a v* tag.

Download and install

Open the latest PantryPal build. Select the latest successful run, scroll to Artifacts, and download PantryPal-APK. Extract the ZIP and install the APK on your Android device.

The automated build uses Android's debug signing key unless release-signing secrets are configured in GitHub. For a stable signing identity across future updates, configure PANTRYPAL_KEYSTORE_BASE64, PANTRYPAL_KEYSTORE_PASSWORD, PANTRYPAL_KEY_ALIAS and PANTRYPAL_KEY_PASSWORD as repository Actions secrets before distributing signed release builds. Never commit signing keys or passwords.

Build from source

Requirements: JDK 17, Android SDK 36, Gradle 8.13.

gradle assembleDebug

APK output: app/build/outputs/apk/debug/app-debug.apk.

To publish a versioned APK, push a tag beginning with v (for example, v1.0.0). Configure release signing first if you need an APK that can be updated in place across future builds.

Donations

PantryPal is free. Add voluntary donation links here when ready:

  • GitHub Sponsors: setup pending
  • Ko-fi: setup pending

Donations are optional and do not unlock features.

Importing limitations

The importer looks for Schema.org Recipe JSON-LD. Some sites block automated access or don't provide structured data. Social media imports may require pasting the recipe caption/text and are not guaranteed to work for every post. Only import content you have permission to use.

Privacy

Recipes are stored in app-private local storage. Importing makes a network request to the URL entered. This app has no account, analytics or cloud sync. Back up important recipes separately until export/backup is implemented.

Roadmap

  • Recipe backup/export
  • Meal planner and shopping list
  • Portion scaling
  • Images and favourites
  • More robust website/social imports
  • Optional sync with sustainable free hosting
  • Configure donation links

Licence

MIT. See LICENSE.

Anarchyukz/PantryPal

Kotlin

0

65 commits

updated Oct 15, 2026

See the code

See what people are saying

SourceMessageScoreDate

I’m building PantryPal — a free, open-source Android recipe app 🍳 (r/SideProject)

Hi everyone! I’ve been building PantryPal, a recipe app for Android, and I’d love to get some feedback from people who enjoy cooking or like trying out independent apps. The idea is to have one place to keep your recipes, discover new ones and organise your cooking without needing an account or…

0

Oct 14, 2026

README

PantryPal

Your recipes, your kitchen. PantryPal is a free, open-source Android recipe organiser built with Kotlin and Jetpack Compose. The MVP stores recipes locally and imports from websites that publish Schema.org Recipe JSON-LD data.

Features

  • Add, edit, search and delete recipes.
  • Local device storage; no account or server required.
  • Import recipe name, description, ingredients and instructions from supported recipe pages.
  • Nutrition details, recipe website browsing and themed discovery.
  • GitHub Actions builds an installable APK when code is updated.
  • Versioned APK releases can be published from a v* tag.

Download and install

Open the latest PantryPal build. Select the latest successful run, scroll to Artifacts, and download PantryPal-APK. Extract the ZIP and install the APK on your Android device.

The automated build uses Android's debug signing key unless release-signing secrets are configured in GitHub. For a stable signing identity across future updates, configure PANTRYPAL_KEYSTORE_BASE64, PANTRYPAL_KEYSTORE_PASSWORD, PANTRYPAL_KEY_ALIAS and PANTRYPAL_KEY_PASSWORD as repository Actions secrets before distributing signed release builds. Never commit signing keys or passwords.

Build from source

Requirements: JDK 17, Android SDK 36, Gradle 8.13.

gradle assembleDebug

APK output: app/build/outputs/apk/debug/app-debug.apk.

To publish a versioned APK, push a tag beginning with v (for example, v1.0.0). Configure release signing first if you need an APK that can be updated in place across future builds.

Donations

PantryPal is free. Add voluntary donation links here when ready:

  • GitHub Sponsors: setup pending
  • Ko-fi: setup pending

Donations are optional and do not unlock features.

Importing limitations

The importer looks for Schema.org Recipe JSON-LD. Some sites block automated access or don't provide structured data. Social media imports may require pasting the recipe caption/text and are not guaranteed to work for every post. Only import content you have permission to use.

Privacy

Recipes are stored in app-private local storage. Importing makes a network request to the URL entered. This app has no account, analytics or cloud sync. Back up important recipes separately until export/backup is implemented.

Roadmap

  • Recipe backup/export
  • Meal planner and shopping list
  • Portion scaling
  • Images and favourites
  • More robust website/social imports
  • Optional sync with sustainable free hosting
  • Configure donation links

Licence

MIT. See LICENSE.