Teal – A Statically-typed Dialect Of Lua

TL;DR

Before you orderOffer from Amazon

Get wellness gear delivered free with Prime

• Fast, free delivery on millions of items
• Prime Video, Amazon Music and more included
• Member-only deals all year

Start your free Prime trial →Free trial for eligible customers · Cancel anytime

As an affiliate, we earn on qualifying purchases.Hide

Teal is a statically typed dialect of Lua that adds annotations for types such as records, arrays, maps, interfaces, union types and generics. Its compiler, tl, converts .tl source files into .lua, allowing projects to add type checking while keeping Lua as the output language. The project is open source under the MIT license; the supplied project information does not identify a new release or announcement date.

Teal is a statically typed dialect of Lua whose compiler, tl, turns annotated .tl source files into .lua. The project presents the language as a way to add types to Lua code while retaining Lua’s emphasis on minimalism, portability and embeddability; its site describes the project and tools but does not announce a dated release.

Teal’s type annotations let developers specify numbers and other types, as well as arrays, maps and records. The language also supports interfaces, union types and generics, according to the project site. Its example defines an `add` function with numeric arguments and a numeric return type, then calls the function and prints the result.

The compiler is installed through LuaRocks with the command `luarocks install tl`. The project also lists precompiled binaries for Linux and Windows and offers a browser-based playground. For larger projects, the site recommends Cyan, a build tool designed for Teal, rather than invoking the compiler on each file individually.

Additional project tools include VS Code integration through vscode-teal and a language server for NeoVim. Documentation is available online, while community development takes place on GitHub, with a forum and Matrix chat also listed. The project was started by Hisham Muhammad and is developed by contributors; its site says Teal itself is written in Teal.

Adding Types Without Replacing Lua

Teal’s approach is relevant to teams that want more explicit type information in Lua projects without adopting a language that produces a different runtime target. Because Teal compiles to ordinary Lua files, projects can use the typed source during development while keeping Lua as the generated code. That design may make Teal an option for developers who value Lua’s portability or embedding model but want compiler support for identifying type mismatches.

The project compares its intended niche to TypeScript for JavaScript. The analogy describes the role Teal aims to serve, not a guarantee of equal adoption, tooling coverage or compatibility. Its practical value depends on how well the compiler and supporting tools fit a project’s codebase and workflow. The site’s installation and editor options show that Teal is presented as more than a language definition, though they do not establish how widely those tools are used.

For readers maintaining Lua software, the key distinction is that Teal adds a typed source layer rather than replacing Lua outright. A team would still need to decide how it handles generated files, build steps and code that remains in plain Lua. The supplied project description does not report performance results, adoption figures or comparisons from independent evaluations, so those questions cannot be answered from the available information.

The Project’s Lua-Compatible Approach

Lua is known for use as an embeddable scripting language, and Teal’s project description explicitly frames its goals around minimalism, portability and embeddability. Rather than present Teal as a separate runtime, the project describes a compiler that converts its annotated source into Lua. That output model is central to the project’s stated aim of bringing static typing to developers already working in Lua.

The project site links to recorded talks about Lua, types and Teal’s design, including material dated 2019, 2020, 2021 and 2024. It also lists a 2025 discussion about directions for free and open-source projects. These links indicate an ongoing public conversation about the language’s development, but the supplied material does not give a release history, current version number or a specific milestone tied to this report.

Teal is distributed as free and open-source software under the MIT license, which the project says is also Lua’s license. The project’s documentation and community channels give users places to learn about the language and follow development. No project statistics or independent assessment of those resources are provided in the source material.

“Teal is a statically-typed dialect of Lua.”

— Teal project website

Release Status and Adoption Remain Unspecified

The source material does not identify a new release, announcement date or version number, so this report describes the project’s stated features rather than a newly confirmed launch. It also does not provide adoption figures, maintenance activity metrics, compatibility details for particular Lua versions, or independent testing of the compiler and editor integrations.

It is also unclear from the supplied information how Teal handles every mixed-code workflow, what guarantees its type checking provides, or how users should manage generated Lua in specific build and deployment setups. Those details may be covered in the project documentation, but they are not established by the material provided here.

Check Documentation for Project Updates

Developers interested in Teal can consult its online documentation, try the browser playground, or install the compiler through LuaRocks. Those considering a larger project can review Cyan and the listed editor tools, then test how the workflow fits their existing Lua code and build process.

The project points users to GitHub and its community channels for development and discussion. The source material does not specify a next release or milestone, so any future changes, including their timing, remain unannounced in the information used for this report.

Key Questions

What is Teal?

Teal is a statically typed dialect of Lua that adds type annotations and compiles its source code into Lua files.

What types and language features does Teal support?

The project lists annotations for arrays, maps and records, along with interfaces, union types and generics.

How do developers install Teal?

The project gives the LuaRocks command `luarocks install tl` and also lists precompiled binaries for Linux and Windows.

Does Teal replace Lua?

The project describes Teal as a Lua dialect that compiles .tl files into .lua. Its stated approach adds typed source code while retaining Lua as the compiler output.

Has Teal announced a new release?

No dated release announcement appears in the supplied project information. It describes Teal’s features, installation options and community resources but gives no current version or release date.

Source: hn