Error codes

Every error the CLI prints has a code like MFEFLOW_E102, a cause, a fix and a link to a page. This page lists them all. The first digit is the area, and it sets the exit code. Messages that start with MFE_ come from the browser runtime. Those are covered in Troubleshooting.

Project and config (E1xx, exit code 3)

Code	Meaning
E101	A shared singleton is missing from the shared list
E102	No mfeflow.json found
E103	mfeflow.json is not valid JSON
E104	mfeflow.json does not match its schema
E105	A path points outside the project
E106	A file could not be read or written
E107	A command-line option is missing or not valid
E108	The target folder is not empty
E109	The preset could not be used
E110	--local does not point at a built mfeflow checkout
E111	A workspace package has no version
E112	An app in mfeflow.json is not on disk
E113	mfeflow.app.json is missing or invalid
E114	A registry entry is missing or invalid
E115	Two apps use the same port
E116	Two remotes claim routes that overlap, or an app file disagrees with mfeflow.json
E117	A copied file changed since mfeflow wrote it
E118	.env.example does not match the keys in env.ts
E119	A runtime-config file does not match the runtime-config schema
E120	A PUBLIC_ variable would be baked into the bundle
E121	A server env key is not listed in turbo.json
E122	An app has both mfeflow.app.json and the old mfe.json
E123	This folder already has an mfeflow.json
E124	adopt found nothing it can set up

Features (E2xx, exit code 4)

Code	Meaning
E201	Feature not found
E202	feature.json is invalid
E203	A third-party feature uses something third-party features may not
E204	Unknown transform op
E205	Feature conflicts with an installed feature
E206	Feature needs another feature first
E207	The feature wants to create or change something that already exists
E208	A file the feature edits is missing or not shaped as expected
E209	A template could not be rendered
E210	Registry namespace is not configured
E211	Files changed since the plan was made
E212	Applying the plan failed
E213	Installing dependencies failed
E214	A feature option is invalid
E215	The app name cannot be used

Build and runtime (E3xx, exit code 5)

Code	Meaning
E301	A singleton resolves to more than one version
E302	A remote is not compatible with its shell
E303	A runtime plugin imports a shared module
E304	A bundle is over its budget
E305	There is no build output to measure
E306	A dev server could not start
E307	The shell to check against could not be read

Registry (E4xx, exit code 6)

Code	Meaning
E401	Could not fetch from the registry
E402	The registry returned something that is not a feature
E403	The registry's index.json is not valid
E404	A feature in the registry folder cannot be published

E107 and E215 are command-line mistakes and exit with code 2. The E5xx range belongs to deploy, promote, rollback and status and exits with code 7:

Code	Meaning
E501	A deploy failed the schema gate
E502	A route of this remote overlaps a route of another remote
E503	The remote's shared ranges do not fit the shell that is deployed
E504	The remote is over its first-load JS budget
E505	A rollout was asked for, and a static host cannot split traffic
E506	The registry host is not set up or cannot be used
E507	There is no build output to deploy
E508	There is no such version to move to
E509	Files of the target version are missing on the host
E510	Another deploy changed the index at the same time
E511	This version is already published with different content
E512	Local registry files and the host disagree

Upgrade (E6xx, exit code 8)

Code	Meaning
E601	Cannot tell which version of mfeflow made the project
E602	The project is newer than the version you upgrade to
E603	A feature migration could not be loaded or failed
E604	Files you changed need a decision

#Error codes

#Project and config (E1xx, exit code 3)

#Features (E2xx, exit code 4)

#Build and runtime (E3xx, exit code 5)