Skip to main content

VS Code Extension

Pulse projects are TypeScript-first — VS Code's built-in TypeScript language service handles .ts files automatically (IntelliSense, type checking, go-to-definition). No extra extension is needed for TypeScript components.

The rb ext install command installs a supplemental syntax extension for legacy .rblua files — the older Pulse component format still used in some projects.

TypeScript setup (primary)​

After rb init creates your project, open the project folder in VS Code. The tsconfig.json and @rb-pulse/core types configure IntelliSense automatically. You'll get:

  • Full type checking and autocompletion for signal, defineComponent, on.*, toggle, slider, etc.
  • Go-to-definition on Pulse globals
  • Error highlighting for missing signals or wrong widget types

No extra extensions needed — just VS Code with the default TypeScript support.

Legacy .rblua extension​

If you have older .rblua files in your project:

rb ext install

This copies the extension into ~/.vscode/extensions/rblua-syntax/. VS Code picks it up automatically — no restart needed in most cases. If highlighting doesn't appear, reload the window (Ctrl+Shift+P → "Developer: Reload Window").

What it provides for .rblua files:

  • Syntax highlighting for component, signal, on, when, every, guard, func, init, ui keywords
  • Language ID rblua
  • Bracket matching and comment toggling

Add to settings.json (Ctrl+Shift+P → "Preferences: Open Settings (JSON)"):

{
  "editor.tabSize": 2,
  "editor.formatOnSave": true,
  "files.associations": {
    "*.lua": "lua"
  }
}

Updating the extension​

The extension is bundled with rb. When you run rb update, the extension files update automatically. Run rb ext install again to push the updated version into VS Code.