Documentation
Everything you need to learn and use ilusm - from a first program to the full standard library reference.
Start here
Loveshack
60-step interactive tutorial. Learn ilusm by writing real code in your browser - no install needed.
Get started
Install ilusm, write your first program, and understand the five-character rule in five minutes.
Download
Install ilusm locally. Available for Linux, macOS, and Windows.
Language reference
Language reference
Syntax, types, control flow, functions, modules, and the five-character surface rule - all in one place.
Specification
The formal language specification: grammar, evaluation rules, and module resolution.
Builtins
Every builtin function - prn, len, typ, str, int, and the rest - with signatures and examples.
Syntax guide
A visual walkthrough of ilusm syntax: literals, operators, blocks, and expressions.
Standard library
Full stdlib catalog
All 345 modules - browsable by domain with search. Networking, crypto, databases, hardware, AI, and more.
Domain showcase
One working snippet per module family with recorded output - the fastest way to see what the stdlib can do.
Using the stdlib
How modules are loaded, how use works, and conventions shared across the standard library.
Guides & examples
Cookbook
Real programs: web servers, CLI tools, security scripts, data pipelines. Copy, run, adapt.
How-to guides
Task-focused guides for common patterns - file I/O, HTTP requests, JSON, testing, and more.
Language tour
A quick read-through of the whole language: types, control flow, modules, and the stdlib, end to end.
Example programs
Annotated programs from the official release - hello world through full HTTP servers.
Guides
FAQ
Common questions about ilusm - what it is, the five-character rule, types, license, and more.
Types
All eight types - num, str, lst, obj, bol, nil, fun, bif - with examples and truthiness rules.
Operators
Every operator - arithmetic, comparison, logic, ranges, pipelines, and optional chaining.
Error handling
try, err, asr, and optional chaining - how ilusm handles failure.
Modules
How use works - loading stdlib modules, your own files, and what's always available.
Strings
String literals, interpolation, and the full txt module - split, join, search, replace.
Lists
List literals, loops, and the full trl module - map, filter, fold, sort, group, zip.
JSON
Encode and decode JSON with jsn - files, API responses, nested data.
HTTP
Make HTTP requests with net, build servers with web, WebSocket, TCP, UDP.
Concurrency
Tasks with syn.run, channels with syn.cha, and message-passing patterns.