First Program in MakrellTS¶

This short tutorial shows a minimal MakrellTS workflow: install the CLI, run a small source file, and see how familiar Makrell forms carry into the TypeScript-hosted track.

Install the CLI¶

bun add -g makrellts
makrellts hello.mrts

That gives you a quick end-to-end check that the installed CLI path is working.

Try a small source file¶

{fun add [x y]
  x + y}

add3 = {add 3 _}
[2 5 8] | {map add3} | sum

This example should already look familiar if you have seen MakrellPy or the shared family examples.

Then try a tiny macro¶

{def macro twice [x]
  [{quote $x} {quote $x}]}

This does not attempt to be a full macro tutorial. The point is to show that the TypeScript track also participates in the family macro model rather than only mirroring runtime syntax.

What this shows¶

This small session shows:

familiar Makrell syntax in a JS/TS-oriented host
CLI-based execution
the same family concepts carrying into the TypeScript track
a first hint of how compile-time forms fit into the implementation

Next steps¶

Continue with: