Build log/Engineering

You get the repository: what a proper handover includes

If only your agency can deploy your software, you don’t fully own it. This is the checklist we hand over against.

The short answer

  • Domains, cloud and app store accounts should be in your company’s name from day one.
  • A handover is a checklist you can verify, not a meeting.
  • Test it: someone outside the project should be able to deploy from the documentation alone.

Why this matters

Businesses get stuck with software they paid for but can't change. The code lives in the agency's account, the app is published under the agency's developer name, and the only person who knew how to deploy has left. Moving to anyone else means starting again.

We work the other way round. Everything is yours from the start, and the handover is a list you can check.

Accounts in your name

  • Domain registration and DNS
  • Cloud hosting and the database
  • Apple Developer Program and Google Play Console, under your organisation
  • Payment provider, email sending and any AI provider
  • Error monitoring and analytics

We are added as users on your accounts, and removed when we're done.

The repository

  • The full history, not a zip file of the final version
  • A README that gets a new developer from clone to running locally
  • Every environment variable listed with what it's for, and no secrets in the code
  • Tests that run with one command

Deploys you can repeat

A deploy is one command or one merge, run by a pipeline, not by someone's laptop. The pipeline lives in the repository, so it moves with the code.

A runbook

A short document for when things go wrong: how to roll back a release, restore the database, rotate a leaked key, and who to contact at each provider.

Data you can get back

Backups run automatically, and a restore has been tested. A backup that has never been restored is a hope.

Test the handover

The test is simple. Could another developer, with only the repository and the runbook, deploy a change on their first day? If not, the handover isn't finished.

Written by Flavoureak

We build and run Estimark, CurioKids and CalcStack, and we build web and mobile software for other businesses. Start a project.