KMP Production Starter Pro Kotlin Multiplatform Template

## Skip 2 Weeks of Architecture Setup. Start Building Features on Day 1.

KMP Production Starter PRO is a production-ready Kotlin Multiplatform template built by an engineer who ships KMP apps to production daily.

Clone it. Configure your API URL. Run. Done in 5 minutes.

## What's Inside

**Architecture**- Multi-module Clean Architecture (core + feature modules)- Convention Plugins (build-logic) — zero Gradle config duplication- Version Catalog (libs.versions.toml) — single source of truth- Koin Dependency Injection — shared + per-feature modules

**Networking**- Ktor HTTP client with full plugin setup- Auth Interceptor — auto-attach Bearer token- Error Interceptor — 401 → auto refresh token → retry original request- Token Manager — access + refresh token lifecycle- Network Connectivity Monitor (expect/actual — Android & iOS)

**Data Layer**- Room Database with multiple entities- Real migration examples (v1 → v2 → v3)- DataStore for preferences & secure token storage- Paging 3 + RemoteMediator (API → Room → UI)

**Offline-First Sync Engine**- SyncManager with Pending / Synced / Failed status- ConflictResolver — server-wins / client-wins / merge strategies- Real-time Sync Status Banner in UI

**UI Layer**- Compose Multiplatform + Material 3- Light & Dark theme- Full auth flow navigation + bottom navigation- Reusable components: Loading, Error, Empty, SearchBar, SyncStatusBanner

## Included Feature Modules

| Module | What's included ||--------|----------------|| **Auth** | Login · Register · Logout — full VM + UseCase + Repo + API || **Home** | Dashboard with offline-capable data layer || **Items** | Paginated list + Detail + Offline CRUD + Sync |

## Requirements

• Android Studio Otter (2025.2.1) or later- JDK 17+- Xcode 16+ (for iOS — macOS only)- Basic familiarity with Kotlin Multiplatform

## Quick Start (5 minutes)

1. Download & extract ZIP2. Open in Android Studio → Sync Gradle3. Edit `gradle.properties` → set your package name4. Edit `NetworkConstants.kt` → set your API base URL5. Run Android or open in Xcode for iOS

## Documentation

Includes detailed **ARCHITECTURE.md** with:- Convention plugin setup guide- Module dependency graph- Token refresh sequence diagram- Paging 3 + RemoteMediator data flow- Offline sync state machine

## License

Commercial license — use on **unlimited personal and client projects**.Do not redistribute or resell the template itself.

**Estimated time saved: 80+ hours of senior KMP developer work.**