SMS Mobile App documentation

An Android-first SMS automation app that sends user-authored text messages from your phone's own SIM card. Schedule one-off reminders and recurring sends, compose from reusable templates, and coordinate everything from a Firebase-backed dashboard. Recipients see your real mobile number. No cloud SMS gateway. You pay only what your carrier charges for an SMS.

This site is the official, comprehensive product manual. The marketing site lives at smsapp.aoneahsan.com; install from Google Play; the source for these docs is public at github.com/aoneahsan/smsapp-docs. The product's own source remains private.

:::info Current release (what ships today)

The version on Google Play today sends each message through your own SMS app: SMS Mobile App pre-fills the recipient and text, and you tap Send, so the message leaves from your SIM. This release requests no SEND_SMS permission and is not a default SMS handler.

The silent / unattended send, automated bulk batches, and the volunteer device pool described below are paused in the current release. They depend on the restricted SEND_SMS permission plus a Google Play "Device automation" review, and return in a later version. The code stays in the app behind a single feature flag (FEATURE_SILENT_BULK_SMS) — nothing is deleted, so this documentation stays accurate for when it returns.

What works today with no restricted permission: compose and send (through your SMS app), drafts, templates, quick replies, the optional contact picker, and foreground scheduling that opens the composer for a due message while the app is open.

:::

Where to start

Tutorials

End-to-end lessons. Sign in, register your Android device, send your first scheduled SMS in five minutes.

If you're new — start here

How-to guides

Eighteen recipes for specific tasks: send a silent batch, schedule a weekly recurring SMS, switch SIM on dual-SIM phones, handle failures.

If you have a specific problem

Reference

Exhaustive lookup — every route, every permission, every Firestore field, every config knob, every rate-limit number.

If you need exact details

Explanation

Why Android-only, how the volunteer pool works, the privacy posture, the Play Store compliance runbook — design rationale in essay form.

If you want to understand WHY

If you're not sure which one to open first, Get started in 5 minutes is the friendliest path.

At a glance

Platforms	Web dashboard + Android app. (No browser extension.)
SMS transport	Current release: opens your own SMS app — you tap Send, so it leaves from your SIM with no cloud gateway. A later release adds native SmsManager silent send.
Cost	Free for individuals. Carrier's standard SMS rate per message.
Permissions	Current release: no restricted permission. READ_CONTACTS optional (recipient autocomplete). SEND_SMS returns with the future silent-send release.
Auth	Sign in with Google.
Data	Firestore for jobs, devices, drafts, templates. Files via FilesHub.
iOS	Web dashboard works. Native send is Android-only.

Honest framing — what this app isn't

A few things competitors fudge but this app is straightforward about:

• We are not a default SMS handler. Android reserves features like reading the inbox or replying inline for the default SMS app. SMS Mobile App is purposely a sender, not a replacement messaging app.
• Carrier rates still apply. "Free" means we don't charge per message. Your carrier still does.
• iOS is a web-dashboard experience only. iOS does not expose a programmatic SMS sender; the actual sending happens on Android devices.
• The volunteer device pool and bulk batches are paused in the current release. They depend on the restricted SEND_SMS permission and return in a later version — today every send goes through your own SMS app. See How the volunteer device pool works for how it behaves when re-enabled.

Built by

The product, the docs, and the Android plugin behind silent send are all written and maintained by Ahsan Mahmood — a senior software engineer focused on cross-platform mobile and web (React, Capacitor, Firebase). Portfolio · LinkedIn · GitHub · aoneahsan@gmail.com.

If these docs help, the kindest thing you can do is link to them from your own writing — backlinks are how this small project becomes findable.