Razoyo Logo

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?

Razoyo taking over an offshore-built codebase
10,000+
Daily Users on Spider, the Platform We Engineer for Lighthouse
6 yrs
Still the Engineering Team Behind It
Central
Time Zone, From The Colony, Texas

Why This Decision Usually Gets Made

Almost nobody changes engineering teams because they want to. These are the reasons we actually hear.

The Reasons We Actually Hear

It will not scale, and nobody can say why

The system works at today's volume and falls over at the next one. Asking what the ceiling is produces a plan to add servers rather than an answer about the architecture.

A one-day round trip on every question

Anything ambiguous costs a day. That is survivable on a roadmap and expensive during an incident, and it quietly changes how much your team is willing to ask.

The people who built it have rotated off

The contract is with a company, the knowledge was in three individuals, and two of them are on a different account now.

Every change breaks something else

No test coverage worth the name, so the cost of a small feature is dominated by the regression risk, and the team has learned to avoid certain files.

Nobody on your side holds the keys

The repository, the cloud account, the domain and the deployment pipeline are all in the vendor's name. This is the one that gets urgent fast.

A rebuild has been proposed, and you have no independent way to price it

The proposal may well be right. It is still a reasonable moment to get a read from a firm with no stake in the answer.

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

Step 1

1 · Free Consultation

$0

Thirty minutes with a senior engineer. What the system does, what is breaking, what access you hold and what the outgoing arrangement is. You leave with a straight answer on whether this is a takeover, a rebuild or something you should not change at all right now.
Step 2

2 · System Spec

$2,500 fixed

We read the code, the data and the infrastructure and answer the question you are actually asking: can this architecture reach the load and the roadmap you need, or not. You get a product brief, a senior engineer’s build estimate and a build or do not build recommendation, and you own all of it whether or not you continue with us.
Step 3

3 · Access and Handover

Runs in parallel

We work the checklist above with you, alongside the outgoing team where that is possible and without them where it is not. Most of what is needed is in the code, the data and the infrastructure; what we need from you is the business context.
Step 4

4 · Stabilize Before Changing

Scoped from the Spec

Before any new feature, we make the system observable and deployable: monitoring, error tracking, a deploy you can reverse, and tests around the parts you cannot afford to break. This is the step teams want to skip and the one that makes everything after it safe.
Step 5

5 · Then the Roadmap

From $1,500 a month

Feature work, support and hosting with the same senior team. Retainers run month to month: thirty days’ notice to stop. If a rebuild is the right answer, the Spec will have said so and priced it, rather than it emerging as a surprise six weeks in.

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

By not switching everything at once. We take read access and learn the system while the current arrangement still runs, work the handover checklist in parallel, then take deploys over once we can reproduce the environment and reverse a change. A transition that requires a hard cutover on a single date is a transition that has not been planned.

That is the normal case rather than the hard one. Most of what we need is in the code, the data and the infrastructure. What we need from you is the business context: what the system is supposed to do, which behaviors customers depend on, and what breaks most often. The one thing that genuinely hurts is not having ownership of the accounts, which is why it is first on the checklist above.

Usually more of it than people expect, and the answer is an engineering judgment rather than a preference. That is what the $2,500 System Spec produces, and you own the answer either way. The specific tests we apply are set out on software rescue, so this page does not repeat them.

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.

We are in The Colony, Texas, in the Dallas-Fort Worth Metroplex, and we work Central time. In practice that means a question asked in the morning is usually answered the same morning, which is most of what people mean when they say they want an onshore team.

Yes, and that is often the better outcome. We can take the whole system, take one part of it, or work as the senior engineering layer over a team you keep. Dev Bursts at $1,200 a day or $4,500 a week exist for bounded work of that kind, and a retainer from $1,500 a month for a continuing relationship.

Once fees are paid, you own the code we write for you, and you can take it as it stands to any other team. The point of the handover checklist on this page is that you should be able to leave us the same way, and we would rather you had that from the start.

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.

1 Free

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.

2 $2,500

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.

3 No email required

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.