Handbook #

A practical, example-first path to learning VCL. The Handbook mirrors the structure of the TypeScript docs: start with everyday language constructs, then layer in effects, modules, and tooling. For precise rules, jump to the Reference section.

Chapters #

• Everyday VCL — syntax, indentation + trailing dots, basic types, records, variants, literals.
• Effects & Runtime — fetch/send/store/log, handler shapes, async model.
• Modules & Registry — imports, namespacing (foo::bar), local registry usage, publish/install.
• Tooling & Workflow — CLI, formatter/linter, VS Code extension, build/watch loops.
• VCL vs TypeScript — side-by-side cheatsheet for TS users.

If you’re in a hurry, read Everyday VCL → Effects & Runtime, then skim Modules & Tooling. The Reference section links the full spec and stdlib.