mirror of
https://github.com/urbit/developers.urbit.org.git
synced 2024-09-11 13:55:59 +03:00
86 lines
3.6 KiB
Markdown
86 lines
3.6 KiB
Markdown
+++
|
||
title = "A Developer Pill"
|
||
date = "2022-11-15"
|
||
description = "Announcing a new tool for developers."
|
||
[extra]
|
||
author = "N E Davis"
|
||
ship = "~lagrev-nocfep"
|
||
image = "https://media.urbit.org/site/posts/essays/blog-dev-pill.png"
|
||
+++
|
||
|
||
![](https://media.urbit.org/site/posts/essays/blog-dev-pill.png)
|
||
|
||
# A Developer Pill
|
||
|
||
---
|
||
|
||
**Update ~2023.2.16**
|
||
|
||
The developer pill process has been automated and the most up-to-date developer pill is available at `https://bootstrap.urbit.org/dev-latest.pill`.
|
||
|
||
Prior pills are available by timestamp, and we will have a Resources page listing those for your convenience soon.
|
||
|
||
The content currently remains %base %citadel %autoprop %docs %garden %webterm %argo %cliff, with `soon` as the upstream source for UF/Tlon desks.
|
||
|
||
You can boot a ship using the latest developer pill by either downloading the pill and using the -B flag, or using the -u flag with the URL.
|
||
|
||
---
|
||
|
||
A [pill](https://developers.urbit.org/reference/glossary/pill) is a bootstrap sequence to launch an Urbit ship for the first time. For most of Urbit's history, developers and users have typically used the supplied standard pill for booting their ships. Core developers would produce custom pills as a matter of testing changes in Arvo, but otherwise alternative pills were mostly ignored.
|
||
|
||
- [**The Developer Pill (generic `latest`)**](https://storage.googleapis.com/media.urbit.org/developers/dev-latest.pill)
|
||
- [**The Developer Pill (timestamped 2022-11-11)**](https://storage.googleapis.com/media.urbit.org/developers/dev-20221111.pill)
|
||
|
||
Today the Urbit Foundation unveils a new developer-oriented pill, which contains tools out-of-the-box to ease development and encourage best practices.
|
||
|
||
## Contents
|
||
|
||
The current pill contains the desks:
|
||
|
||
- `%argo` from `~dister-dozzod-middev`
|
||
- `%base` from `~mister-dister-dozzod-dozzod`
|
||
- `%citadel` from `~dister-dozzod-middev`
|
||
- `%cliff` from `~paldev`
|
||
- `%docs` from `~pocwet`
|
||
- `%garden` from `~mister-dister-dozzod-dozzod`
|
||
- `%webterm` from `~mister-dister-dozzod-dozzod`
|
||
|
||
## Usage
|
||
|
||
To use the pill, boot your developer ship with the `-B` option and the current pill. (We will timestamp developer pills and maintain a public changelog.)
|
||
|
||
```hoon
|
||
urbit -B dev-20221111.pill -F zod
|
||
```
|
||
|
||
Alternatively, use the `-u` flag and the URL of the source pill.
|
||
|
||
```hoon
|
||
urbit -u https://storage.googleapis.com/media.urbit.org/developers/dev-latest.pill -F zod
|
||
```
|
||
|
||
When serving with web pages, we also recommend considering using tooling such as [`~paldev`'s Suite (namely Rudder)](https://github.com/Fang-/suite/blob/master/lib/rudder.hoon) and [Quartus’ Schooner](https://github.com/dalten-collective/schooner/blob/master/lib/schooner.hoon).
|
||
|
||
We expect the developer pill to evolve over time as new apps come out and newer libraries and practices supersede others.
|
||
|
||
## Build Details
|
||
|
||
This brass pill was built using [a slightly modified pill builder](https://github.com/urbit/urbit/pull/6031) (to include `/dia` and `/doc` folders in `/gen/brass.pill`). A few minor changes are made to the standard desks:
|
||
|
||
- `%argo` has `%language-server` activated.
|
||
- `%citadel` has `%citadel-cli` activated.
|
||
|
||
No desks relying on `glob-ames` can be installed without modification, as Ames is not visible to a development fakeship.
|
||
|
||
The pill was built as a brass pill, e.g.:
|
||
|
||
```hoon {% copy=true %}
|
||
.brass/pill +brass %base %argo %citadel %cliff %docs %garden %webterm
|
||
```
|
||
|
||
## Feedback
|
||
|
||
If there are other developer-friendly apps that come online in the future, let us know and we'll be happy to consider them.
|
||
|
||
[~dister-dozzod-lapdeg/battery-payload](https://urbit.org/groups/~dister-dozzod-lapdeg/battery-payload)
|