Skip to content

Commit 1976f07

Browse files
committed
docs: Update FourEnvironments.md to reflect Native ESM Builds (#8763)
1 parent d0dbefd commit 1976f07

1 file changed

Lines changed: 8 additions & 8 deletions

File tree

learn/benefits/FourEnvironments.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -127,20 +127,20 @@ The Webpack build pipeline in `dist/production` applies aggressive optimizations
127127
* ***Dead Code Elimination*** (Tree Shaking): Removing any code that is not actually used by the application, further
128128
reducing bundle size.
129129

130-
### Simplified Single-File Deployment
130+
### Simplified Bundle Deployment
131131

132-
For environments where serving multiple module files isn't optimal, or for legacy server setups, `dist/production`
133-
provides the convenience of deploying just a few highly optimized bundle files.
132+
For environments where serving thousands of individual module files isn't optimal, `dist/production` provides the
133+
convenience of deploying a few highly optimized **Native ES Module bundles**. This significantly reduces the number of
134+
network requests compared to `dist/esm` while maintaining full compatibility with the browser's module loader.
134135

135-
In summary, `dist/production` is Neo.mjs's answer for maximum compatibility and minimal payload, offering a robust,
136-
Webpack-powered build that respects the engine's multi-threaded nature to deliver highly optimized bundles for each
137-
part of your application.
136+
In summary, `dist/production` is Neo.mjs's answer for maximum performance and minimal payload, offering a robust,
137+
Webpack-powered build that outputs modern, standard-compliant ESM bundles for each thread.
138138

139139
## dist/development: The Classic "Dev Mode"
140140

141141
The `dist/development` environment is Neo.mjs's response to what most other JavaScript frameworks—like Angular, React,
142-
Vue, or Solid—typically refer to as their "development mode." This environment generates a bundled but unminified version
143-
of your application, designed for a more traditional development workflow that includes a build step.
142+
Vue, or Solid—typically refer to as their "development mode." This environment generates **bundled Native ES Modules**
143+
(unminified), designed for a more traditional development workflow that includes a build step.
144144

145145
You'll primarily find yourself needing `dist/development` in very specific scenarios:
146146

0 commit comments

Comments
 (0)