---
title: "Mirror-First DX: Tools That Assume Bad Egress"
description: "Design CLIs and installers as if registries will flake."
author: "Mohammad-Pouya Ghourchiani"
canonical: "https://ghourchiani.ir/blog/mirror-first-dx"
date: "2026-09-16"
lang: "en"
---
# Mirror-First DX: Tools That Assume Bad Egress

## Direct answer

Default to mirror selection, retries with jitter, and clear offline failure messages — not a tutorial that assumes Cloudflare PoPs are always near.

## Pattern

- measure mirrors before switching (APT)
- keep Cargo usable when crates.io is unreliable
- document the failure mode in the same repo as the tool

## Links

- [/projects/apt-mirror-pro](/projects/apt-mirror-pro)
- [/projects/cargo-rust-network-ir](/projects/cargo-rust-network-ir)
- [/blog/why-restricted-network-tooling](/blog/why-restricted-network-tooling)