EdgeOne Pages

EdgeOne Pages is a deployment platform developed by Tencent. It supports server capabilities such as SSR and HTML streaming.

Get started

1. Install

Install the EdgeOne Vite adapter:

npm install @edgeone/vite

pnpm add @edgeone/vite

bun add @edgeone/vite

yarn add @edgeone/vite

// vite.config.js
 
import vike from 'vike/plugin'
import edgeone from '@edgeone/vite'
 
export default {
  plugins: [vike(), edgeone({ serverWrapper: 'vike' })]
}

The build command remains $ vike build.

2. Deploy

Git Connection Deployment

Push your project to GitHub or GitLab, then connect it to EdgeOne Pages.

CLI Deployment

Install the EdgeOne CLI:

npm install -g edgeone

pnpm add -g edgeone

bun add --global edgeone

yarn global add edgeone

Then deploy:

edgeone pages deploy

Settings

The edgeone() Vite plugin accepts the following optional configurations:

serverWrapper ('vike' | 'autoDetect' | 'ssrRender' | 'webHandler'): Server runtime mode. Set to 'vike' when deploying Vike projects. 'autoDetect' will automatically select based on whether the Vike plugin is used.
clientBuildDir (string): Client build output directory. Overrides the default dist/client detection.
serverBuildDir (string): Server build output directory. Overrides the default dist/server detection.
serverEntry (string): Server entry file path. Overrides the default entry-server.js detection.
routes (string[]): Custom route list (e.g., ['/', '/about']). When not provided, Vike automatically scans the pages/ directory.
ssr (boolean): Enable SSR. By default, the adapter infers this based on your project.