8When you boot an Urbit we transfer the current version of the Arvo operating environment to your Urbit over our network. That is, the source for the system lives on your Urbit. Here we'll take a brief tour through the structure of a base Arvo desk.
10Looking at the top level of [the Arvo repo](http://github.com/urbit/arvo), or any Urbit desk that has been mounted to Unix we see something like:
23Let's step through directory by directory.
27This is where `%gall` apps live. `%gall` apps are stateful servers, sort of like unix daemons. One very familiar one is `app/talk.hoon` which is the source code for `:talk` the urbit messaging transport layer. And there's also `app/dojo.hoon` — that's your shell.
31This is where the `%arvo` vanes live. Vanes are sort of like kernel modules. These are worth listing one by one:
35`%ames` is our network protocol.
39`%behn` is a simple timer.
43`%clay` is our filesystem.
47`%dill` is our terminal driver.
51`%eyre` is our webserver.
55`%ford` is our build system.
59`%gall` is our application model.
63`%hoon` is our programming langauge. Since Hoon compiles itself the language is actually specified in its source.
67`%zuse` is the Hoon library.
69That's it. That's the whole system.
73`gen/` holds generators. Generators are command-line scripts.
77`lib/` holds shared libraries for programs. `lib/sole` is a good example — that's the console library that's shared by both `:dojo` in the command line, and the `dojo` web client.
81This is where marks live. Marks are data type definitions used by `%ford`. A mark is like a mime-type, but precisely specified in executable code.
85These are web renderers. A renderer handles web requests of a particular type.
87Default web requets in urbit are handled as a `.urb`, which is caught by the `urb.hoon` renderer. This wraps the request in our default `css` and `js` and adds some routing magic for certain paths.
91`sur/` contains shared data structures.
93Files in `sur` are like headers in C.
97There are the files publicly accessible to the web, as made possible by `%eyre`.
101This is the homepage for your urbit. You'll see it at `http://localhost:8080/` or `http://your-urbit.urbit.org/`.
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list