# Quickstart
This page takes you from nothing to a live figure on your own web page, in four steps.
## 1. Get mtp
mtp is not yet published as a package, so you build it from its repository. You need
[git](https://git-scm.com), [uv](https://docs.astral.sh/uv/), [Node](https://nodejs.org) with
[pnpm](https://pnpm.io), and [just](https://just.systems).
```sh
git clone https://github.com/aris-pub/mathterpiece
cd mathterpiece
uv sync
cd web && pnpm install && cd ..
just build-web
```
`uv sync` installs the compiler, which gives you the `mtp` command through `uv run mtp`.
`just build-web` builds the runtime, the file `web/dist/mathterpiece.js` that draws figures on a
page.
## 2. Write a figure
Save this as `circle.mtp` in the `mathterpiece` folder:
```{mtp-example}
; a point on the unit circle, with cos in red and sin in green
(real theta 40 (wrap 0 360))
(scene s
(circle rim (r 1) (fill none) (stroke 'gray'))
(line cos (from [0 0]) (to [(cosd theta) 0]) (stroke 'crimson') (stroke-width 4))
(line sin (from [(cosd theta) 0]) (to (polar 1 theta)) (stroke 'seagreen') (stroke-width 4))
(circle p (r 0.07) (pos (polar 1 theta)) (fill 'slateblue')))
(canvas v (x -1.25) (y -1.25) (width 2.5) (height 2.5) s
(on-drag p (move theta (to (. (or? (to-polar pointer) [1 theta]) 1)))))
(slider turn (move theta (from 0) (to 360)) (label 'θ'))
```
The figure above is live: drag the point or move the slider. The file declares one variable,
`theta`, an angle that wraps around at 360. The scene draws a circle, a point at angle `theta`,
and the two lines whose lengths are its cosine and its sine. The canvas `v` shows the scene, and
dragging the point moves `theta`. The slider `turn` moves `theta` too.
## 3. Check and compile it
```sh
uv run mtp check circle.mtp
uv run mtp compile circle.mtp
```
`mtp check` reports the first error, with its line and column, and writes nothing. When the
figure is right, `mtp compile` writes `circle.mtpc`, the compiled figure.
To see the figure while you edit it, run `uv run mtp serve circle.mtp` and open the address that
it prints. The page reloads each time you save the file.
## 4. Put it on a page
Copy `web/dist/mathterpiece.js` and `circle.mtpc` into the folder of your page, and write:
```html
Turn the point: