Join an existing platform with a remote
Your platform already has a shell, and another team owns it. You own one or more remotes. mfeflow init --kind remote makes a repo with those remotes and no shell.
Before this, the only way to get such a repo was mfeflow add team-repo, run in the shell's repo of a polyrepo. That needs access to the shell's repo. This does not.
The repo field
mfeflow.json has a repo field that says what kind of repo it is. Absent, it is an app repo with a shell. platform is a repo of shared tooling. remote is a repo whose shell lives somewhere else, and it is the only kind that may have no shell in apps. The field does not say how many repos there are: a remotes-only repo made here has topology: "monorepo", because everything in it is in one workspace.
Create it
The last lines of the output:
--remotes needs at least one name. Without the flag you get one remote called catalog. --remotes none is an error, because a repo with no shell and no remotes has nothing in it. pnpm create mfeflow takes the same flags.
--shell is optional. It is where the deployed shell is: an https URL of its mf-manifest.json or of a registry index, or a file. It is the same thing --against takes. A file is recorded relative to the project. A URL with credentials or a token in it is refused, because mfeflow.json is committed. init does not fetch the address; doctor does.
What you get
There is no apps/shell and no registry/ folder. Which build of a remote each environment serves is recorded in the shell's repo, and so are the routes to it.
pnpm install, pnpm build, pnpm typecheck, pnpm lint and pnpm test all run. pnpm dev serves both remotes, and each one's mf-manifest.json answers on its port:
Features work as in any project. A feature that also changes the shell (theming, i18n, analytics-gtm, telemetry-otel, tailwind and others) writes its remote parts here and does not write the shell parts, so add it in the shell's repo too. This release does not list what was skipped.
Check it against the shell
Without a shell address, doctor says what it cannot do:
With --shell at init (or a shell field you add to mfeflow.json), doctor and check-compat read the deployed shell's shared versions from that address and the warning goes away:
The skipped check is the registry one: the registry is in the shell's repo. --against on the command line wins over the recorded address. A react version in your remotes that the shell does not provide is an error (E302), as in any project. See check-compat.
See a remote in the deployed shell
pnpm mfeflow dev runs the remotes, and with a recorded shell it prints how to see one there:
That limit is real. A shell built for production ignores mfe-override, so against a production shell this does not work. Ask the shell's owners for a development or preview build, or run a copy of the shell on your machine with mfeflow dev --remote cart=http://localhost:4311 (see Develop locally). We ran it once: a shell from a normal project, started with mfeflow dev --only shell --remote cart=http://localhost:4311 --remote checkout=http://localhost:4312, rendered both remotes of a repo made this way, checked with the Playwright smoke test the project ships.
Add a remote, deploy, upgrade
mfeflow add remote orders adds the app and nothing else. It writes no route and no registry entry, because both are in the shell's repo; ask the shell's owners to add them, or use mfeflow deploy if you publish your own registry.
mfeflow deploy works. If the host has no shell/mf-manifest.json, they warn no shell manifest at envs/staging/shell/mf-manifest.json; compat used workspace versions and carry on.
mfeflow upgrade --dry-run works and does not bring back a shell or a registry folder.
What it does not do
- It does not deploy or roll back a shell you do not own.
mfeflow adoptrefuses a project with only remotes (E124).- It does not check the shell's routes. Whether the shell sends
/cartto your remote is the shell's repo to say.
For a polyrepo where the same company owns every repo, see One repo per team.