Skip to content
Get started making a simple app for Landscape with a few commands.
JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
full Strip hall and Chat /mar, /lib Oct 29, 2019
tile Nudging the tile on the left. Jul 23, 2019
urbit/app ++ -> +* Oct 28, 2019
.urbitrc Initial commit. Jul 9, 2019 Matching last PR Aug 5, 2019
gulpfile.js Removing unnecessary imports and adding to ver Aug 2, 2019
install.js Strip hall and Chat /mar, /lib Oct 29, 2019
package-lock.json update urbit-ob dependency Oct 16, 2019
package.json version increment -> 1.0.0 Oct 29, 2019

Get started building a simple application for Landscape on your Urbit ship with a few commands.

This tool is experimental and primarily used internally to develop front-end applications. While Tlon does not officially support this tool, you can always get general programming help for Urbit in the ~dopzod/urbit-help chat.


This repository is available as a template; to immediately generate your application's repository you can click here. Clone the generated repository, npm install and then run npm start to get started (you can also directly clone this repository, if you wish!).

In order to run your application on your ship, you will need Urbit v.0.8.0 or higher. On your Urbit ship, if you haven't already, mount your pier to Unix with |mount %.


Once you're up and running, your tile lives in tile/tile.js, which uses React to render itself -- you'll want a basic foothold with it first. When you make changes, the urbit directory will update with the compiled application and, if you're running npm run serve, it will automatically copy itself to your Urbit ship when you save your changes (more information on that below).

npm start

This runs the wizard. Give it an application name and the location of your Urbit ship's desk and it will customise the files so your new application will run on your ship.

npm run build

This builds your application and copies it into your Urbit ship's desk. In your Urbit (v.0.8.0 or higher) |commit %home (or %your-desk-name) to synchronise your changes.

If this is the first time you're running your application on your Urbit ship, don't forget to |start %yourapp.

npm run serve

Builds the application and copies it into your Urbit ship's desk, watching for changes. In your Urbit (v.0.8.0 or higher) |commit %home (or %your-desk-name) to synchronise your changes.


How can I ensure my app fits Landscape design?

Landscape makes use of the Tachyons CSS framework. The template tile and full application both make use of it as an example for you to get going fast.

What if I want to communicate with my ship / provide more functionality besides a front-end?

By default, your app will provide an example of passing state from ship to front-end with the peer-[yourappname]tile arm in the app's .hoon file -- in this case, just sending your ship's name as a data prop. The code is well-commented if you don't want to pass state, or if you want to know how to pass almost anything else from your ship to the Landscape interface.

In order to do anything substantial, of course, you'll want to know Hoon. If this is intimidating, don't panic: create-landscape-app is a fantastic way to start learning by leveraging your strengths. This repository is intended to be a boilerplate for rapid front-end development; it's also a gradual, incremental introduction to Hoon for web developers by allowing for rapid prototyping and experimentation with the Landscape interface.

Happy hacking!

You can’t perform that action at this time.