HomeMigrations

Migrations

Migrating from Express to Next.js route handlers

The hard part of an Express→Next.js migration is that new code keeps reaching for Express. ArchSteer makes the target the default for agents and converges the migration with a ratchet.

Steer new endpoints to route handlers

Guardrails tell agents to implement endpoints as App Router route handlers under app/api, not Express routers.

Ratchet out the legacy

CI blocks net-new Express usage while existing routes migrate incrementally — no feature freeze.

Track convergence

A migration percentage and Drift Index show the move from Express to Next.js trending to done.

Try it on your repo

Run `archsteer xray` on your repo to see this in under a minute, then declare intent when you're ready to govern.

FAQ

Do I have to stop shipping features?

No — the ratchet only blocks new violations, so features ship while the migration converges.

Will agents stop adding Express?

Steered agents build to the Next.js target; CI catches any net-new Express.

Related