MockSMS is a full-stack developer tool that simulates SMS delivery — just like Mailhog or Mailtrap do for emails. No real SMS APIs are used — all messages are stored and displayed in a developer dashboard, with support for sending OTPs and verifying them.

🚫 No actual SMS is sent. Use it for development & testing environments.

👉 Open MockSMS Dashboard

⚠️ Hosted on free Render + Vercel tiers. May take a few seconds to wake up on first request.

1. Visit the Live Dashboard
2. Create an account and log in
3. A default project will be created automatically
4. Go to "Projects → API Keys" to view your API key
5. Use that API key to call the public APIs from your apps (see below)
6. View all messages (SMS + OTPs) in your dashboard for each project

• ✅ Simulated SMS inbox per project
• ✅ JWT-based auth with refresh + access token
• ✅ REST APIs for sending generic SMS, OTP, and verifying OTP
• ✅ Messages auto-expire after 24 hours
• ✅ Manual delete support
• ✅ Modern developer UI with project & key management

Use your API key in headers to test SMS flows from your own apps.

📍 Base URL:

https://mock-sms-backend.onrender.com/api

POST /message/send

x-api-key: your_project_api_key
Content-Type: application/json

{
  "from": "sender_phone_number",
  "to": "recipient_phone_number",
  "body": "Message content here",
  "metadata": {
    "custom": "optional fields"
  }
}

POST /message/send-otp

x-api-key: your_project_api_key
Content-Type: application/json

{
  "phone": "recipient_phone_number",
  "purpose": "login_verification" // optional
}

💬 The OTP will be saved as a message in your MockSMS inbox.

POST /message/verify-otp

x-api-key: your_project_api_key
Content-Type: application/json

{
  "phone": "recipient_phone_number",
  "code": "812704"
}

• User login gives access token (used for API calls) and refresh token (stored in httpOnly cookie).
• APIs like /projects and /message/:id require login.
• External SMS APIs use only the API key, no login required.

mocksms/
├── client/       # Vite + React frontend
└── server/       # Node.js + Express backend

git clone [https://github.com/your-username/mocksms.git](https://github.com/aditya241104/Mock-SMS/tree/main)
cd mocksms

cd client

VITE_BASE_URL=https://mock-sms-backend.onrender.com/api

npm install

npm run dev

cd server

PORT=
MONGO_URI=
JWT_ACCESS_SECRET=
JWT_REFRESH_SECRET=
JWT_ACCESS_EXPIRE=
JWT_REFRESH_EXPIRE=

npm install

# Using nodemon
nodemon index.js

# Or plain node
node index.js

• ⏳ Auto-deleted after 24 hours
• 🗑️ Manual deletion supported from the dashboard

• Real-time updates via WebSocket
• OTP attempt rate limiting
• Project-based webhooks
• OTP delivery simulation timeline
• Multi-user collaboration per project

• Frontend: React + Vite + TailwindCSS
• Backend: Node.js + Express
• DB: MongoDB (Mongoose)
• Auth: JWT (access + refresh token)
• Deployment: Render (backend) + Vercel (frontend)