What a handover actually includes
The test of a handover is not what you were sent. It is whether your team can ship a change next month without the person who built the site.
What is in this
Handover is the part of a project everybody agrees is important and nobody specifies. It usually arrives as an archive, a walkthrough call and a document, and it reads as complete until the first time you need it.
The test is not what you were sent. It is whether your team can make a change next month, on their own, and put it in front of visitors.
That is a higher bar than it sounds, and most of what fails it fails quietly. Here is what has to be in place, in roughly the order it matters.
Accounts, in your name
Every service the site depends on should be owned by your organization, on a billing account you control, with the person who built it holding access you can revoke. Not a seat on their agency plan. Not their personal account with your card attached.
The list is longer than people expect: the domain registrar, DNS, the host, the repository, the CMS, the analytics property, the error reporting, the form or CRM endpoint, any transactional email service, and every third-party key used in the build. Missing one of these does not stop the site working. It stops you moving, which is the same problem you were trying to solve.
The registrar is the one to check first. It is the single account that, if you do not control it, makes every other item on the list negotiable.
A repository you can actually build
Having the code is not the same as being able to run it. The check is specific and takes an afternoon: somebody on your side, on their own machine, clones the repository, installs it, builds it, and gets the same site.
What usually blocks this is not the code. It is the parts that were never written down. An environment variable that lives in one person’s shell. A build that only passes on a particular version of the runtime. A step that somebody has been doing by hand for months without noticing it was a step.
Do this once while the person who built the site is still available. An unbuildable repository discovered in month one is a question. Discovered in month eight it is an archaeology project.
What has to work before a handover is real
-
Clone and install
On your machine, from your account, with no files passed over chat.
-
Build locally
The same site, from a clean checkout.
An undocumented step or secret stops it here
-
Make a small change
Something visible and reversible, made by somebody on your team.
-
See it in a preview
Before it reaches anybody.
No preview means no safe way to check
-
Release it
Through whatever path you will actually use every week.
-
Roll it back
To the previous version, deliberately.
If this is untested it will be learned during an incident
The decisions, not just the instructions
Most handover documents explain how to do things. The more valuable half explains why the site is the way it is, because that is the part nobody can reconstruct.
Why the content model has these types and not others. Which URLs were deliberately retired and where they now point. Which integrations are load-bearing and which were inherited. Where a shortcut was taken, and what would have to be true to undo it. Which parts were built to vary and which were not.
Without this a new developer does the reasonable thing, which is to assume every existing decision was deliberate and work around it. That is how a site accumulates a decade of constraints nobody can name.
What you were given, and what it is worth without the rest
| You received | What it proves | What it does not |
|---|---|---|
| A repository | The code exists | That anybody but the author can build it |
| Admin logins | You can sign in today | That the account is yours to keep |
| A walkthrough recording | Somebody explained it once | That the explanation matches the site in six months |
| A list of integrations | They were known at handover | Which ones are load-bearing |
| A deploy button | Releases happen | That you can undo one |
| A support retainer | Somebody will answer | That you could stop paying it and cope |
One real change, made by your team
This is the only part that actually tests the rest, and it is the part that gets skipped because the project is over and everybody is tired.
Pick something small, visible and reversible. Have somebody on your team make it, review it, and release it, while the person who built the site watches and does not touch the keyboard. Whatever they reach for and cannot find is the gap, and it will be found now or during an incident.
What makes this cheap is the same thing that makes a site safe for a contributor who is new to it: stated patterns, checks that catch the obvious mistakes, and a preview before anything is public. That is covered in what makes a site safe for an agent to change, and it applies equally to a person on their first week.
What support should be after that
A good handover does not end the relationship. It changes what the relationship is for.
Before handover, the people who built the site are the only ones who can change it. After, they are the people you call about the things you decided not to learn. The difference is that stopping is now an option, which is the only thing that makes the arrangement honest.
If a support agreement is the only way the site keeps working, the handover did not happen. It was renamed.
Take this with you
Six questions to ask before you sign anything off. Each is answerable by trying it rather than by being told.
-
Can you remove the builder from every account tomorrow?
Access that somebody else can revoke is not ownership, and the registrar is the one that decides all the others.
Worry if you hear We have logins.
-
Has somebody on your team built the site from a clean checkout?
Undocumented steps and missing secrets are invisible until somebody starts from nothing.
Worry if you hear The code is in the repository.
-
Has your team released a change without help?
Watching is not doing. The gap between them is the entire handover.
Worry if you hear We were shown how.
-
Have you rolled a release back on purpose?
The first rollback should not happen during the first incident.
Worry if you hear We have not needed to.
-
Is it written down why the site is like this?
Instructions tell you how. Only the reasoning stops the next person undoing a deliberate decision.
Worry if you hear There is documentation.
-
What happens if you stop paying for support?
If the answer is that the site decays, the dependency moved rather than ended.
Worry if you hear We would rather not find out.
Also worth reading
-
Migrations
How to move off Webflow
A Webflow migration in the order it happens: decide whether to go, inventory the site, choose what replaces the CMS, rebuild, keep the URLs, and verify before cutover.
-
Migrations
What makes a site safe for an agent to change
AI can write the code. The harder problem is a codebase where the right change is obvious, the wrong one gets caught, and a person can approve the result without reading every line.
-
Migrations
Hiring a Webflow to Astro developer: eight questions to ask
Eight questions to ask a Webflow to Astro developer about scope, CMS, redirects, integrations, launch checks and the handover your team receives.
Reach out and see if we are a good fit.
Currently booking two to four weeks out.