SMSHub

A multi-platform, real-time SMS messaging platform with unified inbox, multi-provider support (Twilio + Telnyx), and an API-first architecture.

🚀 Coming Soon: phonenumbers.bot — Real SIM phone numbers with a developer-first API

Platforms

Platform	Tech	Status
🌐 Web	Next.js 16 (App Router)	✅ v1
📲 PWA	Service Worker + Manifest	✅ v1
📱 iOS	React Native (Expo)	✅ v1
🤖 Android	React Native (Expo)	✅ v1
🖥 Desktop	Electron	✅ v1
⌨️ CLI / TUI / MCP	smshub-cli (cli/)	✅ v1

Install the CLI (rent numbers, read texts and codes from a terminal or an agent):

curl -fsSL https://smshub.dev/cli/install.sh | sh

https://smshub.dev/install.sh stays the desktop app installer.

Features

• Unified Inbox — Threaded conversations across all devices
• Real-time Messaging — Sub-second updates via Supabase Realtime
• Multi-Provider — Twilio + Telnyx with unified API (sendSMS())
• Compose Flow — New message modal with sender number picker
• Unread Tracking — Badge counts, auto-mark read on open
• Search — Filter conversations by name or phone number
• Contact Management — Auto-create on inbound, inline name editing
• Delivery Receipts — Live status updates (queued → sent → delivered → failed)
• Keyboard Shortcuts — Ctrl+N (compose), Ctrl+K (search), arrows, Escape
• Push Notifications — Native on mobile (Expo), OS notifications on desktop (Electron)
• PWA — Installable, offline support, background sync
• Dark Mode — Default, developer-focused UI

Tech Stack

Layer	Technology
Frontend	Next.js 16, React 19, TailwindCSS
Mobile	React Native, Expo, expo-router
Desktop	Electron, electron-builder
Backend	Next.js API routes
Database	Supabase (Postgres + Realtime + Auth + RLS)
Providers	Twilio, Telnyx
Testing	Vitest (110 tests), Playwright e2e
CI	Husky pre-commit (tests + typecheck + lint)
Mobile Deploy	Expo EAS (expo.dev)
Desktop Build	electron-builder (AppImage, dmg, NSIS)

Getting Started

Prerequisites

• Bun 1.4 (package manager and runtime for the web app)
• pnpm (for mobile/ and electron/ only)
• A Supabase project
• Twilio and/or Telnyx account(s)

Setup

# Install dependencies
bun install

# Copy env file and fill in your values
cp .env.example .env

# Run database migrations against your Supabase project
# (paste supabase/migrations/*.sql into the Supabase SQL editor)

# Start dev server
bun dev

Mobile (Expo)

cd mobile
pnpm install
npx expo start

# Build for iOS/Android via Expo EAS
eas build --profile production --platform all

Desktop (Electron)

cd electron
pnpm install
pnpm dev

# Package distributable
pnpm package

Environment Variables

Variable	Description
NEXT_PUBLIC_SUPABASE_URL	Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY	Supabase anon/public key
SUPABASE_SERVICE_ROLE_KEY	Supabase service role key (server-only)
TWILIO_ACCOUNT_SID	Twilio Account SID
TWILIO_AUTH_TOKEN	Twilio Auth Token
TELNYX_API_KEY	Telnyx API Key
TELNYX_PUBLIC_KEY	Telnyx Public Key (webhook verification)
NEXT_PUBLIC_APP_URL	App URL (default: http://localhost:3000)

This is the beginning of the README. Read the rest at the original. Read the full README ↗