// download
Installers are
coming. Not yet.
The installers exist — they are built and smoke-tested on every
platform as part of the normal release machinery. What does not exist is a
version worth asking you to install. Zanna is pre-alpha; interfaces change
without notice and corners are still rough. When there is a build you should
actually run, this page is where it will be.
Source tree v0.2.99 · IL 0.3.0 · most recent tag v0.2.7-dev
// building it yourself
The supported way in, today
Building from source is not a fallback here — it is how everyone
working on Zanna uses it. There is no dependency-fetch step, because there
are no dependencies: you need CMake and a C++20 compiler, and that is the
whole list.
$ git clone https://github.com/zannagames/zanna
$ cd zanna
# macOS
$ ./scripts/build_zanna_mac.sh
# Linux
$ ./scripts/build_zanna_linux.sh
# Windows (PowerShell)
$ ./scripts/build_zanna_win.ps1
The scripts configure, build, run the test suite and install. When they
finish you have a working zanna:
$ zanna init my-game
$ zanna run my-game
Want the games too?
The showcase games live in a separate repository so the compiler
checkout stays small. Clone it beside your zanna checkout and
the full demo suite runs against it; leave it out and those tests report
as skipped rather than quietly disappearing.
$ git clone https://github.com/zannagames/zannademos
Building in a hurry
Zanna Studio is a multi-minute native compile on its own. If you are not
working on the IDE, skip it:
$ ZANNA_SKIP_STUDIO=1 ./scripts/build_zanna_unix.sh
// plainly
What pre-alpha actually means here
It builds and it runs. The test suite is large and green,
the VM and the native backends are required to agree on every defined
program, and the demos on the games page are real
programs you can compile and play today.
It is not stable. Runtime interfaces gain methods and
occasionally change shape between commits. There is no compatibility
promise, no migration guide, and no long-term support for anything yet.
Names have already changed once wholesale — the project was called
Viper until this release.
The parts move at different speeds. The IL and the
compiler core are the most settled. The 3D runtime and Zanna Studio are
the newest and change the most. The 2D runtime sits in between.
Nobody should be shipping on it. If you build it, build
it to look around, to read the source, or to help. Not to start a project
you need to finish next quarter.
Development happens in the open, daily, in the repository. That is the
most useful thing to watch until there is something here to click.