Requirements and compatibility
Choose the right Node.js, Nx, TypeScript, package manager, and platform toolchains for your Megamono workspace.
These requirements describe the 0.1.0-next.0 packages published on npm. This is a prerelease version. Megamono's local commands and packages are MIT licensed and work without a hosted account or subscription.
Workspace toolchains
Creating a new workspace uses a reviewed set of pinned toolchain versions. Adopting an existing Nx repository accepts a broader range so you can preserve its established setup.
| Toolchain | New workspace | Existing Nx workspace |
|---|---|---|
| Node.js | >=24 <25 | >=18.18 <25 |
| Nx | >=23.1 <24 | >=17 <24 |
| TypeScript | >=6.0 <6.1 | >=5.2 <7 |
Ranges use npm semver syntax: >= includes the stated minimum, and < excludes the stated upper limit. Platform plugins can impose a higher minimum than the core adoption tools.
Generated frameworks and existing applications can have additional runtime requirements. Check their own dependencies before changing the repository toolchain.
Start with Create a workspace or Adopt an existing workspace.
Package managers
| Package manager | New workspace | Existing Nx workspace |
|---|---|---|
| npm | >=11 <12 | >=9 <12 |
| pnpm | >=11 <12 | >=8 <12 |
| yarn | >=1.22 <5 | >=1.22 <5 |
| bun | >=1.1 <2 | >=1.1 <2 |
The documentation defaults to npm. Use the package-manager selector beside docs search to display commands for your workspace. Yarn examples use Yarn 2+ syntax; the accepted package range also includes Yarn Classic.
Platform plugins
Check the plugin you intend to use in addition to the core workspace requirements. Laravel and NativePHP use a newer Node.js and Nx baseline than the other platform plugins.
| Platform | Node.js | Nx |
|---|---|---|
| Swift and Xcode | >=18.18 <25 | >=18 <24 |
| Rust and Cargo | >=18.18 <25 | >=18 <24 |
| Cloudflare Workers | >=18.18 <25 | >=18 <24 |
| Browser extensions | >=18.18 <25 | >=18 <24 |
| Render deployments | >=18.18 <25 | >=18 <24 |
| Laravel | >=22 <25 | >=22 <24 |
| NativePHP | >=22 <25 | >=22 <24 |
Cloudflare also requires Wrangler >=4.105 <5.
NativePHP also requires the Laravel plugin. Native SDKs, Cargo, Swift, Xcode, PHP, Composer, and deployment tools remain platform-specific requirements; follow the linked platform guide for setup.
Playstack integrations
Megamono's Playstack integration tooling requires Node.js >=20 and ESLint >=9 <11. Keep within the workspace's Node.js range too. Each selected Playstack package has its own framework, provider, and package-access requirements.
Follow Integrate Playstack to review the application wiring and test a capability before switching behavior.
Check your workspace
Inspect the active toolchain before installing a plugin or changing versions:
node --version
npm exec -- nx reportUse package diagnostics to identify the installed Megamono packages. Review the installed package requirements when upgrading; this page follows the release documented by the site.
