🚀 single-spa-react-cli

Opinionated CLI to bootstrap a production-ready Single-SPA microfrontend workspace in minutes — not hours.

Stop wiring ports, aligning dependencies, and manually registering applications every time you start a new microfrontend project.
This CLI generates a fully configured, consistent, scalable foundation so you can focus on building features instead of assembling infrastructure.

✨ Why This Tool Exists

Setting up a Single-SPA workspace repeatedly involves:

• Recreating root-config and MFEs
• Fixing port collisions
• Aligning React versions across apps
• Registering applications manually
• Updating import maps
• Installing dependencies one-by-one

These steps are repetitive, error-prone, and slow down teams.

single-spa-react-cli automates all of it — with deterministic, standardized output.

🧠 What You Get Instantly

• ✅ Root config + multiple MFEs scaffolded in one command
• ✅ Predictable port allocation (no conflicts)
• ✅ Version consistency across all microfrontends
• ✅ Applications auto-registered into the shell
• ✅ Import maps generated and wired automatically
• ✅ Clean, ready-to-run local development environment
• ✅ Zero manual configuration required

📦 Installation

You don’t install it globally. Just run:

npx single-spa-react-cli

🛠️ Ideal For

• Teams adopting microfrontend architecture
• Internal platform engineering
• Enterprise UI modernization
• Proof-of-concept environments that must scale later
• Developers tired of repeating the same setup steps

🤝 Contributing

Contributions, ideas, and improvements are welcome. Open an issue to discuss enhancements or workflow additions.