Skip to content

Repository files navigation

Android Platform Starter

CIKotlinComposeLicense: MIT

Production Android platform template — modular Compose, Hilt, Detekt, Macrobenchmark, and CI quality gates.

Copy this repo when bootstrapping a platform team or migrating a monolith to multi-module. ADRs included.

Author:Kanav Wadhawan · Portfolio


Why this exists

Most Android templates teach UI patterns. This one teaches platform engineering:

  • Multi-module boundaries that scale with team size
  • Quality gates (Detekt, tests, Macrobenchmark) wired from day one
  • ADRs for decisions that survive team turnover
  • CI that catches regressions before merge

Built from patterns used at Paytm (500M+ users) and Angel One (1M+ daily transactions).


What's inside

Module / areaPurpose
:appApplication entry, navigation graph
:feature:*Feature modules with clear public APIs
:core:*Shared design system, network, data utilities
docs/adr/Architecture Decision Records
.github/workflows/CI pipeline (lint, test, build)
MacrobenchmarkPerformance budgets and Baseline Profile setup

Quick start

git clone https://github.com/kanav22/android-platform-starter.git
cd android-platform-starter
./gradlew assembleDebug
./gradlew detekt
./gradlew :benchmark:connectedBenchmarkAndroidTest # requires device

Architecture

flowchart TB
subgraph App
Nav[Navigation]
end
subgraph Features
F1[Feature A]
F2[Feature B]
end
subgraph Core
DS[Design System]
Net[Network]
Data[Data]
end
Nav --> F1
Nav --> F2
F1 --> DS
F1 --> Data
F2 --> DS
F2 --> Net
Data --> Net
Loading

Documentation

DocDescription
Performance budgets with MacrobenchmarkSet and enforce performance targets
ADRs in docs/adr/Recorded architecture decisions

Related projects

RepoFocus
sliide-kmp-user-managementKMP · MVI · offline-first
compose-golden-toolkitPaparazzi golden testing
kanav22Profile & writing

License

MIT — see LICENSE.

Note: Copy this file to android-platform-starter/README.md in that repo. Adjust module names to match your actual project structure.

About

Production Android platform template — modular Compose, Hilt, Detekt, Macrobenchmark, CI quality gates

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages