BUOY

tools / impersonate

Become any user in two taps

Reproducing a user-specific bug usually means logging out, finding credentials, and losing your app state. Buoy Impersonate injects impersonation headers into every network request instead — your backend sees the target user while you keep your session, so switching users, roles, and flag cohorts takes seconds.

Read the docsnpm i @buoy-gg/impersonate

What it does

Header-based impersonation

Configurable headers ride along on every request — your backend decides what they mean, Buoy makes them effortless to set.

No logout, no rebuild

Keep your session and app state while the app behaves as the target user.

QA and support superpower

Support can reproduce exactly what a customer sees from their own device, in staging or production.

Frequently asked questions

How does impersonation work — does it bypass my auth?

No. Buoy only attaches the headers you configure to outgoing requests. Your backend implements what impersonation means and enforces who may use it — Buoy is the on-device switch.

Can I test feature flags for different user cohorts?

Yes — if your flag service keys off user identity or headers, switching the impersonated user flips the flags the app receives.

Add Impersonate to your app

Free for on-device debugging. Two-minute install, no native code.

Quick startnpm i @buoy-gg/core

Works well with

Network Inspector

@buoy-gg/network

Environment Inspector

@buoy-gg/env

Storage Explorer

@buoy-gg/storage