Skip to content

lde-org/lde

Repository files navigation

lde is a modern package manager and toolkit for Lua, written in Lua.

It bundles a LuaJIT runtime, a test runner, and a compiler that turns your Lua programs into single executables under 1mB — alongside a package registry with proper version locking and project-local isolation.

To get started, read the docs.

Features

  • lde new / lde init — scaffold a new project
  • lde run — Run your project, installing dependencies automatically
  • lde test — Run tests with the built-in lde-test framework
  • lde compile — Compile your project into a single distributable executable
  • lde bundle — Bundle your project into a single Lua file
  • lde add — Add dependencies from a path, git repo, or the registry
  • lde x / ldx — Execute a remote project directly, great for CLIs
  • lde tree — Visualize your dependency graph
  • lde update — Update dependencies to their latest versions
  • lde publish — Submit your package to the registry

Platform Support

OS Architecture
Linux x86-64, ARM64
macOS x86-64, ARM64
Windows x86-64, ARM64
Android ARM64

Installation

OS Command
Linux & macOS curl -fsSL https://lde.sh/install | sh
Windows irm https://lde.sh/install.ps1 | iex

Already installed? Run lde upgrade to update.

Quickstart

lde new myproject && cd myproject
lde add hood --git https://github.com/codebycruz/hood
echo "print(require('hood'))" > ./src/init.lua
lde run
# Output: table: 0x7f53326fd030

Or run a remote project in one command:

ldx triangle --git https://github.com/codebycruz/hood

How does lde compare to other tools?

See this table for a comparison with other common tools.

Contributors

Languages