Skip to content

ReceiptPi v1.2.0 - PWA Support

Choose a tag to compare

@HostisHumani HostisHumani released this 24 Sep 12:58
· 56 commits to main since this release
83d607d

ReceiptPi v1.2.0 - PWA Support

ReceiptPi can now live on your home screen.

Version 1.2.0 adds full Progressive Web App support, making ReceiptPi installable directly from supported browsers when accessed over HTTPS, no separate mobile app is required.

📱 Install ReceiptPi like an app

ReceiptPi now includes:

  • Web App Manifest
  • Service Worker
  • Dedicated app icons for Android and iOS
  • Maskable icon support
  • Apple Touch Icon support
  • Standalone app experience
  • Full-app Service Worker scope via /sw.js

When installed, ReceiptPi launches like a regular app without the usual browser interface, providing quick access to printing, lists, recipes, and everything else ReceiptPi offers.

🤖 Android & 🍎 iOS

When ReceiptPi is served over HTTPS, supported browsers can install it as a PWA.

On iOS, ReceiptPi can also be added to the Home Screen.

No App Store, Play Store, or separate mobile application is required. ReceiptPi remains the same self-hosted application running on your Raspberry Pi.

⚡ Safe & predictable caching

The new service worker deliberately does not cache ReceiptPi pages or API requests.

Only versioned static assets (/static/...?...v=<hash>) are cached. Everything else continues to go directly to ReceiptPi.

This means:

  • Pages always come from ReceiptPi.
  • API requests are never served from the Service Worker cache.
  • Updated assets automatically receive a new content hash.
  • Old versions of changed assets are removed.
  • Updating ReceiptPi activates the new service worker and cleans up old caches.
  • The cache cannot continuously accumulate old versions of static assets.

This keeps the PWA lightweight while avoiding stale application data or unexpected offline behavior.

🎨 PWA appearance

ReceiptPi now provides dedicated PWA metadata and icons, including:

  • 192×192 app icon
  • 512×512 app icon
  • 512×512 maskable icon
  • 180×180 Apple Touch Icon
  • ReceiptPi theme colors for installed-app integration

📚 Documentation

The English and German documentation has been updated with information about installing and using ReceiptPi as a PWA.


Full Changelog: v1.1.0...v1.2.0