build Command

Build your Frame-Master project for production deployment.

📖 Usage

Run the build command to create optimized production assets.

frame-master build

🔨 What It Does

The build command performs a complete production build:

Initialize server — loads configuration and initializes all plugins
Merge build configs — collects and merges buildConfig from all plugins
Trigger serverStart hook — executes all plugins' serverStart hooks
Run beforeBuild hooks — executes all plugins' beforeBuild hooks in parallel
Execute Bun.build() — bundles and optimizes all entrypoints
Run afterBuild hooks — executes all plugins' afterBuild hooks
Generate report — shows build summary with file sizes and statistics

📊 Build Output

Example output:

┌─────────────────────────────────────────┐
│  🔨 Starting Frame Master Build         │
└─────────────────────────────────────────┘
 
┌─────────────────────────────────────────┐
│  ✅ Build Completed Successfully        │
├─────────────────────────────────────────┤
│  Duration: 245.32ms                     │
│  Outputs:  12 files                     │
└─────────────────────────────────────────┘
 
📦 Build Summary:
  Total Size: 156.42KB
  Average Size: 13.04KB
 
🔝 Largest Files:
     45.23KB - build/client.js
     32.15KB - build/vendor.js
     28.67KB - build/styles.css

🔍 Verbose Mode

Enable detailed logging for debugging build issues.

frame-master --verbose build

Tip: Plugins can enable build logging by setting build.enableLoging: true in their configuration.

⚙️ Build Configuration

Configure the build through plugins.

import { defineConfig } from "frame-master";
 
export default defineConfig({
  plugins: [
    {
      name: "my-build-config",
      version: "1.0.0",
      build: {
        buildConfig: {
          minify: true,
          sourcemap: "external",
          target: "browser",
          external: ["react", "react-dom"],
        },
        beforeBuild: async (config, builder) => {
          console.log("Preparing build...");
        },
        afterBuild: async (config, result, builder) => {
          console.log(`Built ${result.outputs.length} files`);
        },
        enableLoging: true,
      },
    },
  ],
});

Info: See the Build System documentation at /docs/core/build for detailed configuration options.

📤 Exit Codes

0 — Build successful
1 — Build failed

Next Steps

start Command — Run in production mode
Build System — Configure build process
Build Hooks — Customize with plugins

Documentation