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.
16 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 or Go, bundle, run, format, and query the toolchain.
See commands → LibrariesModules and packagesEvery public declaration in the 97 standard modules and the ziranlang packages, generated from the 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.
Guide
The full guide.
The repository’s usage and compiler documents, rendered on every site build.
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.