Configuration

IDE configuration

product.json

Product identity for the IDE, at the project root:

{
  "productName": "MiniDev Studio",
  "applicationName": "minidev-studio",
  "dataFolderName": ".minidev-studio",
  "version": "1.3.6",
  "urlProtocol": "minidev-studio",
  "darwinBundleIdentifier": "com.woodare.minidev-studio"
}

Environment variables

Configure the development environment via a .env file (see .env.sample):

Variable	Description	Default
IDE_SERVER_PORT	Node server port	Auto-assigned
WS_PATH	WebSocket path	Default path
OPENSUMI_DEVTOOLS	Enable IDE DevTools	false

# .env
OPENSUMI_DEVTOOLS=true
IDE_SERVER_PORT=8080

Compiler configuration

The simulator is compiled with Vite. The compiler picks behavior from app.json’s framework field:

framework	Compiler behavior
vue	Vue 3 plugin set; resolves .vue pages
react	React plugin set; resolves .tsx / .jsx pages

Vite plugin: vite-plugin-minidev

The built-in Vite plugin in the IDE is responsible for:

1. Shell HTML injection — produces container pages with NavBar / TabBar / StatusBar
2. rpx → vw — rpx in CSS is converted to vw automatically
3. Bridge API injection — injects window.__MINIDEV__ via the preload script

The rpx unit

rpx (responsive pixel) is a responsive unit for mini programs. 1rpx = screen width / 750. The compiler converts to vw so layouts display correctly in the simulator.

Common commands

# IDE development
yarn                     # Install dependencies
yarn rebuild-native      # Rebuild native modules
yarn download-extension  # Download VS Code extensions

# Start
yarn start               # Full build, then start
yarn start:dev           # Incremental build + hot watch (recommended)
yarn start:quick         # Start without build (requires existing out/)

# Debug
OPENSUMI_DEVTOOLS=true yarn start  # Open DevTools

# Package
yarn make                # Build installers