Getting started

Install the toolchain first (Install: winget, Release zip, or install.ps1 / install.sh). Then create a CLI, open src/main.bq, run it.

buraaq new hello --cli
cd hello
buraaq run

Command	What you get
`buraaq new NAME --cli`	Hello-world CLI (start here)
`buraaq run`	Native binary
`buraaq` / `-e` / `script`	Optional clang shell (scripting)

The program

fn main() {
    println("Hello, Buraaq!")
}

Extension is .bq
There is no let: bindings look like assignment
print / println know the type
Unique stdlib names import themselves: no use for println. Short form is use io, not use std.io.
buraaq run builds and executes a native binary

hello/
  buraaq.pkg
  src/main.bq
  tests/smoke.bq
  target/

buraaq.pkg is the only config file you need. Path under src/ is the module name. Details: modules.

buraaq run
buraaq build --release
buraaq build --release-fast

--release-fast is -O3 plus thin LTO. Use it when you care about the last percent on a hot loop.

Next: the language in one page, then we grow a banking CLI from one println to a packed service.