gsx — VS Code Extension
VS Code language support for gsx — JSX-style HTML templating for Go.
What it is
gsx is a Go templating language that uses JSX-style syntax: components are
capitalized tags, holes are { expr } blocks, and files embed Go, CSS, and
JavaScript inline. This extension provides syntax highlighting and a full
language client backed by gsx lsp.
Requirements
The extension requires the gsx binary for diagnostics, hover,
go-to-definition, references, and formatting. Install it with:
go install github.com/gsxhq/gsx/cmd/gsx@latest
Alternatively, when you open a .gsx file without gsx on your PATH the
extension shows a one-click "Install gsx" prompt that runs the command for
you.
Features
- Syntax highlighting — tags, components, holes (
{ expr }), embedded Go
blocks, and embedded <style>/<script> with proper scope nesting
- Diagnostics — parse and type errors shown inline, powered by
gsx lsp
- Hover — Go identifier documentation on hover
- Go-to-definition — navigate to symbol definitions across the workspace
- Find references — list all references to a symbol
- Formatting — format-on-save via
gsx lsp / gsx fmt
Settings
| Setting |
Default |
Description |
gsx.server.path |
"" |
Absolute path to the gsx binary. Empty = auto-discover via PATH, GOBIN, GOPATH/bin. |
gsx.trace.server |
"off" |
Trace LSP communication (off / messages / verbose). |
Commands
| Command |
Description |
gsx: Install/Update Language Server |
Run go install to (re)install the gsx binary. |
gsx: Restart Language Server |
Restart the gsx lsp process without reloading the window. |
How it works
When a .gsx file is opened the extension resolves the gsx binary (setting
PATH > GOBIN > GOPATH/bin) and launches gsx lsp as a stdio LSP
server. All diagnostics, hover, go-to-definition, references, and formatting
responses come from that process. Syntax highlighting works independently of
the binary via the bundled TextMate grammar.
Links
