Plugin Lifecycle

Understanding how plugins are loaded, initialized, and executed in Frame-Master.

🔄 Lifecycle Overview

Plugins go through distinct phases during the server lifecycle.

Initialization

Plugins loaded, sorted by priority, requirements validated

Server Startup

serverStart hooks execute, runtime plugins loaded

Request Processing

Router hooks handle each HTTP request

Build Process

Build hooks customize compilation

📋 Execution Flow

When and how each hook type executes.

// Server Start (once)

serverStart.main() → serverStart.dev_main()

// Each Request

before_request → request → after_request → html_rewrite → global_value_injection

// Build

buildConfig → beforeBuild → [Bun Build] → afterBuild

📊 Priority Order

Lower priority numbers execute first.

frame-master.config.ts

export default defineConfig({
  plugins: [
    logging(),   // priority: 100 → runs last
    reactSSR(),  // priority: 50  → runs mid
    session(),   // priority: 10  → runs second
    auth(),      // priority: 0   → runs first
  ],
}); // Order: auth → session → reactSSR → logging