Moving an Offshore-Built Codebase to a US Team
Codebase Takeover · Onshore US Team · Central Time
Moving an Offshore-Built Codebase to a US Team
The hard part is not writing code in a codebase you did not write. It is the handover: getting everything out of the outgoing team before access ends, and keeping the product running while the knowledge moves. Razoyo is a US engineering firm in the Dallas-Fort Worth area, and working in systems other teams built is a large part of what we do.
How do we switch teams without the product going down?
What if the original developers will not help?
Is our code even salvageable?
Can you work alongside the team we already have?
Why This Decision Usually Gets Made
Almost nobody changes engineering teams because they want to. These are the reasons we actually hear.
It will not scale, and nobody can say why
A one-day round trip on every question
The people who built it have rotated off
Every change breaks something else
Nobody on your side holds the keys
A rebuild has been proposed, and you have no independent way to price it
What to Get Before Access Ends
This is the part that goes wrong, and it goes wrong in one direction: the relationship ends, and then somebody discovers what was never handed over. Work through this list while the outgoing team still has an incentive to help, which is before the final invoice is paid, not after.
| What to Get | Why It Matters | What "Done" Looks Like |
|---|---|---|
| Ownership of every account | Repository, cloud provider, domain registrar, DNS, email, CI, error tracking, app stores, payment gateway | Each one billed to you and owned by an account you control, not shared with a vendor login |
| Full git history | A zip of the current code is not a handover. History is how anyone works out why something is the way it is | The repository transferred with branches, tags and history intact, in your organization |
| Secrets and credentials | Third-party API keys, certificates and signing keys are routinely the only thing standing between you and a deploy | An inventory of every secret, who issued it, where it is used and when it expires |
| A reproducible environment | If a new engineer cannot run it locally, every change has to be tested in production | A documented setup a new developer follows to a running local instance, tested by someone who has never done it |
| The deploy path, written down | Knowing how a change reaches production, and how to reverse it, is the first thing you need and the last thing documented | A written deploy and rollback procedure that someone outside the old team has executed once |
| Data, schema and backups | A backup nobody has restored is not a backup | A backup restored into a fresh environment successfully, at least once, in front of you |
| The undocumented rules | Every system has behavior that exists because a customer asked for it and it was never written down | Recorded walkthrough sessions, not a document. People say more than they write |
| Written IP assignment | Check what your contract actually says you own, particularly any shared libraries the vendor reuses across clients | Clear in writing, including any third-party or vendor-owned components still in the build |
If you do only one thing on this list before the conversation gets difficult, do the first one. Account ownership is the item that turns a transition into an emergency.
How We Take It Over
1 · Free Consultation
$0
2 · System Spec
$2,500 fixed
3 · Access and Handover
Runs in parallel
4 · Stabilize Before Changing
Scoped from the Spec
5 · Then the Roadmap
From $1,500 a month
Work That Is Relevant Here
Two projects that are public on this site, and two things we hold to.
Spider, the hotel BI platform now part of Lighthouse
It started as an internal consultancy tool that emailed reports to revenue managers, and earlier attempts to build it with other developers, including offshore teams, fell short on scalability and performance. Kriya RevGen partnered with us to redesign it into a self-service platform built for scale, on Elixir and Phoenix. Re-indexing went from up to 24 hours to a few hours and then continuous updates, daily users from a few dozen to more than 10,000, and hosting costs fell by roughly 90%. Kriya was acquired by Lighthouse within months of the rebuild launching, and Spider ranked #1 of 74 for Business Intelligence at the 2025 HotelTechAwards. Read the project.
Matrix, hotel sales intelligence for M1 Intel
An internal hotel sales CRM built for a single organization, with performance that struggled under load. We rebuilt it from the ground up on Elixir as a multi-tenant SaaS product. Read the project.
We will tell you to keep what you have
A firm that only ever recommends a rebuild is not giving you an engineering opinion. Sometimes the architecture is fine and the problem is one query, one queue or one missing index, and that is a much better outcome for you. How we decide.
We stay
Six years on, we are still Spider's engineering team. Whoever you move to should still be there when the next hard problem arrives.
Frequently Asked Questions
Per hour, yes. We are more AI-forward than most offshore teams, so the rate is higher and the value per dollar is better. Per outcome is the question worth asking, and we will not pretend the honest answer is always us.
Offshore works, and where it works it is usually for two reasons that have very little to do with rates. The first is the team: a well-vetted, trustworthy group you have built a long relationship with beats credentials or headcount every time, and that relationship is the expensive thing to replace. The second is communication: standups, real feedback, specifications written down and kept current. When an offshore arrangement disappoints, it is nearly always one of those two rather than the distance.
What we would push back on is the idea that you settle the specification and then hand it over. Software is never finished. The end product is fungible, it keeps moving, and the requirement you wrote down last quarter is not the requirement today. So the useful question is not whether your spec is stable, because it never is. It is whether your arrangement can absorb change without every change costing a round trip and a renegotiation. If it can, keep it. If it cannot, that is the specific thing that has been expensive.
A consultation is free. After that, a System Spec is $2,500 fixed and produces a product brief, a senior engineer's build estimate and a build or do not build recommendation, which you own either way. Ongoing work runs from $1,500 a month, and Dev Bursts are $1,200 a day or $4,500 a week.
Pick your next step
Start With a Conversation. It Costs Nothing.
You do not need the outgoing team's permission to have this conversation, and you do not need to have decided anything yet.
Free consultation
Thirty minutes with a senior engineer, on Central time. A straight answer on whether this is a takeover, a rebuild, or something to leave alone for now.
Fixed-price System Spec
An independent read of the codebase from a firm with no stake in the answer, with a real estimate for both hardening and rebuilding.
Read the proof first
Not ready to talk? Read how Spider went from a few dozen daily users to more than 10,000 after earlier offshore attempts fell short.