Get started building a simple application for Landscape on your Urbit ship with a few commands.
Simply run npx @urbit/create-landscape-app
and follow the prompts, this will create a new folder with your application.
If you'd like to build your application in TypeScript, run npx @urbit/create-landscape-app --typescript
.
Once it's done open the README.md
in that directory to get started.
We're currently working on Indigo v2 and hope to release it soon as an NPM package that you can use in your app.
You may need to navigate to directly to https://localhost:3000
first to login.
Edit the ui/.env.local
file replacing {URL}
with the URL to your new ship:
VITE_SHIP_URL={URL}
Not necessarily! This template provides examples of using the packages @urbit/api
and @urbit/http-api
to use existing functionality on your Urbit through JavaScript without any additional lines of Hoon.
In order to do anything substantial with Gall, see this guide for pointers.
But 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.
You can always get general programming help for Urbit from the Urbit Community (~bitbet-bolbel/urbit-community), the Forge (~middev/the-forge) or the urbit-dev mailing list.
Happy hacking!