Preview Options #

preview.host #

• Type: string | boolean
• Default: server.host

Specify which IP addresses the server should listen on. Set this to 0.0.0.0 or true to listen on all addresses, including LAN and public addresses.

This can be set via the CLI using --host 0.0.0.0 or --host.

preview.port #

• Type: number
• Default: 4173

Specify server port. Note if the port is already being used, Wite will automatically try the next available port so this may not be the actual port the server ends up listening on.

Example:

export default defineConfig({
  server: {
    port: 3030
  },
  preview: {
    port: 8080
  }
})

preview.strictPort #

• Type: boolean
• Default: server.strictPort

Set to true to exit if port is already in use, instead of automatically trying the next available port.

preview.https #

• Type: boolean | https.ServerOptions
• Default: server.https

Enable TLS + HTTP/2. Note this downgrades to TLS only when the server.proxy option is also used.

The value can also be an options object passed to https.createServer().

preview.open #

• Type: boolean | string
• Default: server.open

Automatically open the app in the browser on server start. When the value is a string, it will be used as the URL's pathname. If you want to open the server in a specific browser you like, you can set the env process.env.BROWSER (e.g. firefox). See the open package for more details.

preview.proxy #

• Type: Record<string, string | ProxyOptions>
• Default: server.proxy

Configure custom proxy rules for the dev server. Expects an object of { key: options } pairs. If the key starts with ^, it will be interpreted as a RegExp. The configure option can be used to access the proxy instance.

Uses http-proxy. Full options here.

preview.cors #

• Type: boolean | CorsOptions
• Default: server.cors

Configure CORS for the dev server. This is enabled by default and allows any origin. Pass an options object to fine tune the behavior or false to disable.