Language intelligence for Aurelia 2 — rich IDE features, ahead-of-time compilation, and server-side rendering.
Install from the VS Code Marketplace:
ext install AureliaEffect.aurelia-2
The extension analyzes your Aurelia project and provides:
- Hover — component interfaces, binding modes, types, contextual variables, provenance
- Diagnostics — unknown elements, missing bindables, binding mismatches — with confidence-based severity so you don't get false positives on valid code
- Completions — elements, attributes, binding commands, expressions, value converters, binding behaviors — scoped to what's actually registered
- Go to Definition — jump from template to source for any Aurelia construct
- Find References — locate all usages of a component or bindable across templates
- Rename — cross-file rename with safety checks (won't apply partial changes)
- Semantic Tokens — coloring that distinguishes custom elements from HTML, bindables from plain attributes
- Resource Explorer — browse all resources in your project from the sidebar
See the extension README for the full feature list and screenshots.
The project is built around a semantic workspace that analyzes your Aurelia project — scanning source files, third-party packages, builtins, and configuration — and builds a unified model of every resource, its bindables, its registration scope, and where each piece of knowledge came from.
The language server and the AOT compiler both consume this model. IDE features get their answers from the same analysis that drives compilation, which means hover, diagnostics, and completions all agree with each other and with the build output.
When the analysis hits a limit — a dynamic registration pattern, a third-party package the analyzer can't fully trace — it records what it couldn't determine and why. Diagnostics demote to warnings, hover cards show confidence indicators, completions flag gaps. The goal is that you can trust what the tooling tells you.
| Package | What it does |
|---|---|
@aurelia-ls/compiler |
Template compiler and project analysis pipeline |
@aurelia-ls/semantic-workspace |
Semantic model, incremental invalidation, and feature query surface |
@aurelia-ls/language-server |
LSP adapter — translates workspace queries into LSP responses |
@aurelia-ls/transform |
Build-time AOT transform (injects compiled templates into source) |
@aurelia-ls/vite-plugin |
Vite integration for dev server and production builds |
@aurelia-ls/ssr |
Server-side rendering |
@aurelia-ls/ssg |
Static site generation |
@aurelia-ls/integration-harness |
End-to-end test harness |
aurelia-2 |
VS Code extension |
git clone --recurse-submodules https://github.com/aurelia/aurelia-ls.git
cd aurelia-ls
# Build the Aurelia framework (submodule)
cd aurelia
npm ci
npm run build
cd ..
# Build aurelia-ls
pnpm install
pnpm run buildThe submodule is a temporary setup while we work towards full bi-directional compatibility with the Aurelia framework.
- Getting Started — setup and installation
- Architecture — how the compiler pipeline works
This is pre-release software under active development. See CHANGELOG for updates.
MIT