Tebex Render (VS Code Extension)

Run a local Twig renderer for Tebex themes with hot reload from inside VS Code. Select your theme folder, start the server, and develop with clean, minimal logs.

Features

• Start/stop/restart the local renderer server from the Command Palette
• Pick any theme folder on disk; remembered for future runs
• Hot reload when theme files change (no manual restart needed)
• Toggle debug logging on/off

Commands

• Tebex Render: Start Server
• Tebex Render: Stop Server
• Tebex Render: Restart Server
• Tebex Render: Turn Debugging On/Off

Settings

• tebexRender.port (number, default: 3002)

Usage

1. Launch VS Code and open the folder containing the extension files.
2. Run Tebex Render: Start Server.
3. When prompted, select the folder where your Tebex theme lives (the theme root).
4. Visit http://localhost:3002/ in your browser.
5. Edit theme files; the server hot-reloads automatically.
6. Use Tebex Render: Turn Debugging On/Off to switch verbose logs.

How It Works

• The extension starts the bundled server (server.js) with environment variables:
  • PORT: listening port (from settings)
  • TEBEX_RENDER_THEME_ROOT: absolute path to your selected theme folder
  • TEBEX_RENDER_DEBUG: 1 to enable debug logs, 0 to disable
• A file watcher monitors your selected theme folder and calls /__reload for template/schema refresh.

Development

• Extension entry: extension.js
• Server entry: server.js
• Install deps: npm install
• Run Extension Development Host: press F5 in VS Code

Packaging & Publishing

• Update the publisher field in package.json.
• Set VSCE_PAT in your shell with a Marketplace token (Marketplace: Manage scope).
• Package: npm run vscode:package
• Publish: npm run vscode:publish

Notes

• Only the minimal files are shipped in the VSIX (extension.js, server.js, README.md).
• Themes are not bundled; you select your theme folder at runtime.