On This Page
1Overview2Golden Path
3Shared Platform Capabilities4Developer Experience Measurement
5Anti-Patterns to Avoid6References

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.

Shared Platform Capabilities

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

  1. Skelton, Matthew and Pais, Manuel — Team Topologies. IT Revolution Press, 2019.
  2. Forsgren, Nicole, Humble, Jez, Kim, Gene — Accelerate. IT Revolution Press, 2018.
  3. Gartner — Platform Engineering Hype Cycle. gartner.com
  4. Google — Android Platform Engineering. developer.android.com/build
Mobile Engineering Reference
← Mobile Development