New Feature

• CLI tool

frame-master debug build

this will start a Debug server + Web UI for investigating between plugins onLoad/finally hooks in a Diff monaco-editor.

new features

• onReady hook ( triggered when the server is ready and every components are loaded )

improvement

• general better code quality

3.1.1 Release

---

Highlights

• Improved Windows Compatibility:
  • The CLI tool now uses a simplified versioning approach to resolve compatibility issues on Windows platforms.
  • Template extraction and file operations have been fully tested and verified on Linux, Windows 11 and MacOS, ensuring seamless experience for all users.

---

Frame Master v3.1.0 — What’s New

Release Date: December 14, 2025

---

🔍 CLI Search Commands

Search plugins and templates directly from your terminal:

frame-master search plugins react --category ssr
frame-master search templates "full stack" --json

Supports advanced query syntax: tag:auth, author:name, -deprecated, "exact phrase"

---

🔗 Plugin Chaining Control

Stop the chain when needed:

return { contents, loader: "tsx", preventChaining: true };

---

🏁 Plugin Builder finally()

Post-process files after all handlers complete:

build.finally("html", ({ contents, path }) => ({
  contents: `<!-- ${path} -->\n${contents}`,
}));

Works even without matching onLoad handlers.

---

📦 Global Build Entrypoints

pluginsOptions: {
  entrypoints: ["./src/global.ts", "./src/analytics.ts"],
}

---

🏷️ Extendable Directive Types

Type-safe custom directives with module augmentation:

declare module "frame-master/plugin/utils" {
  interface CustomDirectives {
    "use-analytics": true;
  }
}

// Now type-safe!
createDirective("use-analytics", /regex/);

---

⬆️ Upgrade

bun update frame-master

No breaking changes. Drop-in replacement for v3.0.x.

Bug fixes

• html_rewrite and globalValueInjection are now only applied to content-type: “text/html”.
• CLI plugin create will correctly format the README.md name.
• directives in plugin config now work properly.
• Plugin onLoad chaining with no namespace intercept all namespaces.

What’s New

⛓️ Plugin Chaining

Multiple plugins can now transform the same file in sequence. Build and Runtime composable transformation pipelines without conflicts.

Original File ──► Plugin A ──► Plugin B ──► Final Output

🔥 Hot Config Reload

Edit your frame-master.config.ts and watch changes apply instantly—no restart needed.

🛠️ New Plugin Tools

• HotFileWatcher — Watch any file for changes in your plugins
• onConfigReload hook — React to config updates
• Helper utilities: isVerbose(), isDev(), isProd(), isBuildMode()

📦 New Exports

import { chainPlugins, getChainableContent } from "frame-master/plugin";
import { HotFileWatcher } from "frame-master/server/hot-file-watcher";
import { reloadServer } from "frame-master/server";

v2.1.0 templates won’t work anymore update to v2.1.1

CLI Updates

Template Registry

• Updated API endpoint to frame-master.com for template queries.

Security

WebToken Package

• Fixed critical vulnerability: Removed static IV requirement from AES-256-CBC encryption.
• Encryption now generates a cryptographically secure random IV for each operation.
• This prevents pattern analysis attacks that were possible with static IV reuse.

Package

• Removed test-project directory from the npm package to reduce package size.

Enhancement

CLI

• Added global verbose flag (-v, --verbose) for detailed logging.
• Install templates from the CLI with frame-master create command.

Build

• build command will display more information when the build crashes.

Features

• Plugin CLI extensions: plugin can add CLI command via frame-master extended-cli <plugin-command>.

• Build Env: process.env.BUILD_MODE when runing frame-master build.

Bug Fixes

• prevent log functionality was not triggered properly because of sync/async calling order.
• response Header was not merging correctly.

Other

• new Frame-Master logo

This patch release addresses critical CLI stability issues and enhances the build pipeline with improved error handling and automated cleanup capabilities. This update ensures better reliability for developers using Frame Master’s command-line interface.

Bug Fixes

• CLI Stability: CLI command create and init parse tsconfig correctly and no longer crash.

Improvements

• cleanup build directory after build, removing last build leftover.
• build error handling.

Note

• this version is a batch of version with 2.0.3 and 2.0.2.
• builder initialization order changed.

Version 2.0.1 brings significant improvements to the developer experience with enhanced CLI interface, better server initialization, and optimized plugin configuration.

Features

• Enhanced CLI Interface: colorful CLI, clear env message ( dev or prod ). Formated error messages.

• Build lifecycle API: isBuilding and async awaitBuildFinish

Bug Fixes

• Fix regression where running frame-master plugin validate was crashing.

This release focuses on enhancing the developer experience with architectural improvements that eliminate circular dependency issues, new Builder API methods for debugging and analysis, CLI enhancements, comprehensive testing, and documentation refinements.

Features

• New Builder API.
• Config access API

Bug fixes

• Config access circular dependency (null before initialization).
• Test suite for preventing known regression.

Build Lifecycle & Enhanced Plugin API

Introducing comprehensive build lifecycle hooks, enhanced plugin documentation, and improved WebSocket support. Plugin developers can now customize the build process at every stage.

KEY HIGHLIGHTS

• Build lifecycle hooks (buildConfig, beforeBuild, afterBuild)
• Enhanced plugin type definitions with comprehensive JSDoc
• WebSocket support in plugin API
• Improved server configuration options
• Better developer experience with detailed documentation

The first stable release of Frame-Master! A revolutionary framework-agnostic, plugin-driven architecture powered by Bun.js. Build your perfect full-stack framework, one plugin at a time.

KEY HIGHLIGHTS

• Plugin-driven architecture
• Framework-agnostic design
• Hot module replacement in dev mode
• File system watching and auto-reload
• HTML rewriting capabilities
• Request/Response lifecycle hooks