git.iko.soy/urbit.org
on 89a2e21 help sign in
urbit.org/development/environment.md
62 lines 2.2 kB history raw
1+++
2title = "Environment Setup"
3description = "How to set up an environment for Urbit development."
4weight = 10
5template = "doc.html"
6+++
8This guide covers best practices for preparing your environment to develop
9within the Urbit ecosystem.
11## Creating a development ship
13To do work with Hoon, we recommended using a "fake" ship -- one that's not
14connected to the network.
16Because such a ship has no presence on the network, you don't need an Azimuth
17identity. You just need to have [installed the Urbit binary](/getting-started).
19To create a fake ship named `~zod`, run the command below. You can replace `zod`
20with any valid Urbit ship-name.
22```
23./urbit -F zod
24```
26This should take a couple of minutes, during which you should see a block of boot
27messages, starting with the Urbit version number.
30## Hoon support in text editors
32A variety of plugins have been built to provide support for the Hoon language in
33different text editors:
35#### Atom
36Atom is free and open-source and runs on all major operating systems. It is
37available [here](https://atom.io/). A package for Hoon support is maintained by
38Tlon and may be obtained using the package manager within the editor by
39searching for `Hoon`.
41#### Sublime Text
42Sublime Text is closed-source, but may be downloaded for free and there is no
43enforced time limit for evaluation. It runs on all major operating systems. It
44is available [here](https://www.sublimetext.com/).
46#### Visual Studio Code
47Visual Studio Code is free and open-source and runs on all major operating
48systems. It is available [here](https://code.visualstudio.com/). Hoon support
49may be acquired in the Extensions menu within the editor by searching for
50`Hoon`.
52#### Emacs
54Emacs is free and open-source and runs on all major operating systems. It is
55available [here](https://www.gnu.org/software/emacs/). Hoon support is available
56with [hoon-mode.el](https://github.com/urbit/hoon-mode.el).
58#### Vim
60Vim is free and open-source and runs on all major operating systems. It is
61available [here](https://www.vim.org/). Hoon support is available with
62[hoon.vim](https://github.com/urbit/hoon.vim) and is maintained by Tlon.