03 - Installation

Verge is not yet available to install.

Verge is in alpha. The compiler works, the examples in these docs compile and run, but it isn’t packaged, published, or ready for general use. There’s no download page, no release binary, and no install command yet — providing one now would set expectations the project can’t currently meet.

Why there’s nothing to download

Two things are still in motion, and both of them change what “install Verge” will eventually mean:

  • Verge is becoming self-hosted. The compiler is being rewritten in Verge itself. Until that settles, the toolchain is a moving target, and any build instructions written today would be obsolete tomorrow.
  • The end state is a single executable. When Verge is ready for general use, installation should be straightforward: download one self-contained binary and put it on your PATH — no Rust toolchain, no building from source, no separate standard-library setup. Documenting today’s from-source process would only teach a workflow that’s meant to disappear.

So rather than give install steps with a short shelf life, this page is a placeholder that will be replaced with real instructions once the toolchain is ready to distribute.

What installation will look like

When Verge reaches a usable release, expect roughly this:

  • Download a single verge executable for your platform.
  • Put it somewhere on your PATH.
  • Run verge --version to confirm it works, then verge run hello.v.

The goal is a straightforward, single-binary experience with no additional setup.

In the meantime

If you’d like to learn the language, the rest of these docs stand on their own without installing anything — every example is compiled and run before it’s published, so you can read along and trust that the code behaves as shown. Start with Hello World and continue from there. The blog covers the design decisions as the project moves toward its first release.