Skip to main content

Deployment

This docs site is set up for static deployment on Vercel.

  • Vercel

Current production URL target

  • https://docs.builderinsights.app

The docs site uses the new custom domain even though some repo and backend identifiers still use legacy devrel naming.

If you later move to a custom domain, update docusaurus.config.ts.

Required Vercel settings

SettingValue
Framework PresetOther
Install Commandnpm install
Build Commandnpm run build
Output Directorybuild

Repo support files

This repo includes vercel.json with the expected build configuration.

First deploy flow

  1. import the GitHub repo into Vercel
  2. keep the default root directory at the repo root
  3. confirm the build and output settings
  4. deploy
  5. verify the generated site at the Vercel URL

After deployment

  • confirm home page renders correctly in light and dark theme
  • spot-check docs pages, screenshot pages, and navigation
  • verify image assets load correctly
  • verify internal links and sidebar navigation

If you add a custom domain later

Update:

  • docusaurus.config.ts url
  • any repo or product references that mention the default Vercel URL
  • Operations > Repository Setup
  • Operations > Screenshots