Compartilhar um workspace com Git

O Fetchpier guarda tudo como texto plano, então você pode usar Git para toda a colaboração: branches, revisões e diffs.

git add users/ auth/
git commit -m "feat: add user and auth endpoints"
git push

O que versionar e o que não

O Fetchpier assume essa divisão por padrão e escreve um .gitignore correspondente ao criar um workspace:

Caminho	Versionar	Por quê
requests/**/*.http	Sim	São suas requisições — parte do código.
.fetchpier/settings.json	Sim	A configuração HTTP compartilhada da equipe.
environments/<env>/config.json	Depende	Versione se não tiver segredos. Para os que têm, use uma pasta environments/local/ ignorada.
requests/.runs/	Não	Log local por envio. O Fetchpier o adiciona ao .gitignore por padrão.
environments/<env>/.state/	Não	Estado por ambiente, incluindo o cookie jar — costuma ser sensível. Ignorado por padrão.

Code review

Arquivos .http geram diffs limpos porque cada requisição é uma sequência de linhas METHOD URL mais cabeçalhos e body. Sua equipe revisa mudanças de API no mesmo pull request do código que as consome.

Branches

Cada dev pode ter sua própria branch com requisições em andamento. Quando você faz merge na main, o observador do Fetchpier recarrega a árvore automaticamente se o workspace estiver aberto.

Dica: # @id para diffs estáveis

Ao salvar uma requisição pela UI, o Fetchpier escreve um # @id <uuid> no topo do arquivo. Mantenha-o: o app o usa para identificar a requisição entre renames, o que torna os diffs mais estáveis em vez de produzir um “arquivo apagado + arquivo novo”.