Skip to content
devhxjPublic

Repository files navigation

Today's Verse

Jazor

Build Vue applications in C# with Jolt and compile C# modules to ECMAScript with Jazor.

.NET 11 NuGet GitHub release MIT License

At least 10,000 compiler tests pass At least 98 percent compiler line coverage At least 97 percent compiler branch coverage

Get started with Jolt · Counter example · Documentation · Changelog

English · 简体中文

Run a Jolt app

Install the .NET 11 SDK on Windows or glibc Linux (x64 or ARM64). Clone the repository and run these commands from its root.

dotnet tool install --global Jazor.Jolt --version 2.2.0
jolt dev samples/Jolt.Counter

If the tool is already installed, use dotnet tool update --global Jazor.Jolt --version 2.2.0. Open the URL printed in the terminal and click Increment. A typed callback updates the parent’s count and the state of a Reka UI component. Counter project

A .jazor file combines markup and C#.

<button @onclick="@Increment">Count: @Count</button>

@code {
    private int Count;
    private void Increment() => Count++;
}

Each .jazor file becomes one ES module. The Vue component is the default export. Public static methods and fields and public constants become named exports. Instance state belongs to each mounted component. Jolt checks npm components against their public TypeScript declarations and imports their published ESM exports. Component authoring

Edit and build

Editor Extension
VS Code Install jolt-2.2.0.vsix with Extensions: Install from VSIX. VS Code setup
Visual Studio 2026 on Windows x64 Open Jolt.VisualStudio.vsix with the VSIX Installer. Visual Studio setup

Get the CLI and your editor’s VSIX from the same release. Open samples/Jolt.Counter as a folder, then open App.jazor to try semantic highlighting, typed completion and go to definition. 2.2.0 release

jolt build samples/Jolt.Counter writes modules and source maps to samples/Jolt.Counter/.jolt/. jolt bundle samples/Jolt.Counter writes production assets to samples/Jolt.Counter/dist/.

Compile C# modules

Add the Jazor SDK to a .NET project to compile [ECMAScriptModule] classes. The SDK includes the compiler, analyzer, Emit tooling and ASP.NET Core integration. C# module quickstart

dotnet add package Jazor --version 2.2.0
Topic Documentation
SDK configuration, output modes and ASP.NET Core SSR Installation and configuration
Reusing C# libraries and NuGet packages Managed library imports
Compiler and artifact pipeline System architecture
Supported features and test requirements Current status

Develop Jazor

Run from the repository root with the .NET SDK selected by global.json.

dotnet build Jazor.slnx
dotnet run --file scripts/csharp/test-dotnet.cs -- --project jolt
dotnet run --file scripts/csharp/test-dotnet.cs

The Jolt release workflow verifies an isolated CLI install, the language server and browser interaction, and builds both VSIX packages. Development and testing

Latest release

Jazor 2.2.0 ships Jolt, both editor extensions and the Jolt authoring guides. Release notes

AI-assisted development

The initial implementations of Jazor's core compiler and CLR support, together with the first 500 tests, were written by hand over nearly two years. This work established the project's technical foundation.

AI assistance has primarily helped advance documentation, test coverage, external library bindings, iterative improvements, CI, and version management. The Zhipu GLM-5 and GPT-5 series have been the main AI collaborators in this subsequent work; maintainers continue to guide the project, review changes, and make release decisions.

Acknowledgements

Jazor builds on Roslyn, Acornima, node-api-dotnet, pnpm, Vite, and WebRef. Earlier work also benefited from Netpack, DenoHost, and C#-to-JavaScript projects including WootzJs, h5, and SharpKit.

License and Feedback

Jazor is licensed under the MIT License. Report security issues privately through GitHub Security Advisories; use issues and discussions for other feedback.

Releases

Packages

Contributors

Languages