Overview
The mobile platform engineering strategy covers four capability areas: the golden path (opinionated, supported development paths that work out of the box), shared platform capabilities (authentication, analytics, crash reporting, push), internal developer tooling (code generation, scaffolding, build optimization), and developer experience measurement (DORA metrics applied to mobile delivery).
Golden Path
The golden path is the officially supported, documented, and maintained approach to common engineering tasks. Feature teams are not required to use it — but deviating from it means accepting the overhead of unsupported infrastructure. Golden path components for mobile:
Project scaffolding: A CLI or GitHub template that generates a new feature module pre-configured with MVVM + Clean Architecture, Hilt DI, unit test scaffolding, snapshot test scaffolding, and CI integration. A new screen should be commit-ready in under 10 minutes.
API client generation: Given a GraphQL schema or OpenAPI specification, generated Apollo Kotlin/iOS or Retrofit client code. Eliminates handwritten API integration code and the serialisation bugs that come with it.
Shared design system: A versioned :core:ui library with all design system components, tokens, and theming. Feature teams import and use — they do not re-implement Button, TextField, or LoadingState.
Release pipeline: A fastlane configuration and GitHub Actions workflow that any new project can adopt in under 30 minutes, preconfigured with code signing, testing gates, and distribution.
Authentication, push notifications, analytics, crash reporting, and experiment assignment are infrastructure capabilities that should be implemented once and consumed by all mobile applications. Implementing these independently per application creates inconsistent behaviour, multiplied security surface, and duplicated maintenance burden. The platform SDK:
- Wraps Firebase Crashlytics, Performance, and Analytics behind a stable internal API
- Wraps the OAuth 2.0 + PKCE flow, handling token refresh, biometric authentication, and secure storage
- Provides a typed, versioned event schema for analytics — feature teams fire domain events, the platform SDK handles provider integration
- Abstracts push notification registration, token management, and payload handling
Developer Experience Measurement
DORA metrics adapted for mobile delivery:
- Deployment Frequency: How often a production release reaches users (target: multiple per week)
- Lead Time: From commit to production (target: under 1 day for bug fixes, under 1 week for features)
- Change Failure Rate: Percentage of releases requiring rollback or hotfix (target: below 5%)
- Recovery Time: From incident to production fix deployed (target: under 4 hours)
Measure and publish DORA metrics to the engineering organisation monthly. Trend analysis identifies platform investments that will move the metrics.
Anti-Patterns to Avoid
⚠ 1. Platform Team as Gatekeeper
All mobile infrastructure changes require platform team approval and are routed through the platform team's backlog. Feature teams blocked waiting for platform team capacity.
Hover to see the fix ↻
↺ Correct Approach
Platform team builds self-service infrastructure. Feature teams are empowered to use and extend it without bottlenecks. Platform team reviews proposals, not every implementation.
⚠ 2. No Golden Path — Every Team Chooses Differently
One team uses Retrofit, another uses Ktor. One team uses Hilt, another uses Dagger directly. One team uses fastlane, another has custom shell scripts. Every new engineer must learn a different stack for each project.
Hover to see the fix ↻
↺ Correct Approach
Opinionated golden path with clear documentation and active support from the platform team. Deviation allowed with architectural justification — but the default is always the golden path.
Flowchart
%%{init:{'theme':'base','themeVariables':{'fontSize':'14px','fontFamily':'IBM Plex Sans, system-ui, sans-serif','primaryColor':'#DBEAFE','primaryTextColor':'#1e3a5f','primaryBorderColor':'#2563EB','lineColor':'#374151','clusterBkg':'#F9FAFB','clusterBorder':'#D1D5DB','edgeLabelBackground':'#FFFFFF'},'flowchart':{'curve':'orthogonal','padding':30,'nodeSpacing':65,'rankSpacing':75,'useMaxWidth':true}}}%%
flowchart TD
subgraph PT["🏗 Platform Team — Self-Service Infrastructure"]
GP["<b>Golden Path</b><br/>Project scaffold CLI<br/>Module template generator<br/>Release pipeline template"]
SPC["<b>Shared Platform SDK</b><br/>Auth (PKCE) · Analytics<br/>Crashlytics wrapper<br/>Push registration"]
DX["<b>Developer Experience</b><br/>DORA Metrics Dashboard<br/>ADR library · Onboarding docs<br/>Architecture review board"]
end
subgraph FT["⚡ Feature Teams — Consume Platform"]
T1["<b>Account Team</b><br/>:feature:account"]
T2["<b>Payments Team</b><br/>:feature:transfer"]
T3["<b>Growth Team</b><br/>:feature:onboarding"]
end
GP -->|"CLI generates module"| T1 & T2 & T3
SPC -->|"Import Platform SDK"| T1 & T2 & T3
DX -->|"ADRs guide decisions"| T1 & T2 & T3
T1 & T2 & T3 -->|"Inner source PR"| PT
style PT fill:#DBEAFE,stroke:#2563EB,stroke-width:2px
style FT fill:#DCFCE7,stroke:#16A34A,stroke-width:2px
style GP fill:#BFDBFE,stroke:#2563EB,color:#1e3a5f
style SPC fill:#BFDBFE,stroke:#2563EB,color:#1e3a5f
style DX fill:#BFDBFE,stroke:#2563EB,color:#1e3a5f
style T1 fill:#BBF7D0,stroke:#16A34A,color:#14532D
style T2 fill:#BBF7D0,stroke:#16A34A,color:#14532D
style T3 fill:#BBF7D0,stroke:#16A34A,color:#14532D
References
- Skelton, Matthew and Pais, Manuel — Team Topologies. IT Revolution Press, 2019.
- Forsgren, Nicole, Humble, Jez, Kim, Gene — Accelerate. IT Revolution Press, 2018.
- Gartner — Platform Engineering Hype Cycle. gartner.com
- Google — Android Platform Engineering. developer.android.com/build
Mobile Engineering Reference
← Mobile Development