What the starter templates include, and what they leave out

A tour of the shared decisions in the Android, .NET and iOS starter templates: error handling, secrets and the choices each one makes on purpose.

  • templates
  • android
  • dotnet
  • ios

The starter templates are skeletons. They contain no domain code, so each one is mostly a set of decisions that are expensive to make again on every new project.

Android: permanent errors are not retried

The Android Compose starter uses Retrofit, Room and a WorkManager offline queue. The queue separates permanent HTTP errors from transient ones. A 401, 403 or 422 is never retried, while transient failures are retried up to an attempt cap, so a request cannot retry forever.

Two smaller choices sit alongside it. The auth header is stored in Keystore-encrypted preferences, and OkHttp logging is kept at BASIC level so headers are not logged. ktlint runs in CI.

.NET: refuse the placeholder secret

The .NET 10 minimal API starter on MongoDB ships with a development JWT secret. A startup guard refuses that placeholder in Production. Login is rate limited and returns one error for both an unknown user and a wrong password, so the response does not reveal which accounts exist.

Query-building logic lives in internal methods, so the shape of a MongoDB query can be unit tested as plain documents without a database. Tenancy and the background worker are optional folders rather than fixed parts of the layout.

iOS: no third-party dependencies

The SwiftUI starter has no third-party Swift packages. It includes a GraphQL client and a subscription client, both built on URLSession, and stores tokens in the Keychain. The project is generated from project.yml with XcodeGen.

A deep-link coordinator handles push-notification taps in every app state. The code is compiled only by the macOS CI job, and real push delivery needs a physical device with real credentials, so that path is not verified end to end.

Read the template before trusting it

Each template’s README and CI configuration say what is actually checked. Start there before building on one.

Templates are published under github.com/yaeouk-rajab.

← all posts