mirror of https://github.com/urbit/shrub.git synced 2024-12-15 04:22:48 +03:00

An operating function (Prototype)

Go to file

Philip Monk 6fe0f57056 add ++grad to md mark		2019-03-29 15:18:05 -07:00
.travis	[CI] bump pinned vere commit	2019-02-14 13:13:22 -08:00
app	Tiebout - Apple Push Notification Server App (#1084 )	2019-03-01 10:37:16 -08:00
gen	add \|bonk and flop ames timer order	2019-02-16 10:42:09 -08:00
lib	landscape: 1fcdc49935e6b1361270eb054611f06f765d5965	2019-03-12 15:15:20 -07:00
mar	add ++grad to md mark	2019-03-29 15:18:05 -07:00
ren	Merge branch 'next-ota' into trailing-whitespace	2019-01-18 13:23:52 -08:00
sec/com	Remove all security drivers but Google, which is used.	2018-12-10 15:59:35 -08:00
sur	Tiebout - Apple Push Notification Server App (#1084 )	2019-03-01 10:37:16 -08:00
sys	landscape sign in page	2019-03-18 15:49:43 -07:00
tests	Add support to `lens-command` for pill output and optimized base64 encoding. (#1068 )	2019-02-27 16:12:59 -08:00
web	reverted mobile pr; changed comet sigil to X	2019-03-12 16:16:06 -07:00
.gitignore	fixed missed renamings and added files to collections dir for ford testing	2018-08-01 11:32:34 -07:00
.travis.yml	Check for trailing whitespace during CI	2019-01-18 09:31:55 -08:00
LICENSE.txt	Update LICENSE copyright year	2017-09-16 09:22:07 -07:00
README.md	Add minimal contributing section to readme	2019-03-25 17:23:37 +01:00
web.hoon	- Added page redirect from / to /~~/landscape	2019-01-07 19:47:15 -08:00

README.md

Arvo

A clean-slate operating system.

Usage

To run Arvo, you'll need Urbit. To install Urbit and run Arvo please follow the instructions in the getting started docs. You'll be on the live network in a few minutes.

If you're doing development on Arvo, keep reading.

Documentation

Find Arvo's documentation on urbit.org.

Development

To boot a fake ship from your development files, run urbit with the following arguments:

urbit -F zod -A /path/to/arvo -c fakezod

Mount Arvo's filesystem allows you to update its contents through Unix. To do so, run |mount in dojo. It is most common to |mount /=home=.

To create a custom pill (bootstrapping object) from the files loaded into the home desk, run .my/pill +solid. Your pill will appear in /path/to/fakezod/.urb/put/my.pill.

To boot a fake ship with a custom pill, use the -B flag:

urbit -F zod -A /path/to/arvo -B /path/to.pill -c fakezod

To run all tests in /tests, run +test in dojo. +test /some/path would only run all tests in /tests/some/path.

Contributing

Contributions of any form are more than welcome! If something doesn't seem right, and there is no issue about it yet, feel free to open one.

If you're looking to make code contributions, a good place to start might be the good contributor issues.

Maintainers

Most parts of Arvo have dedicated maintainers.

/sys/hoon: @pilfer-pandex (~pilfer-pandex)
/sys/zuse: @pilfer-pandex (~pilfer-pandex)
/sys/arvo: @jtobin (~nidsut-tomdun)
/sys/vane/ames: @belisarius222 (~rovnys-ricfer) & @joemfb (~master-morzod)
/sys/vane/behn: @belisarius222 (~rovnys-ricfer)
/sys/vane/clay: @philipcmonk (~wicdev-wisryt)
/sys/vane/dill: @bernardodelaplaz (~rigdyn-sondur)
/sys/vane/eyre: @eglaysher (~littel-ponnys)
/sys/vane/ford: @belisarius222 (~rovnys-ricfer) & @eglaysher (~littel-ponnys)
/sys/vane/gall: @jtobin (~nidsut-tomdun)
/sys/vane/jael: @fang- (~palfun-foslup) & @joemfb (~master-morzod)
/app/acme: @joemfb (~master-morzod)
/app/dns: @joemfb (~master-morzod)
/app/hall: @fang- (~palfun-foslup)
/app/talk: @fang- (~palfun-foslup)
/lib/test: @eglaysher (~littel-ponnys)

Contact

We are using our new UI, Landscape, to run a few experimental cities. If you have an Azimuth point, please send us your planet name at support@urbit.org to request access.