Find the clients a FastAPI, Flask or Django change will break
Python backends often serve a web app and a mobile app at once. ArchSync reads the routes on the Python side and the calls on every client side, so a renamed endpoint shows up with every caller it breaks.
1. Put the repos side by side
Clone them into one folder. Nothing is linked or uploaded; ArchSync only reads the files.
my-product/ ├─ server/ # FastAPI, Flask (incl. blueprints) or Django ├─ web/ # React / Next.js └─ app/ # Flutter
2. Scan them together
cd my-product npx archsync scan --workspace
What ArchSync reads:
- Backend: FastAPI and Flask route decorators (including blueprints and @bp.route), Django URL patterns and views, and SQLAlchemy models.
- Clients: axios / fetch calls in web apps and http / Dio calls in Flutter apps.
3. Read the broken calls
Every call that no route answers any more is listed with its repo, method and path. Example output:
$ npx archsync scan --workspace
Cross-system: 41
─── Broken cross-system calls (1) ───
✖ web: GET /api/orders/${id}/itemsChange something — rename a route, change a method, drop a field — and scan again to see exactly which callers it breaks. Open the result on a canvas with npx archsync serve.
4. Run it on every pull request
# CI (free): check out the related repos side by side, then scan them together git clone --depth 1 $SERVER_REPO server git clone --depth 1 $WEB_REPO web git clone --depth 1 $APP_REPO app npx archsync scan --workspace # prints "Broken cross-system calls" in the job log
With ArchSync Team, each repo pushes its map to your own Supabase, and any repo can check itself against all the others:
# CI (Team): compare this repo with what every other repo pushed npx archsync scan npx archsync diff --merged --json > merged.json test "$(jq .breakingCount merged.json)" = 0 # fail the job on a breaking change
Good to know
Routes registered dynamically at runtime (for example in a loop) can’t be seen in the code and are not matched.