https://github.com/ptbarnum4/meteor-blaze-vscode-language-server

VS Code extension that adds support for Meteor/Blaze HTML Language Server
https://github.com/ptbarnum4/meteor-blaze-vscode-language-server

blaze meteorjs

Last synced: 5 months ago
JSON representation

VS Code extension that adds support for Meteor/Blaze HTML Language Server

Host: GitHub
URL: https://github.com/ptbarnum4/meteor-blaze-vscode-language-server
Owner: ptbarnum4
License: mit
Created: 2025-08-10T07:37:57.000Z (10 months ago)
Default Branch: main
Last Pushed: 2026-01-23T08:52:01.000Z (5 months ago)
Last Synced: 2026-01-24T01:31:51.453Z (5 months ago)
Topics: blaze, meteorjs
Language: TypeScript
Homepage: https://marketplace.visualstudio.com/items?itemName=ptbarnum4.meteor-blaze-vscode-language-server&ssr=false#overview
Size: 3.43 MB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 4
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

          # Meteor/Blaze HTML Language Server

[![CI](https://github.com/ptbarnum4/meteor-blaze-vscode-language-server/actions/workflows/ci.yml/badge.svg)](https://github.com/ptbarnum4/meteor-blaze-vscode-language-server/actions/workflows/ci.yml)

> **⚠️ Early Release Notice**: This is a new extension under active development. While functional, it may contain bugs or incomplete features. Please [report any issues](https://github.com/ptbarnum4/meteor-blaze-vscode-language-server/issues) you encounter to help improve the extension. Contributions and feedback are greatly appreciated!

A VS Code extension that provides intelligent language support for Meteor/Blaze templates within HTML files. Automatically detects Meteor templates and provides syntax highlighting, code completion, hover information, go-to-definition, and cross-file analysis.

## ✨ Key Features

- **🎯 Smart Template Detection** - Automatically activates for HTML files containing `` tags

- **🎨 Syntax Highlighting** - Full Blaze templating syntax support (`{{helper}}`, `{{#if}}`, etc.)

- **💡 Intelligent Code Completion** - Template helpers, CSS classes, built-in Blaze helpers, and template inclusions

- **📐 Template Parameter Completion** - Smart suggestions for template parameters and values during template invocations

- **🎨 Auto-Formatting** - Automatically formats multi-line template invocations with proper indentation

- **✨ Auto-Insert End Tags** - Automatically completes Blaze block tags (`{{#if}}` → `{{/if}}`)

- **🔍 Cross-file Intelligence** - Analyzes neighboring TypeScript/JavaScript and CSS files for completions

- **📋 Rich Hover Information** - Shows helper definitions, file locations, and documentation

- **🎯 Go-to-Definition** - Navigate from helper usage to definition

- **🚨 Block Validation** - Detects missing or mismatched Blaze block end tags

## 🚀 Quick Start

### Installation

1. **From VS Code Marketplace**: Search for "Meteor/Blaze HTML Language Server" in VS Code Extensions

2. **Manual Installation**: Download the [latest .vsix file](https://github.com/ptbarnum4/meteor-blaze-vscode-language-server/releases) and install via "Extensions: Install from VSIX..."

### Usage

1. **Open an HTML file** containing Meteor templates:

   ```html

   

     
{{helper}}

   

   ```

2. **Add template helpers** in the same directory:

   ```javascript

   Template.myTemplate.helpers({

     helper: () => 'Hello, Meteor!'

   });

   ```

3. **Start coding!** Enjoy syntax highlighting, auto-completion, and intelligent features.

## ⚙️ Configuration

> [!NOTE]

> Extensions cannot set the `editor.semanticTokenColorCustomizations` setting programmatically due to VS Code limitations. Users must manually add these configuration to their settings.json to enable preferred semantic token color customizations. We encourage you to include the following for the best experience:

Basic configuration in VS Code settings:

```json

{

  // Basic language server settings

  "meteorLanguageServer.maxNumberOfProblems": 100,

  "meteorLanguageServer.trace.server": "off",

  // Block condition decoration overrides - distinctly different from defaults

  "editor.semanticTokenColorCustomizations": {

    "rules": {

      "blazeBlockHash": { "foreground": "#808080", "fontStyle": "bold" },

      "blazeBlockName": { "foreground": "#f177ff", "fontStyle": "italic bold" },

      "blazeBlockArgs": { "foreground": "#fffec4", "fontStyle": "bold" },

      "blazeBlockFirstArg": { "foreground": "#ffd16f", "fontStyle": "bold" },

      "blazeBlockSingleArg": { "foreground": "#ffd16f", "fontStyle": "bold" },

      "blazeExpression": { "foreground": "#ffd16f" },

      "blazeBlockIn": { "foreground": "#00ffa2", "fontStyle": "italic bold" },

      "delimiter": { "foreground": "#808080", "fontStyle": "bold" }

    }

  },

  "meteorLanguageServer.blockConditions": {

    "extend": [

      {

        "type": "mrkdwn",

        "label": "Custom Markdown Block",

        "propNames": ["text", "markdown", "content"],

        "requiresEndTag": true,

        "autoInsertEndTag": true

      }

    ],

    "margin": "0 0 0 0.75em",

    "fontStyle": "italic",

    "color": "#727272"

  },

  "meteorLanguageServer.blazeHelpers": {

    "extend": [

      {

        "name": "#mrkdwn",

        "doc": "Custom markdown block"

      }

    ]

  },

  // New: Rich global helper configuration with parameters and examples

  "meteorLanguageServer.globalHelpers": {

    "extend": [

      {

        "name": "formatDate",

        "doc": "Format dates with custom patterns",

        "params": [

          {

            "name": "date",

            "type": ["string", "Date"],

            "doc": "Date to format"

          }

        ],

        "return": { "type": "string" },

        "examples": [{ "html": "{{ formatDate createdAt }}" }]

      }

    ]

  }

}

```

### Configuration Visuals

![Blaze Block Example 1](./docs/img/semanticTokenColorCustomizations_1.png)

### Example Configuration Files

For more configuration examples, see the example files in the [docs directory](./docs/):

- **[example-settings.jsonc](./docs/example-settings.jsonc)** - Basic configuration

- **[example-settings-auto-insert.jsonc](./docs/example-settings-auto-insert.jsonc)** - Auto-insert end tags

- **[example-settings-blazeHelpers-colors.jsonc](./docs/example-settings-blazeHelpers-colors.jsonc)** - Custom helper colors

- **[example-blaze-token-theme.jsonc](./docs/example-blaze-token-theme.jsonc)** - TextMate token customization

📖 **For complete configuration options and advanced features, see [docs/SETUP.md](./docs/SETUP.md)**

## 📚 Documentation

- **[📖 Complete Documentation](./docs/README.md)** - All documentation in one place

- **[⚙️ Configuration Guide](./docs/SETUP.md)** - Detailed configuration options

- **[🛠️ Development Guide](./docs/development/DEVELOPMENT.md)** - Contributing and development setup

- **[✨ Feature Documentation](./docs/FEATURES.md)** - Detailed feature explanations

- **[📝 Changelog](./docs/CHANGELOG.md)** - Version history

## 🆘 Need Help?

- **[🐛 Report Issues](https://github.com/ptbarnum4/meteor-blaze-vscode-language-server/issues)** - Bug reports and feature requests

- **[🔧 Troubleshooting](./docs/SETUP.md#troubleshooting)** - Common issues and solutions

- **[� Development](./docs/development/DEVELOPMENT.md)** - Contributing to the project

## 📄 License

MIT License - see [LICENSE](./LICENSE) file for details.

---

**Made with ❤️ for the Meteor.js community**

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/ptbarnum4/meteor-blaze-vscode-language-server

Awesome Lists containing this project

README