Build Configuration

Recommended build configs for your static deployments.

Static Repo

This is an already built repository. To deploy this:

• Connect Repo
• Do not add a build command
• Do not add an output folder

Node Engine Settings

RunxBuild allows you to explicitly define the Node.js version used during build and runtime. By specifying an engines field in your package.json, you ensure consistent behavior across environments.

{
  "name": "my-awesome-project",
  "version": "1.0.0",
  "engines": {
    "node": "24.13.0"
  }
}

Next.js Static Export

RunxBuild can deploy Next.js as a static site when your project is exported to HTML. Set output to "export" so Next generates the out directory.

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: "export"
};
module.exports = nextConfig;

Configuration:

• Build Command: npm install && npm run build
• Publish Directory: out

package.json:

{
  "scripts": {
    "build": "next build --webpack"
  }
}

Vite Static Site

RunxBuild automatically detects Vite projects and builds them using vite build. Set your publish directory to dist.

Configuration:

• Build Command: npm install && npm run build
• Publish Directory: dist

Vue.js (Vite)

Configuration:

• Root Directory: /client
• Build Command: npm install && npm run build
• Publish Directory: dist

Docusaurus

Configuration:

• Build Command: npm install && npm run build
• Publish Directory: build

Svelte (Vite)

Configuration:

• Build Command: npm install && npm run build
• Publish Directory: dist

Angular

Configuration:

• Build Command: npm install && npm run build
• Publish Directory: dist/<project-name>

Astro

Configuration:

• Build Command: npm install && npm run build
• Publish Directory: dist

{
  "scripts": {
    "build": "astro build"
  }
}