Skip to content

Commit f2f3bc9

Browse files
ubershmekelkazupon
authored andcommitted
Clarification for runtime vs standalone (#663)
Removed some redundant language by including all the details in the bullet point comparison. Also added a note about Vuex requiring the standalone-build. Hopefully this is a bit more complete and easier to read.
1 parent 3be0e1c commit f2f3bc9

File tree

1 file changed

+3
-5
lines changed

1 file changed

+3
-5
lines changed

src/v2/guide/installation.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -46,13 +46,11 @@ $ npm install vue
4646

4747
### Standalone vs. Runtime-only Build
4848

49-
There are two builds available, the standalone build and the runtime-only build. The difference being that the former includes the **template compiler** and the latter does not.
49+
There are two builds available:
5050

51-
The template compiler is responsible for compiling Vue template strings into pure JavaScript render functions. If you want to use the `template` option, then you need the compiler.
51+
- `vue.common.js` - the standalone build - includes the template compiler and supports the `template` option. **It also relies on the presence of browser APIs so you cannot use it for server-side rendering.** The template compiler is responsible for compiling Vue template strings into pure JavaScript render functions. If you want to use the `template` option, then you need the compiler. The `Vuex` store requires the standalone build as well.
5252

53-
- The standalone build includes the compiler and supports the `template` option. **It also relies on the presence of browser APIs so you cannot use it for server-side rendering.**
54-
55-
- The runtime-only build does not include the template compiler, and does not support the `template` option. You can only use the `render` option when using the runtime-only build, but it works with single-file components, because single-file components' templates are pre-compiled into `render` functions during the build step. The runtime-only build is roughly 30% lighter-weight than the standalone build, weighing only {{ro_gz_size}}kb min+gzip.
53+
- `vue.js` - the runtime-only build - does not include the template compiler, and does not support the `template` option. You can use the `render` option when using the runtime-only build, but it only works with single-file components, because single-file components' templates are pre-compiled into `render` functions during the build step. The runtime-only build is roughly 30% lighter-weight than the standalone build, weighing only {{ro_gz_size}}kb min+gzip.
5654

5755
By default, the NPM package exports the **runtime-only** build. To use the standalone build, add the following alias to your Webpack config:
5856

0 commit comments

Comments
 (0)