Frontend Development 6 min read

Modern.js Update: Windows Platform Support and Out‑of‑the‑Box Deployment Features

The latest Modern.js release adds Windows platform support, provides ready‑to‑use deployment capabilities—including built‑in web server, CDN upload to Alibaba Cloud OSS or Tencent COS, and static hosting—and outlines usage examples, configuration steps, changelog details, and upgrade guidance.

ByteDance Web Infra
ByteDance Web Infra
ByteDance Web Infra
Modern.js Update: Windows Platform Support and Out‑of‑the‑Box Deployment Features

The update introduces full Windows platform support for developing and using Modern.js, although the Unbundled mode is not yet available on Windows.

Example: MWA (Modern Web App) project – On Windows you can create a project with npx @modern-js/create , then run pnpm run dev for development and debugging, and use pnpm run new to enable extensions such as BFF. Unit and integration tests can be executed with pnpm run test .

Example: Monorepo project – Use pnpm run new to create sub‑projects, and within a module sub‑project run pnpm run new again to enable features like Storybook.

The release also provides out‑of‑the‑box deployment functionality:

Built‑in production‑grade web server.

CDN upload capability to Alibaba Cloud OSS or Tencent Cloud COS.

Support for third‑party static web servers (including CDN) to host build artifacts.

After enabling the deployment feature with the Modern.js generator, you only need to configure basic cloud platform information (e.g., SecretID , SecretKey , BucketName ) in a .env file or CI environment. Example environment variables are shown below:

# Alibaba Cloud Account ID (not required for Tencent Cloud)
CLOUD_ACCOUNT_ID
# Bucket name
CLOUD_BUCKET_NAME
# Deployment region
CLOUD_REGION

Sensitive credentials such as access keys must be set in the cloud platform’s secret management:

# Cloud platform AccessKey
CLOUD_SECRET_ID
# Cloud platform Secret Key
CLOUD_SECRET_KEY

Deployment can be performed with commands like pnpm run new , supporting Alibaba Cloud FC + OSS, Tencent Cloud SCF + COS, or static web server hosting. Mixed‑cloud deployments are not currently supported, and Monorepo deployment will be added in a future release.

The changelog lists numerous fixes and enhancements, including generator template updates, lint error fixes, Electron integration improvements, unbundled mode fixes, and Windows platform support.

Upgrade guidance advises deleting pnpm-lock.yaml or yarn.lock and reinstalling dependencies to use the latest Modern.js version; an automatic upgrade tool is planned for future releases.

For more information, refer to the official Modern.js documentation links provided in the article.

frontenddeploymentcloudpnpmModern.jsWindows Support
ByteDance Web Infra
Written by

ByteDance Web Infra

ByteDance Web Infra team, focused on delivering excellent technical solutions, building an open tech ecosystem, and advancing front-end technology within the company and the industry | The best way to predict the future is to create it

0 followers
Reader feedback

How this landed with the community

login Sign in to like

Rate this article

Was this worth your time?

Sign in to rate
Discussion

0 Comments

Thoughtful readers leave field notes, pushback, and hard-won operational detail here.