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.
01 Build from source
02 Write hello.zi
03 Run and see Hello, World!
Explore
Choose what you need.
Sixteen complete programs with commands, each printing the same output on every target.
Browse examples → LanguageSyntax referenceModules, declarations, types, generics, control flow, compile-time forms, laws, and foreign calls.
Read the reference → ToolchainCLI referenceCheck, build C, C++, Go, Rust, or Python, bundle, run, format, and query the toolchain.
See commands → LibrariesStandard libraryEvery public declaration in the 39 standard modules, generated from the checked source.
Browse modules → ProjectImplementation statusSee what works in the tested subset and what still needs implementation.
Check support → ProjectsPackagesziran.toml projects, pinned Git dependencies, locks, and installing applications.
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 ↗. The repository guide ↗ covers imports, exports, foreign calls, and building from source in more depth.