# Astra Kairo

## Docs

- [Astra First-Party Packages for Kairo: Full Reference](https://docs.astrakairo.dev/ecosystem/astra-packages.md): Explore all Astra first-party packages for Kairo: JSON, HTTP, file system, database, cryptography, and more — declared on demand.
- [Kairo Standard Library: Core, Pulse Runtime, and Astra](https://docs.astrakairo.dev/ecosystem/standard-library.md): Explore the three-layer Kairo standard library: Core prelude types, Pulse runtime modules, and optional Astra first-party packages.
- [Set Up the Kairo Toolchain: Install Forge and Pulse](https://docs.astrakairo.dev/installation.md): Install Forge and Pulse to start building and running Kairo applications. Covers early access options and building the toolchain from source.
- [Kairo: A Modern Language Built for Business Software](https://docs.astrakairo.dev/introduction.md): Learn what Kairo is, why it was designed, and what makes it different — a language built around clarity, predictability, and business-domain-first design.
- [Kairo Control Flow: Branching, Matching, and Bindings](https://docs.astrakairo.dev/language/control-flow.md): Use if/else and match for branching in Kairo, and learn how let and var bindings make control flow explicit, predictable, and easy to reason about.
- [Error Handling in Kairo: Result and Faults Explained](https://docs.astrakairo.dev/language/error-handling.md): Handle expected business failures with Result<T, E> and understand how faults differ from ordinary errors in Kairo — no try/catch syntax in v0.1.
- [Kairo Functions: Free Functions, Methods, and Async](https://docs.astrakairo.dev/language/functions.md): Define free functions, instance methods, type functions, and async callables in Kairo with explicit signatures and predictable calling conventions.
- [Kairo Language Syntax: Modules, Imports, and Structure](https://docs.astrakairo.dev/language/syntax.md): Learn Kairo syntax: declare modules, write imports, control visibility, and structure source files for readable, maintainable codebases.
- [Kairo Type System: Scalars, Collections, and Domain Types](https://docs.astrakairo.dev/language/types.md): Understand Kairo's type system: scalars, collections, nullability, and the value vs. object distinction that shapes business domain modeling.
- [Declaring and Locking Dependencies in Kairo Projects](https://docs.astrakairo.dev/packages/dependencies.md): Declare, restore, and lock dependencies in Kairo using the kairo.toml manifest and forge.lock for reproducible, deterministic builds on every machine.
- [kairo.toml: Complete Kairo Package Manifest Reference](https://docs.astrakairo.dev/packages/manifest.md): Learn how to configure your Kairo package using kairo.toml, including package metadata, application entry points, and runtime configuration.
- [Kairo Packages: Structure, Layout, and Package Kinds](https://docs.astrakairo.dev/packages/overview.md): Understand how Kairo packages work: project layout, the kairo.toml manifest, and the difference between application and library packages.
- [Quickstart: Write and Run Your First Kairo Application](https://docs.astrakairo.dev/quickstart.md): Create a Kairo project from scratch, write your first program, build it with Forge, and run it with the Pulse runtime in just a few steps.
- [Kairo Type Declarations: value, object, contract, enum](https://docs.astrakairo.dev/reference/declarations.md): Reference for all Kairo type declarations: value, object, contract, and enum, including visibility modifiers, conformance syntax, and construction forms.
- [Forge CLI Command Reference](https://docs.astrakairo.dev/reference/forge-cli.md): Complete reference for all Forge CLI commands: restore, check, build, test, package, publish, and clean with flags and diagnostic codes.
- [Kairo Functions, Methods, and Async Reference](https://docs.astrakairo.dev/reference/functions.md): Complete reference for func, type func, init, async func, and await in Kairo v0.1, including parameter syntax, local bindings, and the return statement.
- [Kairo Module and Import Declarations Reference](https://docs.astrakairo.dev/reference/modules.md): Complete reference for the module and import declarations in Kairo v0.1, covering module naming rules, import aliases, and explicit type imports.
- [Kairo Operators and Control Expressions Reference](https://docs.astrakairo.dev/reference/operators.md): Reference for all Kairo v0.1 operators: boolean, comparison, and arithmetic operators, with precedence rules, match expressions, and member access.
- [Pulse.Console Runtime Service Reference](https://docs.astrakairo.dev/reference/pulse-console.md): Reference for the Pulse.Console runtime service: writing to stdout and stderr from Kairo applications using out and error streams.
- [Pulse Runtime Reference: pulse validate and pulse run](https://docs.astrakairo.dev/reference/pulse-runtime.md): Reference for the Pulse runtime commands, entrypoint signatures, exit codes, and diagnostic codes for running Kairo applications.
- [Kairo Built-in Types and Collections Reference](https://docs.astrakairo.dev/reference/types.md): Reference for all built-in Kairo types: scalar types, temporal types, collection types, the Result<T,E> outcome type, and nullable T? with usage notes.
- [Forge: Kairo's Build, Package, and Publish Toolchain](https://docs.astrakairo.dev/toolchain/forge.md): Use Forge to check, build, test, package, and publish your Kairo projects with a predictable, manifest-driven, reproducible pipeline.
- [Pulse: Running and Validating Compiled Kairo Applications](https://docs.astrakairo.dev/toolchain/pulse.md): Use the Pulse runtime to validate and run compiled Kairo applications, and understand entrypoint signatures, exit codes, and startup validation.
- [Studio: The Official Kairo Development Environment](https://docs.astrakairo.dev/toolchain/studio.md): Studio is the official IDE for Kairo, providing editing, diagnostics, refactoring, and Forge workflow integration in one environment.