Formerly called Taisho, Port allows you to spin up, access, and manage your ships whether they are comets, planets or potentially stars. It gives people the ability to immediately download and run Urbit without any knowledge of the command line.
Head over to releases and download the installer from the latest release. Currently only available for MacOS and Linux.
The architecture is built based off of James Long's article, The Secret of Good Electron Apps. With one exception, in production we don't run a simple process, but a hidden background window.
The main process' primary responsbility should be creation of windows and anything that requires interaction with the OS. Anything else should be diverted to the background window to ensure high performance.
The background folder contains all the services as well as the database client and an IPC server. Here is where most of the data and process management operations should happen. We also act as a proxy for the traditional IPC in most electron apps (not sure this is good, but it's what I went with.).
The renderer is a React + Typescript + TailwindCSS application. We use IPC to communicate only with the background process. External state like the DB is queried and mutated using react-query so that it is cached. Any internal UI state should run through either zustand or Context.
The urbit binaries for each respective OS should live in the resources
folder under the respective OS' folder. They aren't included because of size, but you can get them by running the get-urbit.sh
script.
Windows
The current plan for Windows is to wait for the port currently being reviewed by the core Urbit team. Once official we'll add support ASAP.