git.iko.soy/urbit.org
on 2edef53 help sign in
urbit.org/content/develop.md
86 lines 2.5 kB history raw
1+++
2title = "Develop"
3template = "page_indiced.html"
4+++
6## Core Development {#core}
8## Application Development {#application}
10## Creating a Development Ship {#creating-a-development-ship}
12To do work with Hoon and with the system, we recommended using a "fake" ship -- one not connected to the network.
14Because such a ship has no presence on the network, you don't need an Azimuth identity for its purposes. You just need to have [installed our software](/install).
16To create a fake ship named `~zod`, run the command below. You can replace `zod` with any valid Urbit ship-name.
18```
19urbit -F zod
20```
22Now you should see a block of boot messages, starting with the Urbit version number. Welcome!
24### Basic Operations
26Welcome to your ship! There's a few things you should do to become oriented.
28#### The Dojo
30Let's try out the Dojo, the Arvo command line and Hoon REPL:
32```
33~sample-planet:dojo> (add 2 2)
34```
36Should produce:
38```
39> (add 2 2)
41```
43Good.
45#### Mounting
47Your ship's filesystem being "mounted" means that its filesystem can be interacted with through Unix. This makes things much easier for you.
49The Arvo filesystem isn't mounted to Unix by default. Switch to the Dojo prompt and run:
51```
52~sample-planet:dojo> |mount %
53```
55This should produce:
57```
58> |mount %
59>=
60```
62which indicates that the command was processed.
64`|mount %` will cause a `home/` directory to appear inside your _pier_ folder in Unix (the "pier" is our shorthand for the directory whose name corresponds to your Azimuth point). Changes to these files can be committed to your pier by running `|commit %home` once you're done.
66#### Shutting Down and Restarting
68You can turn your ship off with `ctrl-d` from the Talk or Dojo prompts.
70To restart your ship, simply pass the name of your pier:
72```
73urbit some-planet
74```
76## Community Tutorials {#community-tutorials}
78Here are some tutorials written by members of the Urbit community. Some are a little outdated, but they may still prove useful.
80- [Generators](https://github.com/joemfb/mardev/tree/master/docs/gen) by `~master-morzod`
81- [Urbit by Doing](https://github.com/Fang-/Urbit-By-Doing) by `~palfun-foslup`
82- [Learning Hoon](https://github.com/knubie/learning-hoon) by `@knubie`
83- [A Nock Interpreter](https://jtobin.io/nock) by `~nidsut-tomdun`
84- [Basic Hoonery](https://jtobin.io/basic-hoonery) by `~nidsut-tomdun`
86If you want to add something to the list, [shoot us an email](mailto:support@urbit.org) or make a pull request in the [docs repository](https://github.com/urbit/docs).