Deepline

100% Built by Claude

The world's first production-grade secure messenger written entirely by AI.

"Human says what to build. Claude writes every line of code."

Features | Quick Start | Architecture | Contributing

All Done by Claude

Every. Single. Line.

This isn't "AI-assisted" development. This is AI-authored development. From the Ktor server routes to the Kotlin Multiplatform shared module to the SwiftUI views — Claude wrote it all.

29,000+ lines of code
    147 files
      0 lines written by human hands

What the Human Does

Describes what to build in natural language
Reviews and approves changes
Tests on real devices
Makes product decisions

What Claude Does

Writes all Kotlin, Swift, SQL, and config files
Designs the architecture
Implements features across server + Android + iOS
Fixes bugs and refactors code
Writes tests and documentation

Why This Matters

Proof of concept: Production-quality apps can be fully AI-generated
Real security: Signal Protocol + MLS for E2EE — no toy crypto
Native performance: Kotlin Multiplatform + SwiftUI, zero compromises
Full transparency: Every commit shows AI-generated code

Features

End-to-End Encryption — Signal Protocol for 1:1, MLS for groups (platform-native bindings)
Real-Time Messaging — WebSocket delivery with sub-100ms latency
Push Notifications — FCM (Android) + APNs (iOS) for background alerts
Encrypted Attachments — Files encrypted client-side, stored as opaque blobs
Group Chats — Up to 1000 members with role-based permissions
Read Receipts — Per-message delivery and read status
Mentions — @mention support with notification routing
Invite System — Share invite codes to add contacts

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        Clients                               │
│  ┌─────────────────┐              ┌─────────────────┐       │
│  │  Android        │              │  iOS            │       │
│  │  Kotlin/Compose │              │  SwiftUI        │       │
│  │  Signal Bindings│              │  Signal Swift   │       │
│  └────────┬────────┘              └────────┬────────┘       │
│           │                                │                 │
│           └──────────┬─────────────────────┘                 │
│                      │ HTTPS + WSS                           │
└──────────────────────┼───────────────────────────────────────┘
                       │
┌──────────────────────┼───────────────────────────────────────┐
│                      ▼                                       │
│  ┌─────────────────────────────────────────────────────┐    │
│  │              Ktor Server (Zero-Knowledge)            │    │
│  │  • Opaque ciphertext only — never sees plaintext     │    │
│  │  • WebSocket fanout for real-time delivery           │    │
│  │  • Rate limiting + abuse prevention                  │    │
│  └─────────────────────────────────────────────────────┘    │
│                      │                                       │
│         ┌────────────┼────────────┐                         │
│         ▼            ▼            ▼                         │
│  ┌──────────┐ ┌──────────┐ ┌──────────┐                    │
│  │ Postgres │ │  Redis   │ │  Blobs   │                    │
│  │ Messages │ │  Rate    │ │ Encrypted│                    │
│  │ Metadata │ │  Limits  │ │ Files    │                    │
│  └──────────┘ └──────────┘ └──────────┘                    │
│                     Server                                   │
└──────────────────────────────────────────────────────────────┘

Layout

shared/ Kotlin Multiplatform shared domain models, encrypted payload contracts, and crypto bridge interfaces.
server/ Ktor backend for device registration, encrypted message fanout, attachment metadata, and websocket delivery.
clients/android/ Native Android app scaffold built with Kotlin + Compose.
clients/ios/ Native iOS SwiftUI app scaffold generated with XcodeGen.
prototype/expo-rn/ Archived Expo/Convex prototype retained for reference and migration work only.
docs/ Architecture and migration notes for the native rebuild.

Why This Rebuild Exists

The Expo prototype proved the encrypted-only storage model, but it is not a sufficient base for a production secure messenger because the official Signal and MLS runtimes do not currently fit cleanly into the managed Expo stack.

The new direction is:

native Android and iOS clients
Kotlin Multiplatform shared app/domain layer
Ktor backend with websocket realtime delivery
platform-native crypto bindings instead of homemade protocol code
encrypted attachments stored as opaque blobs

Quick Start

Prerequisites

JDK 17+
Android Studio (for Android development)
Xcode 15+ (for iOS development)
Docker & Docker Compose (for Postgres/Redis)
XcodeGen (brew install xcodegen)

Environment Setup

# Clone and setup
git clone https://github.com/hyodotdev/DeepLine.git
cd DeepLine

# Copy environment template
cp .env.sample .env.local

# Start infrastructure (Postgres + Redis)
docker compose up -d postgres redis

# Load environment
set -a && source .env.local && set +a

Run Server

# Run Ktor server on port 9091
./gradlew :server:run

Build Clients

# Android
./gradlew :androidApp:assembleDebug

# iOS
cd clients/ios
xcodegen generate
open DeeplineIOS.xcodeproj

Testing

Run All Tests

# Full test suite
./gradlew check

# Or run individually:
./gradlew :server:test          # Server unit tests
./gradlew :shared:allTests      # Shared module tests (JVM + iOS Simulator + Android)

Server Tests

# Run server tests with detailed output
./gradlew :server:test --info

# Run specific test class
./gradlew :server:test --tests "dev.hyo.deepline.server.DeeplineServerTest"

Shared Module Tests

# All platforms
./gradlew :shared:allTests

# Specific platforms
./gradlew :shared:serverTest              # JVM/Server tests
./gradlew :shared:iosSimulatorArm64Test   # iOS Simulator
./gradlew :shared:testDebugUnitTest       # Android unit tests

Android Tests

# Unit tests
./gradlew :androidApp:testDebugUnitTest

# Instrumented tests (requires emulator or device)
./gradlew :androidApp:connectedDebugAndroidTest

iOS Tests

cd clients/ios

# Generate Xcode project
xcodegen generate

# Run tests on simulator
xcodebuild -project DeeplineIOS.xcodeproj \
  -scheme DeeplineIOS \
  -destination 'platform=iOS Simulator,name=iPhone 17' \
  test

Test Coverage

# Generate Kover coverage report for server
./gradlew :server:koverHtmlReport

# Report available at: server/build/reports/kover/html/index.html

Deployment

Server Deployment

Docker Build

# Build server Docker image
docker build -t deepline-server:latest -f server/Dockerfile .

# Run with environment variables
docker run -d \
  -p 9091:9091 \
  -e DEEPLINE_STORE_MODE=postgres \
  -e DEEPLINE_DATABASE_URL=jdbc:postgresql://host:5432/deepline \
  -e DEEPLINE_DATABASE_USER=deepline \
  -e DEEPLINE_DATABASE_PASSWORD=secret \
  -e DEEPLINE_RATE_LIMITER_MODE=redis \
  -e DEEPLINE_REDIS_URL=redis://host:6379 \
  -e DEEPLINE_BLOB_STORAGE_ROOT=/data/blobs \
  deepline-server:latest

Environment Variables

Variable	Description	Default
`DEEPLINE_STORE_MODE`	`memory` or `postgres`	`memory`
`DEEPLINE_DATABASE_URL`	PostgreSQL JDBC URL	-
`DEEPLINE_DATABASE_USER`	Database username	-
`DEEPLINE_DATABASE_PASSWORD`	Database password	-
`DEEPLINE_RATE_LIMITER_MODE`	`memory` or `redis`	`memory`
`DEEPLINE_REDIS_URL`	Redis connection URL	-
`DEEPLINE_BLOB_STORAGE_ROOT`	Directory for encrypted blobs	`/tmp/deepline-blobs`
`DEEPLINE_STRICT_CRYPTO_ENFORCEMENT`	Block dev-mode crypto in production	`false`

Database Migrations

Flyway migrations run automatically on server startup. Migration files are in:

server/src/main/resources/db/migration/
├── V1__initial_schema.sql
├── V2__attachment_upload_sessions.sql
├── V3__group_member_roles.sql
├── V4__mentions_and_media.sql
└── V5__phone_authentication.sql

Android Release Build

# Debug APK
./gradlew :androidApp:assembleDebug
# Output: clients/android/app/build/outputs/apk/debug/app-debug.apk

# Release APK (requires signing config)
./gradlew :androidApp:assembleRelease

# Bundle for Play Store
./gradlew :androidApp:bundleRelease

Signing Configuration

Create clients/android/app/keystore.properties:

storeFile=path/to/keystore.jks
storePassword=your-store-password
keyAlias=your-key-alias
keyPassword=your-key-password

iOS Release Build

cd clients/ios

# Generate Xcode project
xcodegen generate

# Archive for App Store
xcodebuild -project DeeplineIOS.xcodeproj \
  -scheme DeeplineIOS \
  -configuration Release \
  -archivePath build/DeeplineIOS.xcarchive \
  archive

# Export IPA
xcodebuild -exportArchive \
  -archivePath build/DeeplineIOS.xcarchive \
  -exportPath build/ipa \
  -exportOptionsPlist ExportOptions.plist

Server API Reference

Phone Authentication

Method	Endpoint	Description
POST	`/v1/auth/phone/send-code`	Send OTP to phone number
POST	`/v1/auth/phone/verify`	Verify OTP code

Rate limits:

send-code: 3 per phone number per 5 minutes, 10 per IP per 5 minutes
verify: 5 attempts per verification per minute

Account & Device

Method	Endpoint	Description
POST	`/v1/users`	Register new user
POST	`/v1/devices`	Register device
POST	`/v1/prekeys`	Publish pre-key bundle
GET	`/v1/prekeys/{userId}/{deviceId}`	Fetch pre-key bundle

Conversations

Method	Endpoint	Description
POST	`/v1/conversations`	Create conversation
GET	`/v1/users/{userId}/conversations`	List user's conversations
GET	`/v1/conversations/{id}`	Get conversation details
PATCH	`/v1/conversations/{id}`	Update settings
GET	`/v1/conversations/{id}/members`	List members (paginated)
POST	`/v1/conversations/{id}/members`	Add members
DELETE	`/v1/conversations/{id}/members`	Remove members
PATCH	`/v1/conversations/{id}/members/{userId}`	Update member role
POST	`/v1/conversations/{id}/leave`	Leave conversation

Messages

Method	Endpoint	Description
POST	`/v1/messages`	Send encrypted message
GET	`/v1/conversations/{id}/messages`	List messages
POST	`/v1/messages/read-receipts`	Mark as read
GET	`/v1/messages/{id}/receipts`	Get read receipts
GET	`/v1/messages/{id}/receipts/aggregated`	Aggregated read count
GET	`/v1/users/{userId}/mentions`	Messages mentioning user

Attachments

Method	Endpoint	Description
POST	`/v1/attachments/upload-sessions`	Create upload session
PUT	`/v1/uploads/{sessionId}`	Upload blob
POST	`/v1/attachments/metadata`	Store attachment metadata
GET	`/v1/blobs/{storageKey}`	Download blob
GET	`/v1/conversations/{id}/attachments`	List attachments

Invites & Contacts

Method	Endpoint	Description
POST	`/v1/invites`	Create invite code
POST	`/v1/contacts/by-invite`	Add contact by invite

WebSocket

Endpoint	Description
`/v1/ws/conversations/{id}`	Real-time message stream

Health

Method	Endpoint	Description
GET	`/healthz`	Health check

How Claude Builds This App

The Workflow

┌─────────────────────────────────────────────────────────────┐
│  Human: "Add real-time messaging with WebSocket"           │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  Claude:                                                    │
│  1. Reads existing codebase (server, android, ios)         │
│  2. Designs WebSocket architecture                          │
│  3. Writes Ktor WebSocket route                            │
│  4. Writes Kotlin Flow client for Android                  │
│  5. Writes URLSessionWebSocketTask for iOS                 │
│  6. Adds push notification fallback (FCM + APNs)           │
│  7. Creates database migration                              │
│  8. Updates all related files                              │
│  9. Runs tests                                              │
└─────────────────────────────────────────────────────────────┘
                            │
                            ▼
┌─────────────────────────────────────────────────────────────┐
│  Human: Reviews diff → Approves → Ships                    │
└─────────────────────────────────────────────────────────────┘

Claude Code Skills

Skill	What Claude Does
`/audit-code`	Scans entire repo for security issues
`/commit`	Writes conventional commit messages
`/review-pr`	Reviews PRs like a senior engineer
`/deepline-knowledge`	Dumps full architecture context

Contributing

We welcome contributions! This is an AI-native project, so feel free to:

Fork & Clone
Use Claude Code (or your preferred AI assistant) to explore the codebase
Open a PR with your changes

Commit Convention

feat(server): add group member management
fix(android): resolve titlebar display issue
refactor(shared): extract common DTOs

Code Style

Kotlin: Kotlin coding conventions
Swift: Swift API Design Guidelines
Crypto boundary: Server handles opaque ciphertext only

PR Checklist

Tests pass (./gradlew check)
Android builds (./gradlew :androidApp:assembleDebug)
iOS builds (xcodegen generate && xcodebuild build)
No secrets committed

Roadmap

The Experiment

Can AI write a production app from scratch?

We're finding out. Every feature request becomes a prompt. Every bug report becomes a conversation. Every line of code comes from Claude.

Star this repo to follow the experiment. Open an issue to see Claude respond.

All Done by Claude

Zero human-written code. 100% AI-generated. Fully open source.

The future of software development is here.

Report Bug | Request Feature | Discussions

MIT License — See LICENSE for details.

Name		Name	Last commit message	Last commit date
Latest commit History 6 Commits
.claude		.claude
.github/workflows		.github/workflows
.vscode		.vscode
clients		clients
docs		docs
gradle		gradle
prototype/expo-rn		prototype/expo-rn
server		server
shared		shared
.env.sample		.env.sample
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
E2EE_PROGRESS.md		E2EE_PROGRESS.md
LICENSE		LICENSE
README.md		README.md
SECURITY_BLOCKERS.md		SECURITY_BLOCKERS.md
TODO_SECURITY.md		TODO_SECURITY.md
build.gradle.kts		build.gradle.kts
docker-compose.yml		docker-compose.yml
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle.kts		settings.gradle.kts

Folders and files

Latest commit

History

Repository files navigation

Deepline

100% Built by Claude

All Done by Claude

What the Human Does

What Claude Does

Why This Matters

Features

Architecture

Layout

Why This Rebuild Exists

Quick Start

Prerequisites

Environment Setup

Run Server

Build Clients

Testing

Run All Tests

Server Tests

Shared Module Tests

Android Tests

iOS Tests

Test Coverage

Deployment

Server Deployment

Docker Build

Environment Variables

Database Migrations

Android Release Build

Signing Configuration

iOS Release Build

Server API Reference

Phone Authentication

Account & Device

Conversations

Messages

Attachments

Invites & Contacts

WebSocket

Health

How Claude Builds This App

The Workflow

Claude Code Skills

Contributing

Commit Convention

Code Style

PR Checklist

Roadmap

The Experiment

All Done by Claude

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages