A fork of bflat compiles C# straight to a small native program: no .NET runtime, no garbage collector, nothing to install where it runs.
You keep C#'s syntax, type checking and generics. Memory comes from arenas you free all at once, and a small library gives you strings, collections, input and output on those terms. The same source runs on Linux, macOS and Windows, on WebAssembly, and on DOS on a 386.
// Read into a stack buffer: nothing allocated per answer.
Span<char> buffer = stackalloc char[32];
Out.Write($"Q{i}: {a} + {b} = ");
int length = In.ReadLine(buffer);
// Kept until the end, so it goes into an arena.
mistakes.Add(Str.Format(keep,
$"{a} + {b} = {a + b}, not {value}"));
From the quiz the tutorial builds, step by step.
The compiler still checks everything it checks in .NET. What's missing is what a runtime would do while your program runs.
is and as.with, and the generated ToString.Where, Select and GroupBy, from a small library instead of LINQ.Parallel.For runs a loop on every core.throw ends the program. Return errors as unions.The hello-world sample, unchanged, built for each target. Each build is checked by the same test suite, which requires the same output everywhere.
$ ./build.sh Minimal $ ./run.sh Minimal Hello from zero-mode! $ wc -c bin/Minimal 39848 bin/Minimal
A native program that needs only the C library. On macOS it builds and runs in a container.
$ ./build.sh --mac Minimal $ bin/mac/Minimal Hello from zero-mode! $ wc -c bin/mac/Minimal 64728 bin/mac/Minimal
A native Mac program: bflat compiles it, the Mac's own clang links it. No container to run it.
$ ./build.sh --win Minimal $ ./run.sh --win Minimal Hello from zero-mode! $ wc -c bin/win/Minimal.exe 10752 bin/win/Minimal.exe
A console program on Windows' own C library, built from Linux or macOS. Tested under Wine.
$ ./build.sh --wasm Minimal $ ./run.sh --wasm Minimal Hello from zero-mode! $ wc -c bin/wasm/Minimal.wasm 15833 bin/wasm/Minimal.wasm
A WASI module, through NativeAOT-LLVM. Runs under wasmtime.
C:\>D:
D:\>PROGRAM
Hello from zero-mode!
D:\>DIR PROGRAM.EXE
PROGRAM EXE 16,384
D:\>
The same bitcode compiled for a 386, run by the HX DOS extender. Tested on Bochs's i386 model.
Without a runtime, a few things work differently. Each has a page that explains why and what to do instead.
There is no garbage collector, so new is never freed. Arenas hand out memory and free it all at once, one per lifetime.
Out.Line($"...") formats straight into the output buffer, and In.ReadLine reads into a span. Strings that must last go into an arena.
List, Dict, and their versions for references and string keys, all handles into an arena.
Every program compiles under the updated memory safety rules: creating a pointer is safe, reading through one is marked and explained.
The memory safety rulesIf you're new to it, these four pages take you from nothing to an interactive program.
The bflat fork and the prerequisites.
Build it, run it, see how small it is.
The same program under FreeDOS, in an emulator.
A quiz: output, input, bad input, arenas.
Looking for something specific? The task guides answer one question each, and the reference lists every type in the library.