K
KDEV
Need help?

KetMail Mobile App

Complete documentation for the KetMail mobile application. Learn how to integrate with Auth2.0 authentication system and KetMail backend for professional email services.

Get StartedAPI IntegrationIntegration Guide

Quick Start

Get the KetMail mobile app up and running in minutes

1. Start Servers

cd Auth2.0 && npm start
cd ketmail && npm start

2. Setup Mobile App

cd ketmail/mobile-app
npm install

3. Run App

npm start
Press 'a' for Android, 'i' for iOS

Features

Comprehensive email management with enterprise-grade security

Auth2.0 Integration

  • User registration & login
  • Email verification
  • Two-factor authentication
  • Device tracking

Email Management

  • Create @ketmail.in accounts
  • Multiple domain support
  • Account settings
  • Storage management

Security Features

  • Biometric authentication
  • Encrypted storage
  • Suspicious activity detection
  • Session management

API Integration

Complete integration with Auth2.0 and KetMail backend

Auth2.0 API Endpoints

POST /api/auth/login

User authentication with device tracking

POST /api/auth/register

User registration with email verification

POST /api/auth/verify-2fa

Two-factor authentication verification

GET /api/auth/me

Get current user profile

KetMail API Endpoints

POST /api/email-accounts

Create new email account

GET /api/email-accounts

List user's email accounts

PUT /api/email-accounts/:id

Update email account settings

GET /api/domains

Get available domains

Authentication Flow

Complete user authentication and email account creation process

Registration

  1. 1User enters personal information
  2. 2App sends registration to Auth2.0
  3. 3Verification email sent
  4. 4User verifies email
  5. 5Account activated

Login

  1. 1User enters credentials
  2. 2App validates with Auth2.0
  3. 32FA required if enabled
  4. 4Token stored securely
  5. 5User redirected to app

Email Creation

  1. 1User selects username
  2. 2Check availability
  3. 3Create via KetMail API
  4. 4Account associated
  5. 5Ready to use

Configuration

Setup and configuration options for the mobile app

Environment Variables

EXPO_PUBLIC_AUTH_API_URL=http://localhost:3000

Auth2.0 server URL

EXPO_PUBLIC_KETMAIL_API_URL=http://localhost:5000

KetMail server URL

App Configuration

Default Domain

ketmail.in

Storage Limit

10GB per account

Session Timeout

24 hours

Troubleshooting

Common issues and solutions

API Connection Errors

  • • Check server URLs in configuration
  • • Verify servers are running
  • • Check network connectivity
  • • Ensure ports are accessible

Authentication Issues

  • • Clear app storage
  • • Check token expiration
  • • Verify Auth2.0 server status
  • • Check email verification status

Email Creation Failures

  • • Check KetMail server status
  • • Verify domain availability
  • • Check username availability
  • • Ensure user is authenticated

Build Errors

  • • Clear npm cache
  • • Delete node_modules and reinstall
  • • Update Expo SDK if needed
  • • Check dependency conflicts

Ready to Get Started?

Set up your KetMail mobile app today and experience professional email management with enterprise-grade security.

View DashboardAPI Documentation