explaingit

docmirror/dev-sidecar

📈 Trending22,092JavaScriptAudience · developerComplexity · 3/5ActiveLicenseSetup · easy

TLDR

Desktop app that speeds up GitHub, npm, and other overseas websites for developers in China by rerouting traffic through faster mirrors and optimizing DNS.

Mindmap

mindmap
  root((dev-sidecar))
    What it does
      Local proxy intercepts
      Smart DNS selection
      GitHub acceleration
      npm registry mirror
    How it works
      Electron desktop app
      HTTPS rerouting
      Certificate installation
      Safe mode option
    Use cases
      Speed up git clone
      Faster file downloads
      Reliable npm install
      Access blocked sites
    Supported platforms
      Windows
      Mac
      Linux

Things people build with this

USE CASE 1

Speed up git clone and GitHub file downloads when access is slow or unreliable.

USE CASE 2

Install npm packages faster by switching to a local mirror registry with one click.

USE CASE 3

Access Stack Overflow and other overseas websites by rerouting through faster channels.

USE CASE 4

Optimize DNS resolution to automatically pick the fastest server for any domain.

Tech stack

JavaScriptElectronNode.js

Getting it running

Difficulty · easy Time to first run · 5min
Use freely. If you modify a Mozilla Public Licensed file, share that file's changes back under the same license. Your other code stays yours.

In plain English

Dev-sidecar is a desktop tool for developers who have difficulty accessing GitHub and other overseas websites from within China due to internet restrictions. The name is inspired by the concept of a "sidecar", a helper that runs alongside your main work to smooth things out. It is a JavaScript application built with Electron, meaning it runs as a native desktop app. The core mechanism is a local proxy: Dev-sidecar intercepts your HTTPS web requests and reroutes them through faster, accessible mirror channels. It also performs smart DNS selection, querying multiple IP addresses for a domain and automatically picking the fastest one, which helps avoid the issue where a site resolves to a server that is unreliable or blocked. For GitHub specifically, the tool accelerates git clone operations, file downloads (releases, source archives, zip files), avatar loading, and raw file access. It also speeds up Stack Overflow (by rerouting certain JavaScript libraries to accessible alternatives) and offers a one-click switch between the official npm package registry and a local mirror registry, which helps when standard package installation is slow or fails. The app has two main modes: a "safe mode" that only does DNS optimization without installing a certificate, and a default mode that intercepts and re-routes traffic via a locally generated certificate. When you first open it, it will prompt you to install this local root certificate so your browser trusts the intercepted connections. It runs on desktop systems including Windows, Mac, and Linux. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
How do I set up dev-sidecar to speed up my GitHub clones and npm installs from China?
Prompt 2
Show me how to enable safe mode in dev-sidecar without installing a certificate.
Prompt 3
How does dev-sidecar's smart DNS selection work to find the fastest server?
Prompt 4
Can I use dev-sidecar to switch between npm registries, and how do I do it?
Prompt 5
What's the difference between dev-sidecar's default mode and safe mode?
Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.