Coming from emulate

Every name that changed when emulate became Baseline, in one place.

Baseline is the continuation of the emulate project, renamed and moved to deploybaseline/cli. The rename is a hard cut: there is no compatibility layer, no fallback for old names, and no deprecation window. The old emulate and @emulators/* packages stay on npm unchanged, so nothing breaks until you switch.

To switch, apply every row below that applies to your project. Searching your repository for emulate, @emulators/, EMULATE_, and _emulate finds almost everything.

Packages and imports

Before	After
emulate (npm package)	@deploybaseline/cli
emulate (bin)	baseline
npx emulate	npx @deploybaseline/cli
@emulators/core	@deploybaseline/core
@emulators/<provider>	@deploybaseline/<provider>
import { createEmulator, defineEmulator, defineConfig } from "emulate"	import { createEmulator, defineEmulator, defineConfig } from "@deploybaseline/cli"
@emulators/mongoatlas	Removed, see Removed

createEmulator, defineEmulator, defineConfig, the word “emulator” in other APIs, and the <SERVICE>_EMULATOR_URL environment variables are unchanged.

Configuration, files, and environment variables

Before	After
emulate.config.{yaml,yml,json,ts,js,mjs,mts}	baseline.config.{yaml,yml,json,ts,js,mjs,mts} (old names are not detected)
EmulateConfig (type)	BaselineConfig
.emulate-secrets.json	.baseline-secrets.json
.emulate/state.json (docs and examples)	.baseline/state.json
// @emulate:services, // @emulate:imports (config markers)	// @baseline:services, // @baseline:imports
EMULATE_BASE_URL	BASELINE_BASE_URL
EMULATE_PORT	BASELINE_PORT
EMULATE_DEBUG	BASELINE_DEBUG
Custom emulator kind: "emulate.http"	kind: "baseline.http" (set by defineEmulator; only matters if you build definitions by hand)

Routes

Before	After
/_emulate (inspector)	/_baseline
/_emulate/reset	/_baseline/reset
/_emulate/installation-tokens (GitHub)	/_baseline/installation-tokens
/_emulate/sharepoint/* (Microsoft SharePoint control plane)	/_baseline/sharepoint/*
/_emulate/fonts/*, /_emulate/favicon.ico	/_baseline/fonts/*, /_baseline/favicon.ico
Error body documentation_url: https://emulate.dev/<service>	https://docs.deploybaseline.com/<service>

Default ports

mongoatlas is gone, so the services after it moved down by one. Every other default port is unchanged.

Service	Before	After
Clerk	4011	4010
Linear	4012	4011
Twilio	4013	4012

Pin ports in your config (services.<name>.port) if you need the old values.

Default fixtures

These defaults apply when your seed config does not set the value.

Provider	Before	After
Slack	team name Emulate, domain emulate, verification token emulate-verification-token	Baseline, baseline, baseline-verification-token
Slack	user emails *@emulate.dev, bot emails *@bots.emulate.dev	*@deploybaseline.com, *@bots.deploybaseline.com
Linear	organization Emulate, URL key emulate	Baseline, baseline
Clerk	OAuth client clerk_emulate_client / clerk_emulate_secret, session client_id default client_emulate, app name Emulate App	clerk_baseline_client / clerk_baseline_secret, client_baseline, Baseline App
Google	Gmail Message-ID domain emulate.google.local, Meet link emulate-standup	baseline.google.local, baseline-standup
GitHub	OAuth session cookie _emu_session, zen default emulate says hello!	_baseline_session, baseline says hello!
OIDC providers	JWT kid emulate-<provider>-1 (Apple, Clerk, Google, Microsoft, Okta)	baseline-<provider>-1
Example config	OAuth clients emu_<provider>_client_id / emu_<provider>_client_secret	baseline_<provider>_client_id / baseline_<provider>_client_secret

If your tests assert on any of these values, update the assertions or set the old value in your seed config.

Removed

Removed	Why	Instead
mongoatlas service and @emulators/mongoatlas	MongoDB retired the Atlas Data API in 2025	Run MongoDB locally (for example the mongo Docker image)
@emulators/adapter-next, @emulators/adapter-nuxt, createEmulateHandler, withEmulate	Baseline runs as a standalone service, not inside your app	Run the CLI or createEmulator next to your app and point SDKs at its URL
--portless flag and PORTLESS_URL	Coupled the CLI to an external tool	--base-url "https://{service}.localhost" behind any reverse proxy, see Local HTTPS

Links

Before	After
https://emulate.dev	https://docs.deploybaseline.com
The emulate GitHub repository	https://github.com/deploybaseline/cli