Get started with VexaScript

Install the vexascript package globally. The vexa binary becomes available.

npm install -g vexascript
vexa --version

Alternatively, run it without installing via npx:

npx vexascript run hello.vx

Create a hello.vx file. VexaScript is derived from TypeScript and keeps its ecosystem, with deliberate .vx syntax differences; .ts and .tsx inputs retain TypeScript semantics.

class Greeter(val name: string) {
  fun greet() => `Hello, ${name}!`
}

val g = Greeter("world")
console.log(g.greet())

Run it directly or compile to JavaScript:

vexa run hello.vx
vexa build hello.vx -o dist/hello.js

You can also compile either .vx or .ts entrypoints through the native C++ command group:

vexa cpp hello.vx
vexa cpp link hello.vx -o dist/hello
vexa cpp run cli/cli.ts -o dist/vexa-native

The official extension gives you diagnostics, quick fixes, go-to-definition, hover docs, and completions as you type.

Once installed, open any .vx file and the language server starts automatically. Use the syntax reference or the CLI guide to explore further.

Test files use the .test.vx suffix. The test and assert helpers are available without any import.

test("arithmetic") {
  assert(1 + 1 == 2)
  assert(2 * 3 == 6)
}

Run all tests under the current directory, or pass specific paths:

vexa test
vexa test src/math.test.vx

The website bundle ships embeddable Monaco-powered editors. Drop a live, editable VexaScript snippet into any docs page or product demo.

Explore the full language, project configuration, all CLI commands, and the embedding API.