Explore Lesma

Lesma is a compiled, statically typed, imperative, object-oriented language that targets LLVM. Install the toolchain, read the language tutorials, use the CLI and editor support, and try code in the browser playground.

Install LesmaOpen playgroundBrowse docs

Foundations

Get started

Install a release or build the compiler from source, then write and run your first program.

Installing Lesma

Use the installer script or build from source with CMake, vcpkg, and LLVM.

A tour of Lesma

Syntax, compilation model, and how Lesma relates to LLVM and the standard library.

Your first program

Create a small program and run it with the `lesma` CLI.

Editor & language server

VS Code extension, `lesma-lsp`, and UTF-8 positions in the LSP protocol.

Getting started →

Language

The Lesma language

Progressive tutorials covering types, functions, control flow, classes, traits, generics, and modules.

Literals & expressions

Numbers, strings, booleans, operators, and how expressions are typed.

Variables & assignment

Mutable bindings, patterns, and updating state.

Functions

Definitions, parameters, return types, and recursion.

Classes & OOP

Classes, constructors, methods, and `self`.

Language documentation →

Tooling

Compiler & workflow

Use `lesma run` and `lesma compile`, understand optimization flags, and find the standard library in the repository.

CLI reference

Run, compile, optimization levels, and typical command-line workflows.

Project layout

How the repo is organized: compiler, stdlib, tests, and benchmarks.

Tooling →

Guides

Practical guides

Read compiler output, debug programs, and work through a slightly larger example.

Understanding errors

How Lesma reports type and compile errors and how to narrow them down.

Debugging

Strategies for local debugging, tests, and sanitizer builds.

Guessing game tutorial

A small interactive program that ties together control flow and I/O ideas.

Guides →

Repository

Source code, issues, and releases live on GitHub. Contributions follow the usual pull request workflow.

github.com/alinalihassan/Lesma →