This repository contains some example code for Urbit. There are generators (dojo commands) in dojo/, libraries in libs/, HTML frontends generated by %ford in ford/, and full %gall applications in gall/.

The %examples desk on ~wactex-ribmex contains all the examples in this repository. To get these examples on your urbit, you can set up a sync from ~wactex-ribmex to your own %examples desk:

|sync %examples ~wactex-ribmex %examples
activated sync from %examples on ~wactex-ribmex to %examples
sync succeeded from %examples on ~wactex-ribmex to %examples

Change your current directory to the %examples desk:

> /=examples=

if you want to use a generator:

> +hello
"hello, world."

or a library:

> /+  sorts
> test:sorts
[~[4 5 6 10] ~[4 5 6 10]]

(note that there are two spaces between '/+' and 'sorts' in the first line)

Navigate to example %ford pages at http://your-ship.urbit.org/examples/fordn (with the appropriate number for n), or http://localhost:8080/examples/pub/fordn if you're not routed through ~doznec. To start example %gall apps, use |start %examples %name.

Many of the %gall apps have front ends that can also be found at http://YOUR-SHIP.urbit.org/examples/pub/APP-NAME/fab if you're routed through ~doznec, or http://localhost:8080/examples/pub/APP-NAME/fab if you're not.

We'd love to hear about your experience with these examples. Join us on talk, or contact Henry Ault ([email protected], ~sivtyv-barnel) with your feedback.