# Lito

Lito is a module-first build tool for C++.   
It uses `lito.toml` to define packages, workspaces, targets, dependencies, and build policy.  
It also discovers named module sources and drives Clang, LLD, and LLVM tools.  

[Documentation](https://lito.litocpp.org/) · [Packages](https://pkgs.litocpp.org/)

## Requirements

- LLVM/Clang 22+
- CMake and Ninja when bootstrapping or building a CMake dependency

## Install
To install Lito, if you are running Unix, run the following in your terminal.  
```sh
curl --proto '=https' --tlsv1.2 -sSf https://lito.litocpp.org/install.sh | sh
```

## Bootstrap

```sh
cmake --preset release
cmake --build --preset release
cmake --install build/cmake-release --prefix build/install

./build/install/bin/lito --version
```

## First project

Create this layout:

```text
hello/
├── lito.toml
└── src/
    └── main.cppm
```

`lito.toml`:

```toml
[package]
name = "hello"
version = "0.1.0"

[[bin]]
name = "hello"
module = "hello"
```

`src/main.cppm`:

```cpp
module;

#include <cstdio>

export module hello;

auto main() -> int {
    std::puts("Hello from Lito");
    return 0;
}
```

Build and run:

```sh
lito build
./build/debug/bin/hello/hello
```

Because the target omits `sources`, Lito uses the runnable entry convention at `src/main.cppm` and
discovers its module dependencies. Use explicit `sources` for targets that do not follow the module
convention.

See the [manifest schema](schema/lito.schema.json) for the machine-readable structure and the
[documentation](https://lito.litocpp.org/) for package, workspace, configuration, and CLI details.

## License

[MIT](LICENSE-MIT) OR [Apache-2.0](LICENSE-APACHE)