mirror of
https://github.com/urbit/developers.urbit.org.git
synced 2024-09-11 13:55:59 +03:00
commit
6160c387d3
71
content/blog/dev-pill.md
Normal file
71
content/blog/dev-pill.md
Normal file
@ -0,0 +1,71 @@
|
||||
+++
|
||||
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
|
||||
|
||||
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)
|
Loading…
Reference in New Issue
Block a user