Documentation

Learn and build with Ziran.

Start with a complete program, then use the language and API references as you build. Ziran is experimental, so check target support before relying on a feature.

New to Ziran

Your first program

Build the toolchain, write a .zi module, check it, and run a portable bundle. The guide includes every command and the expected result.

Get started →

THREE STEPS

01 Build from source

02 Write hello.zi

03 Run and get 42

Explore

Choose what you need.

Learn by doingExamples

Complete source and commands for records, standard modules, and native output.

Browse examples → LanguageSyntax reference

Modules, declarations, types, control flow, compile-time forms, and foreign calls.

Read the reference → ToolchainCLI reference

Check, inspect, build, bundle, run, and format from the command line.

See commands → LibrariesStandard modules

Look up text, UTF-8, generic values, JSON scanning, and host contracts.

Browse APIs → ProjectImplementation status

See what works in the tested subset and what still needs implementation.

Check support → SourceRepository guide

More detail on imports, exports, foreign calls, and building from source.

Read on GitHub ↗

Using a specific target? Features supported by the checker are not all available in every backend. Review the status summary and the detailed implementation status ↗.