eSIM Management Guide

What is eSIM Management?

eSIM Management is a global eSIM management platform built for telecom operators, IoT providers, and enterprises. It simplifies eSIM profile deployment, management, and monitoring at scale — from a single dashboard or via REST API.

Key Features

Profile Lifecycle Management

Create, deploy, activate, suspend, and delete eSIM profiles through an intuitive dashboard or REST API. Every operation is tracked with a full audit trail.

• Bulk profile operations
• Scheduled activations and deactivations
• Profile templates for rapid deployment

Global Carrier Coverage

Access hundreds of carriers across 200+ countries through our GSMA-compliant SM-DP+ platform.

• Automatic network selection based on location, signal strength, and cost
• Real-time carrier status and availability
• Multi-IMSI support for optimal connectivity

IoT Fleet Management

Monitor and manage thousands of IoT devices from a single dashboard.

• Device grouping and tagging
• Policy-based automated profile switching
• Bulk operations across device fleets

Real-Time Monitoring

Track connectivity status, data usage, and profile health in real-time.

• Customizable alerts for anomalies and usage thresholds
• Historical data and trend analysis
• Exportable reports (CSV, PDF)

Tech Stack

• Framework: Next.js App Router with TypeScript
• Auth: Better Auth (GitHub + Google OAuth, email/password)
• Database: PostgreSQL with Drizzle ORM
• Payments: Stripe (subscriptions, one-time purchases, credit packages)
• UI: Tailwind CSS + Radix UI + Lucide icons
• i18n: next-intl (English + Chinese)
• Email: Resend with React Email templates

Getting Started

Prerequisites

• Node.js 18+
• pnpm (recommended)
• PostgreSQL database

Quick Start

git clone <repository-url>
cd esim-management
pnpm install
cp env.example .env
pnpm db:generate
pnpm db:migrate
pnpm dev

Visit http://localhost:3000 to see your eSIM Management app.

Environment Setup

Key environment variables:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/esim-management

# Auth
BETTER_AUTH_SECRET=your-secret-key
GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret

# Stripe
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# AI (DeepSeek)
DEEPSEEK_API_KEY=sk-...

API Reference

eSIM Management provides a full-featured REST API for programmatic access to all platform features.

Authentication

All API requests require an API key passed in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Create and manage API keys from your dashboard under Settings > API Keys.

Core Endpoints

Full API documentation is available in the OpenAPI 3.1 specification, accessible from your dashboard.

Plans & Pricing

View the full pricing page for details.

Support

• Email: support@esimmanagement.net
• Documentation: docs
• API Reference: Available in your dashboard