Stop Shipping Perfect Demos. Start Shipping Honest Limitations.

Description and use

PhoneHands showcases honest limitations by publishing a problem list, passing tests, and a transparent demo, improving trust and reducing hidden debt.

Problem

Developers often ship demos that hide limitations, leading to trust erosion and hidden technical debt.

Outcome

PhoneHands achieved 190 green tests, 91–98% coverage, and a demo that transparently shows limitations, fostering trust and reducing hidden debt.

Workflow

• 1. Identify six key limitations (physical reach, API fragility, signing tax, self‑drawn UIs, credentials, cloud relays).
• 2. Document each limitation and its solution or admission in the README.
• 3. Build eight packages with 190 passing tests and 91–98% coverage.
• 4. Run CI on iOS and Android, fixing failures incrementally (hardcoded bundle ID, missing library, permissions).
• 5. Record demo video showing real API reads, a 403, automatic downgrade, and device reads.
• 6. Publish README and demo with honest limitations before shipping features.
• 7. Await real‑device verification before final release.

Evidence

true wireless is impossible, and this tool doesn't pretend otherwise.

Source

190 tests, all green, across eight packages. Coverage between 91 and 98 percent.

Source

The demo video's first version got rejected — by me — for a black first frame and a look that wasn't good enough.

Source

Six problems, six answers or honest admissions. That list is the real deliverable.

Source