Skip to content

urbit/shrub

This branch is 808 commits ahead of, 996 commits behind urbit/urbit:develop.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

2d1c435 · Nov 21, 2024
Jul 18, 2023
Jul 11, 2024
Nov 30, 2022
Apr 25, 2019
Apr 16, 2024
Nov 21, 2024
Jul 7, 2023
Jun 17, 2024
Aug 6, 2024
Oct 5, 2021
Aug 1, 2019
Jan 30, 2020
Jul 12, 2019
May 24, 2023
Jan 28, 2020
Apr 29, 2023
Oct 26, 2022
Sep 27, 2024
Feb 9, 2023
Jul 7, 2023
Feb 22, 2024
Jun 3, 2022
Jul 16, 2023
Jan 18, 2023

Repository files navigation

Developer Environment Setup

urbit/shrub is alpha software that should not be booted on a live ship. Boot a fakeship to try it out.

When you boot your fakeship you should use the --loom 33 flag, which allocates 8GB of memory on your machine for your ship. During Shrubbery development you could end up nuking and restarting the %neo agent many times, which will quickly use up the 2GB of memory ships are allocated by default. If/when your ship runs out of memory, just boot a new one and copy your work into that.

  • Clone urbit/shrub to your machine. (The develop branch is the latest stable build.)
  • Boot a fakeship with the --loom 33 flag.
  • > |new-desk %neo on the fakeship
  • > |mount %neo
  • $ rsync -avL path/to/pkg/shrub/* path/to/fakeship/neo
  • > |commit %neo
  • > |install our %neo

This will start the %neo agent which runs the Shrubbery prototype. Once that's finished booting, which will take a few minutes, go to <localhost:port>/mast/mast-sky-ui/<fakeship @p>/sky to access Sky.

Once you're in Sky, click the "docs" tile to find documentation, which includes tutorials and reference material for developers.

When you want to move changes from your local repo to the fakeship, repeat the rsync -avL command above. The %neo agent can do incremental builds and will make changes to your /con and /imp files as you'd expect, but if you add or amend a /pro file you'll have to |nuke %neo and |revive %neo.

About

An operating function (Prototype)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • hoon 80.3%
  • TypeScript 14.7%
  • JavaScript 3.2%
  • CSS 0.6%
  • Python 0.3%
  • Vim Script 0.3%
  • Other 0.6%