# SMSApp documentation

> Public documentation for an owner-operated Android SMS dispatch system with a web administration panel.

The Android app `com.aoneahsan.smsapp` version 1.7.0 is live on Google Play as "SMS Mobile App": https://play.google.com/store/apps/details?id=com.aoneahsan.smsapp. The web admin prepares and monitors jobs.

## Product contract

- One selected, owner-managed Android phone per job.
- Enrollment is explicit and off by default.
- The phone sends through one configured default SMS subscription.
- Recipient sources are that phone's completed contact sync or a UTF-8 CSV up to 5 MiB.
- A job contains at most 5,000 unique eligible recipients.
- Only ordinary Pakistani mobile numbers in `030`–`036` are eligible.
- Foreign, landline, short, service/premium, malformed, and unrecognized destinations are excluded without override.
- Firebase coordinates authenticated state; it is not an SMS gateway.
- The app never reads received SMS and is not a default SMS handler.
- Android sent callbacks do not guarantee carrier delivery. Uncertain outcomes need owner reconciliation.
- Carrier charges, consent obligations, and platform limits still apply.

## Documentation map

- Introduction: https://smsapp-docs.aoneahsan.com/
- Tutorials: https://smsapp-docs.aoneahsan.com/tutorials
- How-to guides: https://smsapp-docs.aoneahsan.com/how-to
- Reference: https://smsapp-docs.aoneahsan.com/reference
- Explanation: https://smsapp-docs.aoneahsan.com/explanation
- Sitemap: https://smsapp-docs.aoneahsan.com/sitemap
- Feed (RSS): https://smsapp-docs.aoneahsan.com/feed.xml
- Public repository: https://github.com/aoneahsan/smsapp-docs