Skip to main content

Build Settings

Configure how WebStadia builds your site from source code.

Configuration options

SettingDescriptionExample
Build CommandThe command to build your sitenpm run build
Install CommandThe command to install dependenciesnpm install
Publish DirectoryThe directory containing your built sitedist, build, .next
Root DirectoryThe subdirectory for monoreposapps/web, packages/site

Setting build configuration

  1. Go to your site's Settings tab
  2. Under Configuration, update the fields
  3. Click Save

Changes take effect on the next deployment.

Root Directory (Monorepos)

If your repository is a monorepo with multiple projects, set the Root Directory to the subdirectory containing your site.

For example, if your repo structure looks like:

my-monorepo/
├── apps/
│ ├── web/ ← your site
│ │ ├── package.json
│ │ └── src/
│ └── api/
├── packages/
└── package.json

Set the root directory to apps/web. WebStadia will:

  1. cd into apps/web
  2. Run the install command
  3. Run the build command
  4. Look for build output in apps/web/{publishDir}

Environment Variables

You can set environment variables that are available during the build process. See Environment Variables.