Documentation

Home Dashboard

The Home screen is your central hub. It shows all your items, their check-in/out status, and provides quick access to every major feature via the bottom tab navigation.

Bottom Tab Navigation

The app uses a bottom tab bar for navigating between the main sections:

Item Management

Items are the core of Where The Bleep. Each item can have photos, descriptions, categories, metadata (serial numbers, purchase price, estimated value, insurance references), and a location assignment.

Creating an Item

1. Tap the + button on the Home screen
2. Add a title and description — or tap the AI camera button to snap a photo and let AI generate them
3. Choose a category from the picker
4. Assign a location by browsing your location tree
5. Optionally add photos, serial number, purchase price, estimated value, and insurance info
6. Toggle Has Inventory if you want to track quantities
7. Tap Save

Item Statuses

Item Actions

Locations

Locations are organized in a hierarchy. Container locations (rooms, buildings, closets) can hold other containers or destinations. Destination locations are where items are stored — a specific shelf, drawer, or box.

Location Features

• Breadcrumb paths — e.g., "Home > Office > Desk"
• Sunburst chart — interactive visualization of your entire location tree
• QR codes — generate QR labels for any destination location
• Item count — see how many items are stored at each location

Managing Locations

QR Codes & Labels

Every destination location can have a QR code. Scanning a QR label instantly opens the location so you can check items in. Labels use the belongings://loc/{uuid} URI scheme.

QR Label Workflow

1. Navigate to a destination location
2. Tap the QR code icon to generate a label
3. Print individual labels or use Bulk PDF Export to print many at once
4. Stick the label on the physical location (shelf, box, drawer)
5. To check an item in, scan the QR code with the in-app camera

QR Status Tracking

Use the "Has Been Printed" toggle to reprint individual labels without bulk-printing all of them again.

Search & Voice

Search is powered by SQLite FTS5 for blazing-fast full-text search across item names, descriptions, and tags. Voice search uses on-device speech-to-text.

Search Features

• Full-text search — finds matches across names, descriptions, and tags
• Prefix matching — start typing and results appear instantly
• Voice search — tap the microphone icon and speak your query
• Filter by location — narrow results to a specific room or area
• Filter by category — show only items in a specific category
• Filter by status — in storage, checked out, listed for sale, etc.

People & Lending

Manage a list of people who can borrow your items. The app provides two separate actions: <strong>Check Out</strong> removes an item from its location, while <strong>Lend Out</strong> assigns it to a specific person. The app lists checked-out and lent-out items separately so you always know where everything is.

Check-Out & Lend-Out Workflow

1. From an item's detail screen, tap Check Out to remove the item from its location, or tap Lend Out to assign it to a person
2. For Lend Out, select a person from your contacts or create a new one
3. The item status changes to Checked Out or Lent Out with the person's name displayed
4. To return, tap Check In — the item goes back to In Storage

Event History

Every check-in, check-out, and lend-out is logged with timestamps. View the history from the item's detail screen.

Inventory Tracking

Optionally enable inventory counts on any item — independent of check-in/check-out. Track quantities of consumables, supplies, or anything you keep multiples of.

How It Works

1. When creating or editing an item, toggle Has Inventory
2. Set the initial quantity
3. On the item detail screen, use the + and - buttons to adjust count
4. Tap the number itself to manually set a specific quantity
5. All changes are logged with timestamps in the inventory history

Inventory Reports

Tap the report icon next to the inventory toggle to generate a PDF inventory report. The report includes the item thumbnail, current quantity, and a full change history table. Save or share the PDF via the system share sheet.

Sell & Marketplace Listings

List items for sale on 7 supported marketplaces. AI generates listing details from your item data, and the app produces PDF sell sheets you can reference when posting.

Supported Marketplaces

Listing Workflow

1. Go to the Sell tab and tap New Listing
2. Pick an item from the searchable item picker
3. Select a marketplace
4. AI auto-populates listing fields: title, price, category, condition, and description
5. Each marketplace has its own extra fields (e.g., eBay: brand, UPC, shipping; Poshmark: department, size)
6. Review and edit everything on the review screen
7. Generate a PDF sell sheet — includes item photo, all listing details, and a QR code linking to the marketplace's create-listing page
8. Save to Downloads or Share via AirDrop, email, or messaging

Sales Tracking

Items flow through listing statuses: Listed for Sale → Sold – Not Delivered → Delivered. The sales dashboard shows active listings (including sold-not-delivered items), full sales history, and summary stats with buyer details, pricing, fees, and net proceeds. Generate PDF or CSV sales reports for any date range.

Encryption & Security

Where The Bleep uses zero-knowledge, end-to-end encryption. Your data is encrypted on-device before it ever touches the cloud. We cannot read your data — only you can.

Encryption Details

Key Hierarchy

Your password derives a Master Key (256-bit) via PBKDF2-HMAC-SHA256 (600K iterations). From the master key, three sub-keys are derived:

• DEK (Data Encryption Key) — encrypts item fields, names, descriptions
• FEK (File Encryption Key) — encrypts images and documents in 64 KB chunks
• SIK (Search Index Key) — generates blind indexes for server-side queries

Unlock Options

Brute-Force Protection

Failed password attempts trigger exponential backoff lockouts: 30 seconds → 5 minutes → 15 minutes → 1 hour.

Network Security

• Certificate Transparency monitoring — TOFU TLS certificate tracking for every API endpoint
• Certificate change detection — alerts when a certificate fingerprint changes unexpectedly
• Cleartext traffic blocked on Android — no unencrypted HTTP connections
• Network Diagnostics screen — view certificate issuer, expiry, fingerprint, and change history (Settings > Diagnostics)

Cloud Sync

Where The Bleep is offline-first — it works fully without internet. Cloud sync is optional and available for Pro subscribers.

How Sync Works

• All data is stored locally in SQLite — the app never requires internet
• webDocsSyncFeature2
• Data is encrypted before leaving your device — the server only sees encrypted columns
• Conflict detection — row-level last-write-wins with conflicts logged to the Events audit trail
• Delete propagation — deleting on Device A removes the item on Device B
• Per-user isolation — Row-Level Security ensures you only see your own data
• Marketplace listings and sales are included in sync with encrypted buyer personal information

Multi-Device Login

Sign in on any device using your Supabase account. Your encrypted vault syncs automatically once you log in.

Login Workflow

1. On a new device, open the app and tap Sign In
2. Enter your email and password
3. Enter your 24-word recovery phrase to unlock your encrypted vault
4. Your data syncs automatically from the cloud
5. Your vault is now accessible on the new device

Backup & Restore

Export your entire database and images as an encrypted backup archive. Set a backup password at export time and use it to restore on any device.

Backup Contents

• Full SQLite database
• All item images
• AES-256-GCM encryption with user-set backup password (PBKDF2-derived key)
• JSON manifest for archive integrity verification

Restore Workflow

1. Go to Settings > Backup & Restore
2. Tap Import Backup
3. Select the backup file using the file picker
4. Enter the backup password you set when you created the backup
5. Your data and images are restored

Data Export & Reports

Export your inventory data in multiple formats for insurance claims, personal records, or data portability.

Export Formats

AI-Powered Descriptions

Snap a photo and let AI generate the title, description, and tags for your item. The same AI capability powers marketplace listing generation. You bring your own API key from any of the 8 supported providers.

Supported AI Providers

Setup

1. Go to Settings > AI Provider
2. Select your preferred provider
3. Enter your API key
4. Optionally change the default model
5. When adding or editing items, tap the AI camera button to use it

Note: Your API key is stored on-device only and is never sent to our servers. AI requests go directly from your device to the provider.

Settings

The Settings screen is your control center for encryption, sync, AI configuration, data export, and account management.

Settings Sections

Subscriptions

Where The Bleep offers a generous free tier with all core features. Pro unlocks cloud sync, automatic backups, and priority support.

Plans

Subscriptions are managed through the App Store (iOS) or Google Play (Android). You can cancel anytime from your device's subscription settings.