hbs-lsp brings Handlebars language server support to VS Code for non-Ember projects such as Express, Fastify, Eleventy, and custom Node applications.

Features

syntax diagnostics
completions for common Handlebars patterns
hover information for helpers and partials
formatting
semantic tokens
document symbols and folding ranges
workspace indexing for helpers and partials

Getting started

Install the extension.
Open a workspace containing .hbs or .handlebars files.
Open a Handlebars file to start the language server.

The extension bundles the language server, so no separate global npm install is required.

Commands

The extension contributes these commands:

hbs-lsp: Show Index
hbs-lsp: Reindex Workspace
hbs-lsp: Show Output
hbs-lsp: Restart Server

Configuration

Settings are available under the handlebars.* namespace in VS Code settings.

Common settings include:

handlebars.indentSize
handlebars.enableDiagnostics
handlebars.enableFormatting
handlebars.indexWorkspaceSymbols
handlebars.helpers
handlebars.partials
handlebars.partialRoots

Notes

Workspace indexing runs on startup and when you manually reindex.
The server is bundled inside the extension package.

Troubleshooting

If the extension is not behaving as expected:

run hbs-lsp: Show Output to inspect server logs and request errors
run hbs-lsp: Restart Server after changing settings or if the server seems stuck
run hbs-lsp: Reindex Workspace if helpers or partials are missing
make sure your files use the .hbs or .handlebars extension

See CHANGELOG.md for release history.