Beta Testing Guide

Thank you for helping test Stuffolio! Your feedback shapes the app before public release.

Getting Started

Install via TestFlight

1. Install Apple's TestFlight app on your iPhone, iPad, or Mac.
2. Tap the Stuffolio beta invite link.
3. Install Stuffolio and start testing!

First Steps

• Add a few items — Start with 3-5 items you know well (electronics, appliances, tools)
• Try the new Add Item flow — Choose Photo (AI-assisted), Barcode, or Manual entry
• Enable iCloud sync (optional) — Test syncing between devices if you have multiple Apple devices
• Explore AI assistance — Try Stuff Scout, AI Product Assistant, and the new Current Price lookup (runs only when you ask)

What to Test

Focus your testing on these priority areas:

AI assistance when you ask — silent when you don’t.

Stuffolio includes AI assistance that runs only when you explicitly request it. There is no background analysis, no passive monitoring, and no automatic data sharing.

New in Build 26

This build focuses on accessibility, stability, and security hardening ahead of App Store submission.

Accessibility Overhaul

• Dynamic Type support across the entire app — all text now scales with iOS text size settings
• Reduce Motion support — animations automatically simplify when Reduce Motion is enabled in Settings
• VoiceOver improvements — labels, hints, and traits audited and corrected throughout
• Try Settings → Accessibility → Display & Text Size → Larger Text and verify the app remains readable at maximum size
• Try Settings → Accessibility → Motion → Reduce Motion and verify transitions feel calmer

Bug Fix: Legacy Wishes Beneficiary Deletion

• Fixed a bug where deleting a beneficiary in Legacy Wishes would silently fail, leaving the beneficiary visible in the list
• Beneficiaries now delete correctly and are removed from any existing assignments

Reliability Improvements

• Improved error handling for JSON parsing failures — the app now recovers gracefully instead of showing a blank screen
• Schema stability improvements — in-memory data model operations are more robust during edge-case operations

Security

• App Attest verification added to AI endpoints — requests are now cryptographically attested to originate from a genuine Stuffolio installation

Still Worth Testing from Earlier Builds

• Dashboard: Refreshed icon set, warranty expiry dates, tile navigation
• Repair Advisor: Try with damaged items, look for confidence levels and data-driven recommendations
• Encrypted Backups: Settings → Backup → toggle "Encrypt with password"
• Send to Apps: Tap Notes, Calendar, or Reminders chips on any item
• Scan Depth Options: Try Quick ID, With Pricing, and Full Appraisal in Stuff Scout
• Data Tools: Data Cleanup, Batch Categorize, Bulk Price Update

Testing Checklist

Use this checklist to ensure comprehensive coverage:

Core Functionality

• Add items using all 3 methods (Photo, Barcode, Manual)
• Test Photo mode — verify form appears immediately while AI loads
• Verify AI fields fill in automatically after photo analysis
• Edit item details and verify changes save
• Delete an item and confirm it's removed
• Delete an item with photos attached — verify no crash
• Search for items by name, category, location
• Filter items using the filter menu
• Export inventory to CSV, PDF, or Excel

Backup & Security

• Create a plain (unencrypted) backup and verify restore
• Create an encrypted backup with password
• Verify encrypted file has .stuffolio extension
• Restore encrypted backup — verify password prompt appears
• Try wrong password — verify error message
• Restore with correct password — verify data integrity

Family Sharing

• Create a shared household
• Invite a family member as Editor
• As Editor, try to delete an item you didn't create
• Verify deletion is blocked with clear message
• As Admin, verify you can delete any shared item
• Verify item creator can always delete their own items

Price Watch

• Enable Price Watch on an item
• Add a price manually
• Set a price alert with target price
• View price history chart
• Use AI "Current Price" to fetch prices
• Apply Stuff Scout value to Price Watch

AI Features

• Use Stuff Scout to identify an item from photo
• Test Scan Depth: Quick ID (~15s)
• Test Scan Depth: With Pricing (~25s)
• Test Scan Depth: Full Appraisal (~40s)
• Refine Scout results with additional details
• Use AI Product Assistant for manual/parts lookup
• Try Current Price query
• Verify AI response caching works offline

Data Tools

• Run Data Cleanup analysis on your inventory
• Check quality scores for different categories
• Use Batch Categorize on uncategorized items
• Verify keyword matching suggestions
• Use Bulk Price Update with percentage adjustment
• Use Bulk Price Update with AI lookup
• Test Photo Optimizer on large photos
• Verify optimized photos maintain quality

Accessibility

• Go to Settings → Accessibility → Display & Text Size → Larger Text and drag to maximum
• Navigate the item list and detail views — verify text is readable and nothing is clipped
• Enable Settings → Accessibility → Motion → Reduce Motion
• Navigate between screens — verify transitions feel calm (no large spring animations)
• Enable VoiceOver (Settings → Accessibility → VoiceOver)
• Swipe through buttons and labels on the Dashboard — verify each announces its purpose
• Disable VoiceOver when done (triple-click side button if shortcut is set up)

Legacy Wishes

• Enable Legacy Wishes in Settings
• Add at least 2 beneficiaries
• Delete one beneficiary — verify they disappear from the list
• Assign items to remaining beneficiaries
• Set contingency recipients
• Test sharing via CloudKit (if family available)
• Export Legacy Wishes as PDF

Repair Advisor & AppleCare+

• Open Repair Advisor from Dashboard — check recommendations use your real item data
• If you have one damaged item, verify it skips the picker and opens directly
• Look for confidence levels (High, Medium, Exploratory) on recommendations
• Open AppleCare+ Tracking from Dashboard
• If you have one Apple product, verify it opens the editor directly
• Edit AppleCare+ incidents, fees, and dates from the direct editor

Go To (⌘K)

• Open Go To and search for "Value Calculator" — verify it opens directly
• Search for "Settings" — verify it opens Settings directly
• Search for "Depreciation" — verify it opens the tracker directly
• Search for "Cloud Sync" — verify it opens sync settings directly
• Navigate to a section (like My Products or Dashboard) via Go To

Sync & Multi-Device

• Enable iCloud sync
• Add item on one device, verify it appears on another
• Verify photos sync correctly between devices
• Check for duplicates after syncing
• Edit same item on two devices, test conflict resolution
• Test with airplane mode / offline usage
• When inventory is empty, check that an "Enable iCloud Sync" option appears

How to Report Feedback

What to Include in Bug Reports

• What you were doing — Steps to reproduce the issue
• What you expected — The behavior you expected
• What actually happened — The actual result (crash, error, wrong data, etc.)
• Device info — iPhone/iPad/Mac model, iOS/macOS version
• Screenshots/screen recordings — Visual evidence is extremely helpful

Feature Requests

Have an idea for Stuffolio? Tell us:

• What problem are you trying to solve?
• How do you currently work around it?
• How would the ideal solution work?

Known Issues

These issues are already identified and being worked on:

• Price Watch charts — Charts may flicker briefly when first loading on older devices
• iPad rotation — Rotating between portrait and landscape can reset navigation state (e.g., the sidebar collapses unexpectedly). This is a known layout issue being addressed for the next build.
• Offline AI caching — Cached responses occasionally show stale provider info
• Go To on macOS — Some features already had direct access on macOS; Go To improvements primarily affect iOS

You don't need to report these — we're already on it!

Beta Tester Expectations

What We Ask of You

• Use the app regularly — Daily or weekly usage helps find real-world issues
• Report issues promptly — The sooner we know, the sooner we can fix
• Keep the app updated — Install new beta builds when available
• Be patient — Beta software has bugs; that's why we're testing
• Keep it confidential — Don't share screenshots or details publicly until launch

What You Can Expect from Us

• Regular updates — New builds every 1-2 weeks during active development
• Responsiveness — We read every piece of feedback
• Credit — Beta testers who contribute significantly will be acknowledged
• Transparency — We'll share what we're working on and why

Resources

• Quick Start Guide — Get up and running fast
• Features Overview — See everything Stuffolio can do
• App Map — Visual guide to all screens and features
• What's New — Changelog for each build
• Support & FAQ — Common questions answered
• Full User Manual — Complete reference

Thank You!

Your testing helps make Stuffolio better for everyone. We genuinely appreciate your time and feedback.

— The Stuffolio Team