X-Filter

Deployment

The docs website is a fully static Next.js export. It does not depend on redirects, rewrites, cookies, Server Actions, or request-time route handlers.

Vercel settings

Use the root of the monorepo as the project directory and the web package as the build target.

pnpm --filter @x-filter/web... build

The build writes static files to:

apps/web/out

Static export constraints

The site intentionally uses explicit routes instead of framework i18n routing:

LocaleRoute shape
English/docs, /playground, /changelog
Chinese/zh/docs, /zh/playground, /zh/changelog

This keeps the site compatible with output: 'export' and avoids runtime locale detection.

Local preview

pnpm --filter @x-filter/web... build
pnpm --filter @x-filter/web preview

Notes

  • Images are configured as unoptimized for static export.
  • The docs shell is custom, while Nextra compiles MDX pages.
  • Workspace packages are built before the web build so Vercel can resolve package exports.