8000 GitHub - thordin9/apotheke: Apotheke (ἀποθήκη): a fast, mobile-first PHP + SQLite catalog for your stuff, with iPhone photo capture · GitHub
[go: up one dir, main page]

Skip to content
thordin9Public

About

Apotheke (ἀποθήκη): a fast, mobile-first PHP + SQLite catalog for your stuff, with iPhone photo capture

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Latest commit

 

History

1,809 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Apotheke

Apotheke

CI

The storehouse for your stuff. (Greek ἀποθήκη, apothḗkē: a place where things are put away for safekeeping.)

A small, fast, self-hosted web app for cataloguing your belongings: snap a photo on your phone, name the item, pick where it lives ("box 1023") and what it is ("Tools"), set a quantity, done. Then find anything again with instant search.

PHP 8.4 and CodeIgniter 4 (pinned Composer dependencies) with PDO (SQLite 3.38+ or PostgreSQL) and GD, plus Imagick in the Docker image for HEIC photos. No JavaScript build step and no CDNs: it works fully offline on your LAN.

3.0.0 is the CodeIgniter 4 app on main: no schema change, Docker-only, and one re-login at upgrade (upgrading to 3.0). See ADR-001 and the Feature 12 plan. For 90 days after 3.0.0, the 2.x line gets security fixes only, as 2.6.x releases from the branch old (the former main, last release v2.6.26).

Features

  • Mobile-first UI with dark mode; every screen works one-handed on a phone.
  • Items with up to 12 photos (crop, rotate, reorder), tags, notes in Markdown, attachments, purchase price and date, serial number, barcode, expiry or warranty date.
  • Nested locations and categories, instant ranked full-text search (typo-tolerant, Greek included), a filter sheet and saved filters.
  • Overview statistics, low-stock alerts, lending, bulk actions, duplicating, merging duplicates, undo, stocktakes and an activity history.
  • QR labels, CSV import and export, and portable backup and restore across SQLite and PostgreSQL.
  • Optional users with roles and permissions, guest browsing and self-registration.
  • A Control Panel for branding, formats, defaults and limits, and optional AI autofill of name, category, tags and notes from a photo.

Every feature is described in the user guide.

List & overview Filter sheet Item (dark) Desktop
List Filter sheet Item Desktop

Quick start (Docker)

git clone https://github.com/thordin9/apotheke.git && cd apotheke
echo 'APP_PASSWORD=change-me' > .env    # pick your own (8+ characters): the password of the account admin
docker compose up -d --build

The app then runs on http://127.0.0.1:9091. Docker installs are private by default: compose publishes the port on 127.0.0.1 only, and the container refuses to start with sign-in off unless ALLOW_NO_LOGIN=1 is set. To open it from your phone, to encrypt stored secrets with APP_KEY, to use PostgreSQL or to run without Docker, see Getting started.

Docker is the recommended way to self-host. To run it on your own Cloudflare account instead, see self-hosting on Cloudflare. The project's hosted API already runs in storage mode (D1, an Installation Durable Object and R2). A self-hosted copy can use the same storage code. On d1, a backup can be restored (each restore keeps the catalog before it under the installation's backups/).

Documentation

The manual lives in docs/: getting started · self-hosting on Cloudflare · configuration · Control Panel · user guide · AI autofill · deployment and operations (backups, upgrades, reverse proxies, security) · upgrading to 3.0 · architecture · database · testing · CI · releasing · contributing. Changes are listed in CHANGELOG.md. Agents: see AGENTS.md.

Coverage

Area Module suite Root suite (with HTTP) Combined
Front controller, config & routes 82.7 % 86.7 % 87.8 %
Items, search, bulk, lending 39.9 % 75.9 % 83.5 %
Favourites, undo, history 35.5 % 65.4 % 67.2 %
Stocktake & labels 47.6 % 95.6 % 96.0 %
Users, roles & sign-in 67.6 % 64.1 % 85.0 %
CSV import & export 54.6 % 79.9 % 91.0 %
Photos & autofill 70.9 % 17.6 % 72.3 %
Notes & layout 87.5 % 75.4 % 94.8 %
Settings & Control Panel 54.8 % 48.7 % 69.9 %
Backup & restore 70.5 % 59.9 % 82.3 %
Database & migrations 81.4 % 57.6 % 83.3 %
Core & dev server 78.7 % 58.9 % 91.4 %
All PHP (21154 lines) 67.9 % 66.6 % 84.8 %
Playwright project Functional tests Visual tests
chromium-pixel 148 22
chromium-pixel-dark 2 22
desktop-chromium 148 22
desktop-chromium-dark 2 22
pgsql-smoke 34 0
webkit-iphone-se 148 22
webkit-iphone-se-dark 2 22
webkit-iphone13 148 22
webkit-iphone13-dark 2 22
Total 634 176

Line coverage from pcov: the module suite (tests/Modules), the root suite (tests/Unit, with every php -S request its servers answer, collected by tests/coverage/prepend.php) and both merged with phpcov, SQLite driver. Regenerate with npm run coverage:readme; the release workflow refreshes it from the CI artifact in every release commit.

Contributing

Pull requests are welcome. Commits follow Conventional Commits (subject ≤ 72 characters, checked in CI); see CONTRIBUTING.md.

License

MIT © 2026 Stathis Papandreou

The logo, wordmark and mascot artwork is not covered by that licence; see frontend/brand/NOTICE.

About

Apotheke (ἀποθήκη): a fast, mobile-first PHP + SQLite catalog for your stuff, with iPhone photo capture

Topics

Resources

Contributing

Security policy

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages

0