Flujo con Git

Fetchpier guarda todo en texto plano, así que podés usar Git para toda la colaboración: branches, reviews y diffs.

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

Qué versionar y qué no

La app asume este criterio por defecto y arma un .gitignore acorde al crear el workspace:

Ruta	Versionar	Motivo
requests/**/*.http	Sí	Son los requests: parte del código.
.fetchpier/settings.json	Sí	Configuración HTTP compartida del equipo.
environments/<env>/config.json	Depende	Si no contienen secretos, versionalos. Para los que sí, usá una carpeta environments/local/ ignorada.
requests/.runs/	No	Log local de cada send (antes “history”). Fetchpier lo agrega al .gitignore por default.
environments/<env>/.state/	No	State por environment, incluido el cookie jar — suelen ser sensibles. Ignorado por default.

Code review

Los .http diffean limpio porque cada request es una secuencia de líneas METHOD URL + headers + body. Tu equipo revisa cambios de API en el mismo pull request que el código que los consume.

Branches

Cada developer puede tener su propia branch con requests en progreso. Cuando mergeás a main, el watcher de Fetchpier recarga el árbol automáticamente si el workspace está abierto.

Tip: # @id para estabilidad de diffs

Al guardar un request desde la UI, Fetchpier escribe un # @id <uuid> al tope del archivo. Conservalo: la app lo usa para identificar el request entre renombres y hace que los diffs sean más estables en lugar de producir “archivo borrado + archivo nuevo”.