Features

Expiration Calendar

The home screen shows a monthly calendar. Every day with expiring items displays coloured numbered badges — one badge per category, with the number showing how many items are due that day.

How to use

Tap a day — Opens a sheet listing every item due that day, grouped by category. Each item shows its entry date, days in stock, and storage location. Tap the + icon to add a new item for that date.
Tap an item in the sheet — Opens the Inventory filtered to that expiry date.
Long-press an item in the sheet — Shows a confirmation dialog before deleting.
Monthly strip (below calendar) — Shows how many items expire in the current month. Tap for full urgency breakdown.
Add Item button (bottom centre) — Adds an item to the selected date or today.
Navigation drawer (☰ on any screen, or swipe from left) — Available on every screen; navigate to Reports, Inventory, Calculator, Tips & Guides, Locations, Settings, and About without going back to the calendar first.
Tap the HAPT logo in any child screen — Returns to the configured landing page (Settings → Landing page).

Adding an Item

Every item has a category that controls which fields appear. Categories include Water, Food, Medicine, Equipment, Energy, Document, Action, Inspection, and Other.

Category-specific fields

Water: Container type (Bottle, Canteen, Jug, Jerry Can, Barrel, IBC Tote, and more — selecting a type auto-fills the typical volume), volume per item with L / mL toggle, Tank ID, Rotation target date
Food: Tags, Meal Fraction, Total Package Weight, Servings per Pack, Weight per Serving, Energy (kcal/100g)
Medicine: Usage Type (Daily/As Needed), Include in Calculator, Doses per item (barcode lookup available for food only)
Equipment: Description, Location
Energy: Source type, Description, Capacity, Voltage, Wattage, Runtime, Fuel type, Condition, Last tested
Document: File attachment (PDF, TXT, DOC, images), Description

Water rotation

Rotation date auto-seeds to the configured interval (default 6 months, adjustable in Settings). Expiry is automatically set to 5 days after the rotation date. Tap Mark Rotated on any water card to advance both dates to the next cycle from today. The rotation interval is configurable per device in Settings → "Water — rotation interval (months)".

Food calculations

Fill any two of Total Package Weight, Servings per Pack, and Weight per Serving, then tap Recalculate to compute the third.

Meal Fraction

Determines how much of a balanced meal one serving provides. Combine 1/3 Carbs + 1/3 Protein + 1/3 Vegetables for one full balanced meal.

Mandatory fields

Required fields are marked with a red asterisk (*) and show a red border while empty. A counter above the Save button shows how many mandatory fields are still missing; the button stays greyed until all are filled. Name is required for every category. Food items additionally require Total Package Weight and Energy (kcal per 100 g).

Barcode Scanner

Scan food barcodes to automatically pull product information from the OpenFoodFacts database. The product card shows name, brand, Nutri-Score, NOVA group, full nutritional table, and ingredients.

Auto-filled fields

Total package weight
Servings per pack
Weight per serving
Energy per 100g
Food tags

Offline support

A snapshot is stored for offline display. Product info can be viewed even without internet connection.

Reports Dashboard

High-level view of your emergency stock.

What it shows

Overview card — Total item count, with badges for expired and expiring-soon items.
By-category rows — Count per category with a proportion bar relative to total stock.
Red warning — Appears if any items in that category have expired.

Drill down

Tap any category row to open the full filtered Inventory list for that category. Pull down to refresh.

Full Inventory

The complete filterable and searchable list of all your items.

Search

Real-time name search at the top of the list. Clear button appears when text is entered.

Sort

Sort chips: Expiry (default), Name, Date Added. Tap the active chip to toggle ascending ↑ / descending ↓.

Filter chips

Filter by category (All, Water, Food, Medicine, …). A second row filters by location.

Expiry badges

■ Dark red — Expired
■ Red — Within 7 days
■ Orange — Within 30 days
■ Green — 30+ days
■ Grey — No expiry

Item cards

Category detail rows (tank ID, rotation date, meal fraction, doses, condition)
Expiry date colored with urgency for food and water items
⋮ menu: Edit, Clone, Manage Photo, QR Label (water), Product Info (food), Delete
Clone numbering scoped per location — Kitchen #3 and Box #1 are independent

+ Add Item button

Shortcut button in the inventory title row opens the Add Item screen directly.

Locations

Manage named storage areas for your supplies.

Creating locations

Name, optional description, optional reference photo
Type a new name in the Location field to create one on the spot
Pick from the list for existing locations

QR Labels

Generate printable QR labels for any location:

Size presets: 12×30mm, 15×30mm, 20×40mm, 30×60mm
Orientation: Portrait ↕ or Landscape ↔
Export: 600 DPI for thermal/inkjet printers
Share: Bluetooth, cloud drives, messaging
Save to device: Writes PNG to app's external storage

Scanning a location QR with any QR reader opens HAPT with that location's inventory.

Managing items in a location

Each location card has a bottom action row:

🧹 Clear — Empty the location without deleting it. Choose to unassign items (they stay in inventory) or delete them permanently.
🗑 Delete — Remove the location. If it has items, choose to keep them (location removed, items stay) or delete them all.

Supply Calculator

Plan stock levels for a given number of people.

Two modes

"How long?" — Shows days your stock lasts per category
"What do I need?" — Set target duration, see surplus/deficit

Controls

People stepper (1–50)
Target days stepper (1–365, how-long mode only)

Calculations

Water: Normal (4L/person/day) and Emergency (2L/person/day)
Food: Sum of Meal Fractions across non-expired items
Calorie Reserve: Total kcal, days of supply at configured rate
Medicine: Excludes "As Needed" items by default

Colour coding

🟢 Green — ≥14 days (or target met)
🟠 Orange — 7–14 days
🔴 Red — <7 days or no stock

Appearance

Theme is controlled from Settings. Choose Light, Dark, or System (follows the OS setting). Defaults to System.

Backup & Restore

Keep your data safe with full backups.

Export backup

Packages into a ZIP file containing:

SQLite database (hapt.db)
All stored documents
All item and location photos
Metadata for path rewriting

Restore

Pick a ZIP file to fully replace all current data
Open directly from file manager ("Open with → HAPT")
Confirmation dialog always shown
App restart required after restore

Cross-device restore

Automatic path rewriting ensures photos and documents work on any device.

QR Labels for Water

Generate printable QR labels for water containers.

Deep links: hapt://item/{id}
Scanning opens HAPT directly to that item's edit screen
Same label options as locations

Print labels and stick them on water containers for quick scanning and identification.

Expiry Notifications

Background daily check notifies you when items are expiring soon — no exact-alarm permission required, works even when the app is closed.

How it works

Android WorkManager runs a background task approximately once per day
Notification also fires immediately on each cold start
Grouped summary shows expired + expiring-within-threshold counts
Persists across device reboots automatically

Settings

Enable/disable via the Settings screen
Configurable threshold: 1–30 days before expiry (default 30)

Tips & Guides

Category-specific preparation advice.

What's included

Water storage best practices
Food rotation guidelines
Medicine kit recommendations
Equipment maintenance tips
Energy source advice

Accessible from the drawer or directly from the Add Item form via the Tips button.

Feature Details