{"id":47599303,"url":"https://github.com/profullstack/smshub","last_synced_at":"2026-04-01T18:37:14.352Z","repository":{"id":345497706,"uuid":"1185981673","full_name":"profullstack/smshub","owner":"profullstack","description":"A multi-platform, real-time SMS messaging platform with unified inbox, multi-provider support (Twilio + Telnyx), and an API-first architecture.","archived":false,"fork":false,"pushed_at":"2026-03-29T12:21:01.000Z","size":101924,"stargazers_count":1,"open_issues_count":19,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-29T15:28:44.675Z","etag":null,"topics":["api","sms","telnyx","twilio"],"latest_commit_sha":null,"homepage":"https://smshub.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/profullstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-19T06:19:51.000Z","updated_at":"2026-03-29T12:19:37.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/profullstack/smshub","commit_stats":null,"previous_names":["profullstack/smshub"],"tags_count":40,"template":false,"template_full_name":null,"purl":"pkg:github/profullstack/smshub","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fsmshub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fsmshub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fsmshub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fsmshub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/profullstack","download_url":"https://codeload.github.com/profullstack/smshub/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/profullstack%2Fsmshub/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290911,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","sms","telnyx","twilio"],"created_at":"2026-04-01T18:37:13.280Z","updated_at":"2026-04-01T18:37:14.338Z","avatar_url":"https://github.com/profullstack.png","language":"TypeScript","readme":"# SMSHub\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./public/banner.png\" alt=\"SMSHub logo\"  /\u003e\n\u003c/p\u003e\n\n[![Next.js](https://img.shields.io/badge/Next.js-16-black?logo=next.js)](https://nextjs.org/)\n[![React](https://img.shields.io/badge/React-19-61DAFB?logo=react\u0026logoColor=white)](https://react.dev/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript\u0026logoColor=white)](https://typescriptlang.org/)\n[![Supabase](https://img.shields.io/badge/Supabase-Postgres%20%2B%20Realtime-3FCF8E?logo=supabase\u0026logoColor=white)](https://supabase.com/)\n[![Expo](https://img.shields.io/badge/Expo-React%20Native-000020?logo=expo\u0026logoColor=white)](https://expo.dev/)\n[![Electron](https://img.shields.io/badge/Electron-Desktop-47848F?logo=electron\u0026logoColor=white)](https://electronjs.org/)\n[![Vitest](https://img.shields.io/badge/Tests-103%20passing-6E9F18?logo=vitest\u0026logoColor=white)](https://vitest.dev/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n\nA multi-platform, real-time SMS messaging platform with unified inbox, multi-provider support (Twilio + Telnyx), and an API-first architecture.\n\n\u003e **🚀 Coming Soon:** [phonenumbers.bot](https://phonenumbers.bot) — Real SIM phone numbers with a developer-first API\n\n## Platforms\n\n| Platform | Tech | Status |\n|---|---|---|\n| 🌐 Web | Next.js 16 (App Router) | ✅ v1 |\n| 📲 PWA | Service Worker + Manifest | ✅ v1 |\n| 📱 iOS | React Native (Expo) | ✅ v1 |\n| 🤖 Android | React Native (Expo) | ✅ v1 |\n| 🖥 Desktop | Electron | ✅ v1 |\n\n## Features\n\n- **Unified Inbox** — Threaded conversations across all devices\n- **Real-time Messaging** — Sub-second updates via Supabase Realtime\n- **Multi-Provider** — Twilio + Telnyx with unified API (`sendSMS()`)\n- **Compose Flow** — New message modal with sender number picker\n- **Unread Tracking** — Badge counts, auto-mark read on open\n- **Search** — Filter conversations by name or phone number\n- **Contact Management** — Auto-create on inbound, inline name editing\n- **Delivery Receipts** — Live status updates (queued → sent → delivered → failed)\n- **Keyboard Shortcuts** — Ctrl+N (compose), Ctrl+K (search), arrows, Escape\n- **Push Notifications** — Native on mobile (Expo), OS notifications on desktop (Electron)\n- **PWA** — Installable, offline support, background sync\n- **Dark Mode** — Default, developer-focused UI\n\n## Tech Stack\n\n| Layer | Technology |\n|---|---|\n| Frontend | Next.js 16, React 19, TailwindCSS |\n| Mobile | React Native, Expo, expo-router |\n| Desktop | Electron, electron-builder |\n| Backend | Next.js API routes |\n| Database | Supabase (Postgres + Realtime + Auth + RLS) |\n| Providers | Twilio, Telnyx |\n| Testing | Vitest (48 tests) |\n| CI | Husky pre-commit (tests + typecheck + lint) |\n| Mobile Deploy | Expo EAS (expo.dev) |\n| Desktop Build | electron-builder (AppImage, dmg, NSIS) |\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js 22+\n- pnpm\n- A [Supabase](https://supabase.com) project\n- Twilio and/or Telnyx account(s)\n\n### Setup\n\n```bash\n# Install dependencies\npnpm install\n\n# Copy env file and fill in your values\ncp .env.example .env\n\n# Run database migrations against your Supabase project\n# (paste supabase/migrations/*.sql into the Supabase SQL editor)\n\n# Start dev server\npnpm dev\n```\n\n### Mobile (Expo)\n\n```bash\ncd mobile\npnpm install\nnpx expo start\n\n# Build for iOS/Android via Expo EAS\neas build --profile production --platform all\n```\n\n### Desktop (Electron)\n\n```bash\ncd electron\npnpm install\npnpm dev\n\n# Package distributable\npnpm package\n```\n\n### Environment Variables\n\n| Variable | Description |\n|---|---|\n| `NEXT_PUBLIC_SUPABASE_URL` | Supabase project URL |\n| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase anon/public key |\n| `SUPABASE_SERVICE_ROLE_KEY` | Supabase service role key (server-only) |\n| `TWILIO_ACCOUNT_SID` | Twilio Account SID |\n| `TWILIO_AUTH_TOKEN` | Twilio Auth Token |\n| `TELNYX_API_KEY` | Telnyx API Key |\n| `TELNYX_PUBLIC_KEY` | Telnyx Public Key (webhook verification) |\n| `NEXT_PUBLIC_APP_URL` | App URL (default: `http://localhost:3000`) |\n\n## Project Structure\n\n```\nsrc/                          # Web app (Next.js)\n├── app/\n│   ├── api/\n│   │   ├── contacts/         # GET, PATCH /api/contacts/[id]\n│   │   ├── conversations/    # GET, POST /api/conversations/[id]/read\n│   │   ├── messages/         # GET, POST /api/messages/send\n│   │   ├── providers/        # DELETE /api/providers/[id]\n│   │   ├── phone-numbers/    # DELETE /api/phone-numbers/[id]\n│   │   └── webhooks/         # Twilio + Telnyx inbound \u0026 status callbacks\n│   ├── login/                # Login page\n│   ├── register/             # Register page\n│   ├── settings/             # Provider \u0026 phone number management\n│   ├── phonenumbers/         # phonenumbers.bot coming soon page\n│   └── offline/              # PWA offline fallback\n├── components/\n│   ├── inbox-client.tsx      # Main inbox (sidebar + chat + realtime)\n│   ├── new-message-modal.tsx # Compose new conversation\n│   ├── contact-name-editor.tsx\n│   ├── toast-container.tsx   # Toast notifications\n│   └── sw-register.tsx       # Service worker registration\n├── contexts/\n│   └── toast-context.tsx     # Global toast state\n├── lib/\n│   ├── providers/            # Twilio + Telnyx unified layer\n│   ├── supabase/             # Client/server/middleware helpers\n│   └── types/                # TypeScript definitions\n├── middleware.ts              # Auth guard\nmobile/                        # React Native (Expo)\n├── app/                       # expo-router screens\n│   ├── (tabs)/                # Inbox + Settings tabs\n│   ├── chat/[id].tsx          # Chat screen\n│   └── auth.tsx               # Login/register\n├── lib/                       # Supabase, API client, notifications\n└── eas.json                   # Expo EAS build profiles\nelectron/                      # Desktop app\n├── main.ts                    # Window + tray + IPC\n├── preload.ts                 # Renderer bridge\n├── notifications.ts           # Supabase Realtime → OS notifications\n├── updater.ts                 # Auto-updater\n└── electron-builder.yml       # Build config\nsupabase/\n└── migrations/                # 001_initial_schema + 002_unread_tracking\n```\n\n## API Endpoints\n\n| Method | Endpoint | Description |\n|---|---|---|\n| `POST` | `/api/messages/send` | Send an SMS |\n| `GET` | `/api/messages?conversation_id=` | Get messages for a conversation |\n| `GET` | `/api/conversations` | List conversations |\n| `POST` | `/api/conversations/[id]/read` | Mark conversation as read |\n| `GET` | `/api/contacts` | List contacts |\n| `PATCH` | `/api/contacts/[id]` | Update contact name |\n| `DELETE` | `/api/providers/[id]` | Delete a provider |\n| `DELETE` | `/api/phone-numbers/[id]` | Delete a phone number |\n| `POST` | `/api/webhooks/twilio` | Twilio inbound webhook |\n| `POST` | `/api/webhooks/telnyx` | Telnyx inbound webhook |\n| `POST` | `/api/webhooks/twilio/status` | Twilio delivery status callback |\n| `POST` | `/api/webhooks/telnyx/status` | Telnyx delivery status callback |\n\n## Scripts\n\n```bash\npnpm dev              # Start development server\npnpm build            # Production build\npnpm start            # Start production server\npnpm test             # Run tests (48 passing)\npnpm test:watch       # Run tests in watch mode\npnpm test:coverage    # Run tests with coverage\npnpm lint             # Lint source files\npnpm typecheck        # TypeScript type checking\n```\n\n## Pre-commit Hook\n\nEvery commit automatically runs:\n1. 🧪 **Tests** — `vitest run`\n2. 🔍 **Type check** — `tsc --noEmit`\n3. ✨ **Lint** — `eslint --fix` on staged `.ts/.tsx` files\n\n## Database Schema\n\nTables: `providers`, `phone_numbers`, `contacts`, `conversations`, `messages`\n\n- Row Level Security (RLS) on all tables\n- Realtime enabled on `messages` and `conversations`\n- Unread tracking via `last_read_at` + computed count\n\nSee `supabase/migrations/` for the full schema.\n\n## Contributing\n\nPRs welcome! Please ensure all checks pass before submitting:\n\n```bash\npnpm test \u0026\u0026 pnpm tsc --noEmit \u0026\u0026 pnpm lint\n```\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofullstack%2Fsmshub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprofullstack%2Fsmshub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprofullstack%2Fsmshub/lists"}