cp examples/devsplit.yaml devsplit.yaml

Rode local só o serviço
que você está mexendo.

O devsplit divide o tráfego do gateway de stage. O serviço em que você trabalha cai na sua máquina; todo o resto faz passthrough pro ambiente real. Sem Docker, sem subir a stack inteira, sem mexer no front.

devsplit — interceptando api.stage.acme.dev
Tela de Rotas do devsplit: domínio api.stage.acme.dev interceptado, tabela de rotas marcando /transporte e /auth como local e /* como passthrough.
// o problema

Você só mudou um serviço.
Por que subir a stack inteira?

antes

Tudo local, na marra

Pra mexer numa coisa, você levanta o mundo — e ainda assim algo quebra.

  • Docker Compose com 12 serviços comendo a RAM
  • Banco, fila e auth de mentira pra "simular" o stage
  • Variáveis de ambiente desencontradas do real
  • 20 minutos de boot antes da primeira request
com devsplit

Local só onde importa

Roda na sua máquina o serviço do PR. O resto é o stage de verdade.

  • Um processo: o serviço que você está editando
  • passthrough pro stage real em tudo mais
  • Mesmo gateway, mesmo HTTPS, mesmos dados
  • Primeira request em segundos, não em minutos
// como funciona

Uma request entra. O devsplit decide o caminho.

Por prefixo de rota: o que casa com um serviço local cai na sua máquina; o resto segue passthrough pro gateway de stage — mesmo host, mesmo TLS.

Request devsplit :8443 serviço LOCAL localhost:3000 passthrough → stage api.stage.acme.dev
local — cai na sua máquina passthrough — segue pro stage real
// recursos

Devtool de verdade, não um mock.

Split por prefixo

Defina /auth ou /transporte como local; o curinga /* faz passthrough. Liga e desliga rota por rota.

Sem Docker

Um app desktop (Tauri) + devsplit.yaml + CLI. Nada de Compose, nada de stack inteira na sua RAM.

HTTPS confiável

CA local via mkcert assina o domínio interceptado. O browser confia, o front nem percebe.

Inspector de tráfego

Veja cada request com host, método, decisão (local/passthrough), status e latência P50/P95 por rota.

Detecção de serviços

O devsplit varre as portas locais e sugere rotas. Subiu o serviço? Ele aparece pronto pra ativar.

Perfis nomeados

Salve combinações de rotas por contexto — transporte, auth — e troque com um clique.

Saúde antes do split

Checagem de CA, entrada no hosts, porta livre e gateway alcançável — avisos antes de confiar no proxy.

Front intacto

O app aponta pro mesmo api.stage.acme.dev de sempre. Zero mudança de código no cliente.

// telas

O painel inteiro, sem firula.

Inspector de tráfego do devsplit: latência P50/P95 por rota e log de requests com método, host, decisão e status.
Tráfego — cada request com decisão, status e latência por rota.
Tela de Rotas do devsplit com tabela de prefixos local e passthrough.
Rotas — ligue o split por prefixo, com checagem de saúde.
Tela de Certificado do devsplit mostrando a CA mkcert instalada e confiável.
Certificado — CA mkcert que torna o HTTPS confiável.
// instalar

Do clone ao split em quatro comandos.

zsh — devsplit

          
Clonar no GitHub Linux, macOS e Windows · um único prompt de senha no primeiro start