vitejs · May 18, 2021 · May 19, 2021 · May 21, 2021 · May 21, 2021 · May 21, 2021
diff --git a/docs/.vitepress/theme/index.js b/docs/.vitepress/theme/index.js
@@ -19,7 +19,7 @@ export default {
             },
             [h('span', 'Sponsors')]
           ),
-          ...sponsors.map(({ href, src, name }) =>
+          ...sponsors.map(({ href, src, name, id }) =>
             h(
               'a',
               {
@@ -28,7 +28,7 @@ export default {
                 rel: 'noopener',
                 'aria-label': 'sponsor-img'
               },
-              [h('img', { src, alt: name })]
+              [h('img', { src, alt: name, id: `sponsor-${id}` })]
             )
           )
         ])

diff --git a/docs/.vitepress/theme/sponsors.css b/docs/.vitepress/theme/sponsors.css
@@ -9,7 +9,7 @@
 
 .sponsors img {
   max-width: 200px;
-  max-height: 40px;
+  height: 40px;
   display: block;
   margin: 1.25rem 0;
 }
@@ -29,3 +29,8 @@
   font-size: 1.2rem;
   border: none;
 }
+
+/* special cases */
+#sponsor-mux {
+  padding: 5px 0;
+}
diff --git a/docs/.vitepress/theme/sponsors.json b/docs/.vitepress/theme/sponsors.json
@@ -1,12 +1,20 @@
 [
   {
+    "id": "tailwind",
     "name": "Tailwind Labs",
     "href": "https://tailwindcss.com",
     "src": "/tailwind-labs.svg"
   },
   {
+    "id": "vuejobs",
     "name": "Vue Jobs",
     "href": "https://vuejobs.com/?ref=vuejs",
     "src": "/vuejobs.png"
+  },
+  {
+    "id": "mux",
+    "name": "Mux",
+    "href": "https://mux.com",
+    "src": "/mux.svg"
   }
 ]
diff --git a/docs/config/index.md b/docs/config/index.md
@@ -430,6 +430,42 @@ export default async ({ command, mode }) => {
 
   File system watcher options to pass on to [chokidar](https://github.com/paulmillr/chokidar#api).
 
+### server.middlewareMode
+
+- **Type:** `'ssr' | 'html'`
+
+  Create Vite server in middleware mode. (without a HTTP server)
+
+  - `'ssr'` will disable Vite's own HTML serving logic so that you should serve `index.html` manually.
+  - `'html'` will enable Vite's own HTML serving logic.
+
+- **Related:** [SSR - Setting Up the Dev Server](/guide/ssr#setting-up-the-dev-server)
+
+- **Example:**
+```js
+const express = require('express')
+const { createServer: createViteServer } = require('vite')
+
+async function createServer() {
+  const app = express()
+
+  // Create vite server in middleware mode.
+  const vite = await createViteServer({
+    server: { middlewareMode: 'ssr' }
+  })
+  // Use vite's connect instance as middleware
+  app.use(vite.middlewares)
+
+  app.use('*', async (req, res) => {
+    // If `middlewareMode` is `'ssr'`, should serve `index.html` here.
+    // If `middlewareMode` is `'html'`, there is no need to serve `index.html`
+    // because Vite will do that.
+  })
+}
+
+createServer()
+```
+
 ### server.fsServe.strict
 
 - **Experimental**

diff --git a/docs/guide/features.md b/docs/guide/features.md
@@ -38,7 +38,13 @@ Note that because `esbuild` only performs transpilation without type information
 
 ### Client Types
 
-Vite's default types are for its Node.js API. To shim the environment of client side code in a Vite application, add `vite/client` to `compilerOptions.types` of your `tsconfig`:
+Vite's default types are for its Node.js API. To shim the environment of client side code in a Vite application, add a `d.ts` declaration file:
+
+```typescript
+/// <reference types="vite/client" />
+```
+
+Also, you can add `vite/client` to `compilerOptions.types` of your `tsconfig`:
 
 ```json
 {

diff --git a/docs/guide/index.md b/docs/guide/index.md
@@ -52,6 +52,7 @@ yarn create @vitejs/app my-vue-app --template vue
 Supported template presets include:
 
 - `vanilla`
+- `vanilla-ts`
 - `vue`
 - `vue-ts`
 - `react`

diff --git a/docs/guide/ssr.md b/docs/guide/ssr.md
@@ -10,6 +10,10 @@ SSR specifically refers to front-end frameworks (for example React, Preact, Vue,
 The following guide also assumes prior experience working with SSR in your framework of choice, and will only focus on Vite-specific integration details.
 :::
 
+:::warning Low-level API
+This is a low-level API meant for library and framework authors. If your goal is to create an application, make sure to check out the higher-level SSR plugins and tools at [Awesome Vite SSR section](https://github.com/vitejs/awesome-vite#ssr) first. That said, many applications are successfully built directly on top of Vite's native low-level API.
+:::
+
 :::tip Help
 If you have questions, the community is usually helpful at [Vite Discord's #ssr channel](https://discord.gg/PkbxgzPhJv).
 :::
@@ -71,8 +75,11 @@ async function createServer() {
 
   // Create vite server in middleware mode. This disables Vite's own HTML
   // serving logic and let the parent server take control.
+  //
+  // If you want to use Vite's own HTML serving logic (using Vite as
+  // a development middleware), using 'html' instead.
   const vite = await createViteServer({
-    server: { middlewareMode: true }
+    server: { middlewareMode: 'ssr' }
   })
   // use vite's connect instance as middleware
   app.use(vite.middlewares)

diff --git a/docs/index.md b/docs/index.md
@@ -25,8 +25,8 @@ footer: MIT Licensed | Copyright © 2019-present Evan You & Vite Contributors
 
 <div class="frontpage sponsors">
   <h2>Sponsors</h2>
-  <a v-for="{ href, src, name } of sponsors" :href="href" target="_blank" rel="noopener" aria-label="sponsor-img">
-    <img :src="src" :alt="name">
+  <a v-for="{ href, src, name, id } of sponsors" :href="href" target="_blank" rel="noopener" aria-label="sponsor-img">
+    <img :src="src" :alt="name" :id="`sponsor-${id}`">
   </a>
   <br>
   <a href="https://github.com/sponsors/yyx990803" target="_blank" rel="noopener">Become a sponsor on GitHub</a>

diff --git a/docs/public/mux.svg b/docs/public/mux.svg
diff --git a/packages/create-app/CHANGELOG.md b/packages/create-app/CHANGELOG.md
@@ -1,3 +1,12 @@
+## [2.3.2](https://github.com/vitejs/vite/compare/create-app@2.3.1...create-app@2.3.2) (2021-05-25)
+
+
+### Features
+
+* **create-app:** improve client types ([#3214](https://github.com/vitejs/vite/issues/3214)) ([ba8b7af](https://github.com/vitejs/vite/commit/ba8b7afa650277b7218e0bd53564b5fb45bf4549))
+
+
+
 ## [2.3.1](https://github.com/vitejs/vite/compare/create-app@2.3.0...create-app@2.3.1) (2021-05-17)
 
 

diff --git a/packages/create-app/package.json b/packages/create-app/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@vitejs/create-app",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "license": "MIT",
   "author": "Evan You",
   "bin": {

diff --git a/packages/create-app/template-lit-element-ts/package.json b/packages/create-app/template-lit-element-ts/package.json
@@ -18,7 +18,7 @@
     "lit-element": "^2.4.0"
   },
   "devDependencies": {
-    "vite": "^2.3.3",
+    "vite": "^2.3.4",
     "typescript": "^4.1.3"
   }
 }
diff --git a/packages/create-app/template-lit-element-ts/src/vite-env.d.ts b/packages/create-app/template-lit-element-ts/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
diff --git a/packages/create-app/template-lit-element-ts/tsconfig.json b/packages/create-app/template-lit-element-ts/tsconfig.json
@@ -2,7 +2,6 @@
   "compilerOptions": {
     "module": "esnext",
     "lib": ["es2017", "dom", "dom.iterable"],
-    "types": ["vite/client"],
     "declaration": true,
     "emitDeclarationOnly": true,
     "outDir": "./types",

diff --git a/packages/create-app/template-lit-element/package.json b/packages/create-app/template-lit-element/package.json
@@ -16,6 +16,6 @@
     "lit-element": "^2.4.0"
   },
   "devDependencies": {
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/packages/create-app/template-preact-ts/package.json b/packages/create-app/template-preact-ts/package.json
@@ -12,6 +12,6 @@
   "devDependencies": {
     "@preact/preset-vite": "^2.0.0",
     "typescript": "^4.1.3",
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/packages/create-app/template-preact-ts/src/vite-env.d.ts b/packages/create-app/template-preact-ts/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
diff --git a/packages/create-app/template-preact-ts/tsconfig.json b/packages/create-app/template-preact-ts/tsconfig.json
@@ -2,7 +2,6 @@
   "compilerOptions": {
     "target": "ESNext",
     "lib": ["DOM", "DOM.Iterable", "ESNext"],
-    "types": ["vite/client"],
     "allowJs": false,
     "skipLibCheck": false,
     "esModuleInterop": false,

diff --git a/packages/create-app/template-preact/package.json b/packages/create-app/template-preact/package.json
@@ -11,6 +11,6 @@
   },
   "devDependencies": {
     "@preact/preset-vite": "^2.0.0",
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/packages/create-app/template-react-ts/package.json b/packages/create-app/template-react-ts/package.json
@@ -15,6 +15,6 @@
     "@types/react-dom": "^17.0.0",
     "@vitejs/plugin-react-refresh": "^1.3.1",
     "typescript": "^4.1.2",
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/packages/create-app/template-react-ts/src/vite-env.d.ts b/packages/create-app/template-react-ts/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
diff --git a/packages/create-app/template-react-ts/tsconfig.json b/packages/create-app/template-react-ts/tsconfig.json
@@ -2,7 +2,6 @@
   "compilerOptions": {
     "target": "ESNext",
     "lib": ["DOM", "DOM.Iterable", "ESNext"],
-    "types": ["vite/client"],
     "allowJs": false,
     "skipLibCheck": false,
     "esModuleInterop": false,

diff --git a/packages/create-app/template-react/package.json b/packages/create-app/template-react/package.json
@@ -12,6 +12,6 @@
   },
   "devDependencies": {
     "@vitejs/plugin-react-refresh": "^1.3.1",
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/packages/create-app/template-svelte-ts/package.json b/packages/create-app/template-svelte-ts/package.json
@@ -11,6 +11,6 @@
     "svelte": "^3.37.0",
     "svelte-preprocess": "^4.7.2",
     "typescript": "^4.2.4",
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/...te-app/template-svelte-ts/src/global.d.ts → ...-app/template-svelte-ts/src/vite-env.d.ts b/...te-app/template-svelte-ts/src/global.d.ts → ...-app/template-svelte-ts/src/vite-env.d.ts
diff --git a/packages/create-app/template-svelte/package.json b/packages/create-app/template-svelte/package.json
@@ -9,6 +9,6 @@
   "devDependencies": {
     "@sveltejs/vite-plugin-svelte": "^1.0.0-next.7",
     "svelte": "^3.37.0",
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/...reate-app/template-svelte/src/global.d.ts → ...ate-app/template-svelte/src/vite-env.d.ts b/...reate-app/template-svelte/src/global.d.ts → ...ate-app/template-svelte/src/vite-env.d.ts
diff --git a/packages/create-app/template-vanilla-ts/package.json b/packages/create-app/template-vanilla-ts/package.json
@@ -8,6 +8,6 @@
   },
   "devDependencies": {
     "typescript": "^4.2.3",
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }
diff --git a/packages/create-app/template-vanilla-ts/src/vite-env.d.ts b/packages/create-app/template-vanilla-ts/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="vite/client" />
diff --git a/packages/create-app/template-vanilla-ts/tsconfig.json b/packages/create-app/template-vanilla-ts/tsconfig.json
@@ -8,7 +8,6 @@
     "sourceMap": true,
     "resolveJsonModule": true,
     "esModuleInterop": true,
-    "types": ["vite/client"],
     "noEmit": true,
     "noUnusedLocals": true,
     "noUnusedParameters": true,

diff --git a/packages/create-app/template-vanilla/package.json b/packages/create-app/template-vanilla/package.json
@@ -7,6 +7,6 @@
     "serve": "vite preview"
   },
   "devDependencies": {
-    "vite": "^2.3.3"
+    "vite": "^2.3.4"
   }
 }