> For the complete documentation index, see [llms.txt](https://whitepaper.litho.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.litho.ai/readme.md).

# Lithosphere

Developer-preview toolchain for building on Lithosphere.

This repository is the source for the current GitHub release that external developers can use to start building. The public preview ships the starter CLI, the TypeScript SDK package, versioned contract artifacts, and the supporting docs needed to bootstrap projects against the Makalu network stack.

Lithosphere development in this repo remains Solidity-first. The active standalone Lithic compiler preview is maintained in [`KaJLabs/Lithic`](https://github.com/KaJLabs/Lithic). Its merged candidate can emit executable EVM-compatible bytecode for a bounded language subset, but it is not yet a production compiler or evidence of native LithoVM deployment. Native semantics and chain integration remain governed by [RFC 0002](/docs/governance/rfcs/0002-lithic-compiler-v1-semantics.md).

## What Ships In The Preview

* `create-litho-app`: CLI that scaffolds official starter projects
* `@lithosphere/sdk`: TypeScript SDK package distributed as a GitHub release tarball
* Versioned contract artifacts from `Makalu/contracts`
* Developer docs and release-consumption guidance

## Start Building

### From The Monorepo

```bash
git clone https://github.com/KaJLabs/lithosphere.git
cd lithosphere/Makalu
pnpm install --frozen-lockfile
pnpm --filter create-litho-app build
node packages/create-litho-app/dist/index.cjs my-first-dapp --template contracts
```

### From A GitHub Prerelease

Download the latest prerelease assets from GitHub Releases, then install the packaged CLI or SDK tarball locally. The release guide documents the exact asset names and verification flow:

* `docs/guides/consuming-releases.md`

## Repository Layout

* `Makalu/`: developer workspace containing the CLI, SDK, contracts, templates, API, and explorer
* `docs/`: project and release documentation
* `.github/workflows/`: CI and GitHub release automation

## Documentation

* `docs/quickstart/dev-setup.md`
* `docs/developers/overview.md`
* `docs/guides/consuming-releases.md`
* `docs/guides/contributing.md`

## Requirements

* Node.js 20.x
* pnpm 9.x

## License

MIT. See `LICENSE`.