https://github.com/chenasraf/nextcloud-pantry
Nextcloud app for managing your household. Lists, photos and notes, all in one place.
https://github.com/chenasraf/nextcloud-pantry
Last synced: 2 months ago
JSON representation
Nextcloud app for managing your household. Lists, photos and notes, all in one place.
- Host: GitHub
- URL: https://github.com/chenasraf/nextcloud-pantry
- Owner: chenasraf
- License: agpl-3.0
- Created: 2026-04-05T17:48:18.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-04-05T21:08:32.000Z (2 months ago)
- Last Synced: 2026-04-05T22:15:49.822Z (2 months ago)
- Language: PHP
- Size: 196 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Nextcloud Pantry
[](https://github.com/chenasraf/nextcloud-pantry/releases/latest)
[](https://github.com/chenasraf/nextcloud-pantry/actions/workflows/build-npm.yml)
[](https://github.com/chenasraf/nextcloud-pantry/actions/workflows/lint-php.yml)
[](https://github.com/chenasraf/nextcloud-pantry/actions/workflows/vitest.yml)
[](https://github.com/chenasraf/nextcloud-pantry/actions/workflows/phpunit-mysql.yml)
[](https://github.com/chenasraf/nextcloud-pantry/actions/workflows/phpunit-pgsql.yml)
A household management app for Nextcloud — shared checklists, photo boards, and notes, all in one
place.
## Screenshots
| | | |
| ---------------------------------------------- | ---------------------------------------------- | ---------------------------------------------- |
|  |  |  |
## Features
- **Houses**: Group household members and their shared data. A person can belong to multiple houses
and switch between them freely.
- **Checklists**: Create and manage shared checklists with support for recurring items (e.g. milk
every week) that automatically reappear when due.
- **Photo Boards**: Keep shared reference photos organized in folders — the right brand of dog food,
a favorite recipe card, a product label, and so on.
- **Notes Wall**: A lightweight shared space for household reminders, pinned messages, and quick
notes with customizable colors.
- **Notifications**: Get notified when household members upload photos, add notes, or edit shared
content.
- **Modern UI**: Built with Vue 3 and Nextcloud Vue components.
## Installation
### From the Nextcloud App Store
Install Pantry directly from your Nextcloud instance through the Apps page.
### Manual Installation
1. Download the latest release from the
[releases page](https://github.com/chenasraf/nextcloud-pantry/releases)
2. Extract to your Nextcloud apps directory:
```bash
cd /path/to/nextcloud/custom_apps
tar xfv pantry-vX.X.X.tar.gz
```
3. Enable the app from Nextcloud's Apps page or via command line:
```bash
php occ app:enable pantry
```
## Contributing
I am developing this app on my free time, so any support, whether code, issues, or just stars is
very helpful to sustaining its life. If you are feeling incredibly generous and would like to donate
just a small amount to help sustain this project, I would be very very thankful!
I welcome any issues or pull requests on GitHub. If you find a bug, or would like a new feature,
don't hesitate to open an appropriate issue and I will do my best to reply promptly.
## Development
### Prerequisites
- [pnpm](https://pnpm.io/)
- [Composer](https://getcomposer.org/) (auto-downloaded if missing)
- A running Nextcloud instance (Docker recommended)
### Quick Start
```bash
make build # install PHP+JS deps and build
pnpm dev # start watching for frontend changes
make test # run PHP tests
pnpm test # run frontend tests
make lint # lint JS + PHP
```
### Project Layout
```
.
├─ appinfo/ # App metadata & registration (info.xml, routes.php)
├─ lib/ # PHP backend (PSR-4: OCA\Pantry\…)
│ ├─ Controller/ # API endpoints
│ ├─ Service/ # Business logic
│ ├─ Db/ # Entities & mappers
│ ├─ Migration/ # Database migrations
│ └─ Notification/ # Notification handlers
├─ src/ # Frontend (Vue 3 + Vite + TypeScript)
│ ├─ components/ # Reusable UI components
│ ├─ views/ # Route views
│ ├─ composables/ # Vue composables
│ └─ api/ # API client layer
├─ tests/ # PHPUnit tests
└─ gen/ # Scaffolding templates (pnpm gen)
```
## License
This app is licensed under the [AGPL-3.0-or-later](LICENSE) license.