f477c86...master · urbit.org

.nova/Configuration.jsondeleted−3

since splitsnapshots

unifiedsplit

@@ -1,3 +0,0 @@

1−{

2− "workspace.name": "urbit.org"

3−}

components/ContentArea.js+1−1

@@ -66,7 +66,7 @@ export default function ContentArea(props) {

66 <div className="mb-16">

67 <h2 className="mt-24">{props.title}</h2>

68 {props?.description && (

69− <p className="text-wall-400 font-bold text-xl">

69+ <p className="text-wall-400 font-regular mt-2 text-xl">

70 {props.description}

71 </p>

72 )}

components/CopyLink.js+1−1

@@ -53,7 +53,7 @@ export default function CopyLink({ content, className }) {

53 onClick={() => copy()}

54 >

55 <p className="leading-5">

56− {copyStatus === "copied" ? "Copied" : "Copy Link"}

56+ {copyStatus === "copied" ? "Copied" : "Shortcode"}

57 </p>

58 {buttonIcon}

59 </button>

components/DocsSidebar.js+1−1

@@ -9,7 +9,7 @@ export default function Sidebar(props) {

9 <div className="hidden md:flex flex-col w-96 bg-wall-100 max-h-screen h-screen">

10 <header className="flex shrink-0 justify-between items-center pl-6 pt-12 mt-5 pb-8">

11 <Link href="/" passHref>

12− <a className="type-ui text-wall-500">Urbit</a>

12+ <a className="font-semibold antialiased text-lg text-wall-500">Urbit</a>

13 </Link>

14 </header>

15 <div className="overflow-y-auto p-6 pt-16">

components/GrantPreview.js+2−1

@@ -8,7 +8,7 @@ export default function GrantPreview({ grant }) {

8

9 const className = classnames({

10 "bg-lightBlue": type.includes("Proposal") && isOpen,

11− "bg-green-200": type.includes("Apprenticeship") && isOpen,

11+ "bg-purple-200": type.includes("RFP") && isOpen,

12 "bg-yellow-100": type.includes("Bounty") && isOpen,

13 });

14

@@ -38,6 +38,7 @@ export default function GrantPreview({ grant }) {

38 {grant.taxonomies.grant_type.map((category) => {

39 const className = classnames({

40 "bg-blue-400 text-white": category === "Proposal",

41+ "bg-purple text-white": category === "RFP",

41 "bg-green-400 text-white": category === "Apprenticeship",

42 "bg-green-400 text-white": category === "Apprenticeship",

42 "bg-yellow-300": category === "Bounty",

43 "bg-yellow-300": category === "Bounty",

43 });

44 });

components/Header.js+2−2

@@ -8,7 +8,7 @@ function ActiveLink({ children, href, className, currentPath }) {

8 const firstCrumb = currentPath.split("/")[1];

9

10 const activeClassName = classnames({

11− "text-wall-600": "/" + firstCrumb === href,

11+ "text-wall-900": "/" + firstCrumb === href,

12 "text-wall-500": "/" + firstCrumb !== href,

13 });

14

@@ -48,7 +48,7 @@ export default function Header(props) {

48 <nav className="items-center hidden md:flex">

49 <ActiveLink

50 currentPath={currentPath}

51− className="mr-5 text-green-400 type-ui button-text"

51+ className="mr-5 type-ui"

52 href="/getting-started"

53 >

54 Get Started

components/HighlightCard.jsnew file+22

@@ -0,0 +1,22 @@

1+import Link from "next/link";

2+export default function HighlightCard({ slug, highlight }) {

3+ return (

4+ <Link href={highlight.url}>

5+ <div className="cursor-pointer bg-wall-100 rounded-xl min-h-0 flex-1">

6+ <div className="flex flex-col p-4 h-full relative">

7+ {highlight.image ? (

8+ <div className="w-64 md:w-full rounded-xl object-cover overflow-hidden basis-3/5">

9+ <img className="h-full w-64 md:w-full object-cover" src={highlight.image} />

10+ </div>

11+ ) : (

12+ <div className="rounded-xl w-full"/>

13+ )}

14+ <div className="pt-4">

15+ <p className="mb-2 font-semibold leading-5">{highlight.title}</p>

16+ <p className="text-sm leading-5">{highlight?.description}</p>

17+ </div>

18+ </div>

19+ </div>

20+ </Link>

21+ );

22+}

components/Meta.js+21−2

@@ -2,14 +2,33 @@ export default function Meta(post, disableImage, large = false) {

2 const author = post?.extra?.author || "urbit.org";

3 const title = post?.title ? post.title : "";

4 const description =

5− post?.description || "Urbit is a personal server built from scratch.";

5+ post?.description || "Urbit is a new kind of computer that you can own completely in ways that matter: networking, identity, & data.";

6 const image =

7 post?.extra?.image ||

8 post?.image ||

9− "https://media.urbit.org/logo/urbit-logo-card.png";

9+ "https://storage.googleapis.com/media.urbit.org/site/opengraph/sig-white.png";

10 return (

11 <>

12 <link rel="icon" type="image/png" href="/images/favicon.ico" />

13+ <link

14+ rel="apple-touch-icon"

15+ sizes="180x180"

16+ href="/images/apple-touch-icon.png"

17+ />

18+ <link

19+ rel="icon"

20+ type="image/png"

21+ sizes="32x32"

22+ href="/images/favicon-32x32.png"

23+ />

24+ <link

25+ rel="icon"

26+ type="image/png"

27+ sizes="16x16"

28+ href="/images/favicon-16x16.png"

29+ />

30+ <link rel="manifest" href="/images/site.webmanifest" />

31+

13 <meta

32 <meta

14 name="twitter:card"

33 name="twitter:card"

15 content={large ? "summary_large_image" : "summary"}

34 content={large ? "summary_large_image" : "summary"}

components/Search.jsdeleted−393

@@ -1,393 +0,0 @@

1−import { Component } from "react";

2−import { withRouter } from "next/router";

3−import debounce from "lodash.debounce";

4−import Downshift from "downshift";

5−import ob from "urbit-ob";

6−import Sigil from "../components/Sigil";

7−

8−class Search extends Component {

9− constructor(props) {

10− super(props);

11− this.state = {

12− results: [],

13− };

14− this.searchEndpoint = this.searchEndpoint.bind(this);

15− this.onInputValueChange = this.onInputValueChange.bind(this);

16− this.onSelect = this.onSelect.bind(this);

17− this.patpSearch = this.patpSearch.bind(this);

18− this.devSearch = this.devSearch.bind(this);

19− this.opsSearch = this.opsSearch.bind(this);

20− }

21−

22− searchEndpoint(query) {

23− return `/api/search?q=${encodeURIComponent(query)}`;

24− }

25−

26− devSearch(query) {

27− return `/api/dev-search?q=${encodeURIComponent(query)}`;

28− }

29−

30− opsSearch(query) {

31− return `/api/ops-search?q=${encodeURIComponent(query)}`;

32− }

33−

34− patpSearch(query) {

35− return (

36− (ob.isValidPatp(`~${deSig(query.toLowerCase())}`) &&

37− `~${deSig(query.toLowerCase())}`.length < 15) ||

38− (!isNaN(query) && query <= 4294967295)

39− );

40− }

41−

42− onSelect(item) {

43− this.setState({

44− query: "",

45− results: [],

46− });

47−

48− if (item.url) {

49− this.props.router.push(`${item.url}${item?.slug ? item.slug : ""}`);

50− return this.props.closeSearch();

51− }

52− if (item.slug) {

53− this.props.router.push(item.slug);

54− return this.props.closeSearch();

55− }

56− }

57−

58− onInputValueChange = debounce(async (query) => {

59− if (query.length) {

60− const search = fetch(this.searchEndpoint(query))

61− .then((res) => res.json())

62− .then(async (res) => {

63− return [...res.glossary.map((item) => ({

64− type: "GLOSSARY_RESULT",

65− content: item

66− })), ...res.results.map((item) => ({

67− type: "RESULT",

68− content: item,

69− }))];

70− });

71−

72− const patp = this.patpSearch(query)

73− ? !isNaN(query)

74− ? ob.patp(query)

75− : ob.patp(ob.patp2dec(`~${deSig(query)}`))

76− : null;

77−

78− const patpResult = this.patpSearch(query)

79− ? [

80− {

81− type: "PATP",

82− content: {

83− patp: patp,

84− slug: `/ids/${patp}`,

85− },

86− },

87− ]

88− : [];

89−

90− const devSearch = fetch(this.devSearch(query))

91− .then((res) => res.json())

92− .then((res) => {

93− return [...res.glossary.map((item) => ({

94− type: "GLOSSARY_RESULT",

95− content: item

96− })), ...res.results.map((item) => ({

97− type: "DEV_RESULT",

98− content: item,

99− }))];

100− });

101−

102− const opsSearch = fetch(this.opsSearch(query))

103− .then((res) => res.json())

104− .then((res) => {

105− return [...res.glossary.map((item) => ({

106− type: "GLOSSARY_RESULT",

107− content: item

108− })), ...res.results.map((item) => ({

109− type: "OPS_RESULT",

110− content: item,

111− }))];

112− });

113−

114− const [results, devResults, opsResults] =

115− await Promise.all([search, devSearch, opsSearch]);

116−

117− const list = [

118− ...patpResult,

119− ...results,

120− ...devResults,

121− ...opsResults,

122− ]

123− .sort((a, b) => {

124− const aNum = a?.type === "GLOSSARY_RESULT" ? 1 : -1;

125− const bNum = b?.type === "GLOSSARY_RESULT" ? 1 : -1;

126− return bNum - aNum;

127− });;

128−

129− this.setState({ results: list });

130− } else {

131− this.setState({ results: [] });

132− }

133− }, 250);

134−

135− render() {

136− const { state, props } = this;

137−

138− if (props.showSearch) {

139− return (

140− <Downshift

141− onSelect={(selection) => this.onSelect(selection)}

142− onInputValueChange={(event) => this.onInputValueChange(event)}

143− itemToString={(item) => (item ? item.slug : "")}

144− defaultHighlightedIndex={0}

145− >

146− {({

147− getInputProps,

148− getItemProps,

149− getLabelProps,

150− getMenuProps,

151− isOpen,

152− inputValue,

153− highlightedIndex,

154− selectedItem,

155− getRootProps,

156− }) => (

157− <div className="fixed w-screen h-screen z-50 flex flex-col items-center p-4">

158− <div

159− onClick={(event) => props.closeSearch(event)}

160− className="top-0 left-0 fixed w-screen h-screen bg-washedWall"

161− />

162− <div className="relative flex flex-col max-w-screen-lg md:my-32 w-full md:w-10/12 lg:w-8/12 xl:w-6/12 rounded-xl bg-white min-h-0 overflow-hidden">

163− <div

164− style={{ display: "inline-block" }}

165− {...getRootProps({}, { suppressRefError: true })}

166− >

167− <input

168− autoFocus

169− className="text-lg md:text-xl lg:text-2xl font-medium text-green-400 bg-transparent py-2 px-4 outline-none relative w-full"

170− placeholder="Search..."

171− type="text"

172− onClick={(e) => e.stopPropagation()}

173− {...getInputProps({

174− onKeyDown: (event) => {

175− if (event.key === "Escape") {

176− // Prevent Downshift's default 'Escape' behavior.

177− event.nativeEvent.preventDownshiftDefault = true;

178− this.props.closeSearch(event);

179− }

180− },

181− })}

182− />

183− </div>

184− <ul {...getMenuProps()} className="overflow-y-scroll">

185− {isOpen

186− ? state.results.map((item, index) => {

187− const selected = highlightedIndex === index;

188− if (item.type === "PATP") {

189− return (

190− <li

191− className={`cursor-pointer p-2 flex space-x-2 items-center text-left w-full ${selected ? "bg-green-400" : ""

192− }`}

193− {...getItemProps({

194− key: item.content.slug + "-" + index,

195− index,

196− item: item.content,

197− selected: highlightedIndex === index,

198− })}

199− >

200− <div className="rounded-md overflow-hidden">

201− <Sigil

202− patp={item.content.patp}

203− size={25}

204− icon

205− />

206− </div>

207− <p className="font-mono">{item.content.patp}</p>

208− </li>

209− );

210− }

211− if (item.type === "GLOSSARY_RESULT") {

212− return (

213− <li

214− className={`cursor-pointer flex text-left w-full ${selected ? "bg-green-400" : ""

215− }`}

216− {...getItemProps({

217− key: item.content.slug + "-" + index,

218− index,

219− item: item.content,

220− selected: highlightedIndex === index,

221− })}

222− >

223− <div className="font-semibold p-3">

224− <p

225− className={`text-base ${selected ? "text-white" : "text-wall-600"

226− }`}

227− >

228− {item.content.symbol.length > 0 && (

229− <code

230− className={`mr-1 rounded px-1 py-0.5 ${selected

231− ? "bg-washedWhite"

232− : "bg-wall-100"

233− }`}

234− >

235− {item.content.symbol}

236− </code>

237− )}

238− {item.content.name}

239− </p>

240− <p

241− className={`font-normal text-base mt-1 ${selected ? "text-white" : "text-wall-600"

242− }`}

243− dangerouslySetInnerHTML={{

244− __html: item.content.desc,

245− }}

246− ></p>

247− </div>

248− </li>

249− );

250− }

251− if (item.type === "RESULT") {

252− return (

253− <li

254− className={`cursor-pointer flex text-left w-full ${selected ? "bg-green-400" : ""

255− }`}

256− {...getItemProps({

257− key: item.content.link + "-" + index,

258− index,

259− item: item.content,

260− selected,

261− })}

262− >

263− <div className="p-3">

264− <p

265− className={`font-medium text-base ${selected ? "text-white" : "text-wall-600"

266− }`}

267− >

268− {item.content.parent !== "Content"

269− ? `${item.content.parent} /`

270− : ""}{" "}

271− {item.content.title}

272− </p>

273− <p

274− className={`text-base font-regular text-small ${selected ? "text-midWhite" : "text-wall-500"

275− }`}

276− >

277− {item.content.content}

278− {item?.content?.foundOnPage && (

279− <span className="italic block">

280− Found in page content

281− </span>

282− )}

283− </p>

284− </div>

285− </li>

286− );

287− }

288− if (item.type === "DEV_RESULT") {

289− const devItem = Object.assign({}, item.content);

290− devItem[

291− "slug"

292− ] = `https://developers.urbit.org${item.content.slug}`;

293− return (

294− <li

295− className={`cursor-pointer flex text-left w-full ${selected ? "bg-green-400" : ""

296− }`}

297− {...getItemProps({

298− key: item.content.link + "-" + index,

299− index,

300− item: devItem,

301− selected,

302− })}

303− >

304− <div className="p-3">

305− <p

306− className={`font-medium text-base ${selected ? "text-white" : "text-wall-600"

307− }`}

308− >

309− <span className="text-wall-400">

310− {item.content.parent !== "Content"

311− ? `developers.urbit.org / ${item.content.parent} /`

312− : "developers.urbit.org /"}{" "}

313− </span>

314− {item.content.title}

315− </p>

316− <p

317− className={`text-base font-regular text-small ${selected ? "text-midWhite" : "text-wall-500"

318− }`}

319− >

320− {item.content.content}

321− {item?.content?.foundOnPage && (

322− <span className="italic block">

323− Found in page content

324− </span>

325− )}

326− </p>

327− </div>

328− </li>

329− );

330− }

331− if (item.type === "OPS_RESULT") {

332− const opsItem = Object.assign({}, item.content);

333− opsItem[

334− "slug"

335− ] = `https://operators.urbit.org${item.content.slug}`;

336− return (

337− <li

338− className={`cursor-pointer flex text-left w-full ${selected ? "bg-green-400" : ""

339− }`}

340− {...getItemProps({

341− key: item.content.link + "-" + index,

342− index,

343− item: opsItem,

344− selected,

345− })}

346− >

347− <div className="p-3">

348− <p

349− className={`font-medium text-base ${selected ? "text-white" : "text-wall-600"

350− }`}

351− >

352− <span className="text-wall-400">

353− {item.content.parent !== "Content"

354− ? `operators.urbit.org / ${item.content.parent} /`

355− : "operators.urbit.org /"}{" "}

356− </span>

357− {item.content.title}

358− </p>

359− <p

360− className={`text-base font-regular text-small ${selected ? "text-midWhite" : "text-wall-500"

361− }`}

362− >

363− {item.content.content}

364− {item?.content?.foundOnPage && (

365− <span className="italic block">

366− Found in page content

367− </span>

368− )}

369− </p>

370− </div>

371− </li>

372− );

373− }

374− return null;

375− })

376− : null}

377− </ul>

378− </div>

379− </div>

380− )}

381− </Downshift>

382− );

383− } else {

384− return null;

385− }

386− }

387−}

388−

389−function deSig(string) {

390− return string.startsWith("~") ? string.substring(1) : string;

391−}

392−

393−export default withRouter(Search);

components/Sigil.jsdeleted−36

@@ -1,36 +0,0 @@

1−import { sigil, reactRenderer } from "@tlon/sigil-js";

2−

3−export const foregroundFromBackground = (background) => {

4− const rgb = {

5− r: parseInt(background.slice(1, 3), 16),

6− g: parseInt(background.slice(3, 5), 16),

7− b: parseInt(background.slice(5, 7), 16),

8− };

9− const brightness = (299 * rgb.r + 587 * rgb.g + 114 * rgb.b) / 1000;

10− const whiteBrightness = 255;

11−

12− return whiteBrightness - brightness < 50 ? "black" : "white";

13−};

14−

15−export const Sigil = ({ patp, size, color = "#24201E", icon }) => {

16− if (patp.length > 14) {

17− return <div />;

18− }

19− const foreground = foregroundFromBackground(color);

20− return (

21− <div

22− className={icon ? "p-1" : ""}

23− style={{ backgroundColor: icon ? color || "black" : "transparent" }}

24− >

25− {sigil({

26− patp: patp,

27− renderer: reactRenderer,

28− size: icon ? size / 2 : size,

29− colors: [color, foreground],

30− icon: icon || false,

31− })}

32− </div>

33− );

34−};

35−

36−export default Sigil;

components/ecosystem/Badge.jsnew file+20

@@ -0,0 +1,20 @@

1+import classnames from "classnames";

2+export default function EcosystemBadge({ type }) {

3+ return (

4+ <div

5+ className={classnames(

6+ "uppercase font-bold text-white text-xs w-fit rounded-lg mb-2 px-2 py-1",

7+ {

8+ "bg-[#B37ED7]": type === "Organization",

9+ "bg-[#83b2d4]": type === "Application",

10+ "bg-wall-600": type === "Podcast",

11+ "bg-[#8dd5b1]": type === "Marketplace",

12+ "bg-[#B5966D]": type === "Article",

13+ "bg-[#219DFF]": type === "Group",

14+ }

15+ )}

16+ >

17+ {type}

18+ </div>

19+ );

20+}

components/ecosystem/BasicPage.js+15−1

@@ -1,5 +1,6 @@

1import { useRouter } from "next/router";

2import Head from "next/head";

3+import Link from "next/link";

3import Meta from "../Meta";

4import Meta from "../Meta";

4import ErrorPage from "../../pages/404";

5import ErrorPage from "../../pages/404";

5import classnames from "classnames";

6import classnames from "classnames";

@@ -45,7 +46,7 @@ export default function BasicPage({

45 <div className="flex items-center space-x-4">

46 <div className="flex items-center space-x-4">

46 <img src={post.image} className="w-36" />

47 <img src={post.image} className="w-36" />

47 <div className="flex flex-col pl-2">

48 <div className="flex flex-col pl-2">

48− <h1 className={classnames({ "text-3xl": section === "Podcast" }, { "text-3xl": section === "Article" })}>

49+ <h1 className="text-3xl">

49 {post.title}

50 {post.title}

50 </h1>

51 </h1>

51 <p>{section}</p>

52 <p>{section}</p>

@@ -79,6 +80,16 @@ export default function BasicPage({

79 />

80 />

80 )}

81 )}

81

82

83+ {post?.twitter && (

84+ <div className="flex flex-col">

85+ <p className="font-bold text-wall-400">Twitter</p>

86+ <Link href={"http://twitter.com/" + post.twitter}>

87+ <a className="text-green-400 text-sm font-semibold font-mono">@{post.twitter}</a>

88+ </Link>

89+ </div>

90+ )}

91+

92+

82 {post?.URL && section !== "Podcast" && section !== "Article" && (

93 {post?.URL && section !== "Podcast" && section !== "Article" && (

83 <div className="flex flex-col">

94 <div className="flex flex-col">

84 <p className="font-bold text-wall-400">Website</p>

95 <p className="font-bold text-wall-400">Website</p>

@@ -100,6 +111,9 @@ export default function BasicPage({

100 </div>

111 </div>

101 )}

112 )}

102 </div>

113 </div>

114+

115+

116+

103 {post?.URL && section === "Podcast" && (

117 {post?.URL && section === "Podcast" && (

104 <a

118 <a

105 href={post.URL}

119 href={post.URL}

components/ecosystem/EcosystemSidebar.jsnew file+86

@@ -0,0 +1,86 @@

1+import { useRouter } from "next/router";

2+import Link from "next/link";

3+import classnames from "classnames";

4+function ActiveLink({ children, href, className, currentPath }) {

5+ // special casing this behaviour which overloads one nav

6+ const archive = Boolean(

7+ currentPath === "/ecosystem?type=archive" && href === "/ecosystem"

8+ );

9+ const activeClassName = classnames({

10+ "text-wall-800": currentPath === href || archive,

11+ "text-wall-400": currentPath !== href && !archive,

12+ });

13+

14+ return (

15+ <Link href={href} passHref>

16+ <a className={`${className} ${activeClassName}`}>{children}</a>

17+ </Link>

18+ );

19+}

20+

21+export default function EcosystemSidebar() {

22+ const router = useRouter();

23+ let currentPath = router.asPath;

24+ return (

25+ <div className="flex flex-col space-y-4 pr-24">

26+ <ActiveLink

27+ currentPath={currentPath}

28+ className="type-ui"

29+ href="/ecosystem"

30+ >

31+ Spotlight

32+ </ActiveLink>

33+ <ActiveLink

34+ currentPath={currentPath}

35+ className="type-ui"

36+ href="/ecosystem?type=communities"

37+ >

38+ Communities

39+ </ActiveLink>

40+ <ActiveLink

41+ currentPath={currentPath}

42+ className="type-ui"

43+ href="/ecosystem?type=organizations"

44+ >

45+ Organizations

46+ </ActiveLink>

47+

48+ <ActiveLink

49+ currentPath={currentPath}

50+ className="type-ui"

51+ href="/ecosystem?type=applications"

52+ >

53+ Applications

54+ </ActiveLink>

55+ <ActiveLink

56+ currentPath={currentPath}

57+ className="type-ui"

58+ href="/ecosystem?type=groups"

59+ >

60+ Groups

61+ </ActiveLink>

62+ <ActiveLink

63+ currentPath={currentPath}

64+ className="type-ui"

65+ href="/ecosystem?type=marketplaces"

66+ >

67+ Marketplaces

68+ </ActiveLink>

69+ <ActiveLink

70+ currentPath={currentPath}

71+ className="mr-5 type-ui"

72+ href="/ecosystem?type=podcasts"

73+ >

74+ Podcasts

75+ </ActiveLink>

76+

77+ <ActiveLink

78+ currentPath={currentPath}

79+ className="mr-5 type-ui"

80+ href="/ecosystem?type=articles"

81+ >

82+ Articles

83+ </ActiveLink>

84+ </div>

85+ );

86+}

components/ecosystem/IndexCard.js+2−21

@@ -1,5 +1,5 @@

1import Link from "next/link";

2−import classnames from "classnames";

2+import EcosystemBadge from "./Badge";

3export default function IndexCard({ slug, feat }) {

4 return (

5 <Link href={slug}>

@@ -24,7 +24,7 @@ export default function IndexCard({ slug, feat }) {

24 )}

25 <div className="pt-4">

26 <p className="mb-2 font-semibold leading-5">{feat.title}</p>

27− {badge(feat.type)}

27+ <EcosystemBadge type={feat.type} />

28 <p className="text-sm leading-5">{feat?.description}</p>

29 </div>

30 </div>

@@ -32,22 +32,3 @@ export default function IndexCard({ slug, feat }) {

32 </Link>

33 );

34}

35−

36−const badge = (type) => {

37− return (

38− <div

39− className={classnames(

40− "uppercase font-bold text-white text-xs w-fit rounded-lg mb-5 px-2 py-1",

41− {

42− "bg-[#B37ED7]": type === "Organization",

43− "bg-[#83b2d4]": type === "Application",

44− "bg-wall-600": type === "Podcast",

45− "bg-[#8dd5b1]": type === "Marketplace",

46− "bg-[#B5966D]": type === "Article"

47− }

48− )}

49− >

50− {type}

51− </div>

52− );

53−};

components/ecosystem/Post.js+25−23

@@ -1,10 +1,11 @@

1import { Markdown } from "@urbit/foundation-design-system";

2−import classnames from "classnames";

2+import EcosystemBadge from "./Badge";

3+

3import Link from "next/link";

4import Link from "next/link";

4export default function Post({ post }) {

5export default function Post({ post }) {

5 return ["featured-1", "featured-2", "featured-3"].map((feat) => {

6 return ["featured-1", "featured-2", "featured-3"].map((feat) => {

6 const childPath =

7 const childPath =

7− post[feat] && post[feat]?.matchedPost?.type === "Application"

8+ post[feat] && (post[feat]?.matchedPost?.type === "Application" || post[feat]?.matchedPost?.type === "Group")

8 ? `${post[feat]?.matchedPost.ship}/${post[feat].matchedPost.slug}`

9 ? `${post[feat]?.matchedPost.ship}/${post[feat].matchedPost.slug}`

9 : `${post[feat].matchedPost?.slug}`;

10 : `${post[feat].matchedPost?.slug}`;

10 const href = post[feat]?.matchedPost

11 const href = post[feat]?.matchedPost

@@ -23,10 +24,10 @@ export default function Post({ post }) {

23 post[feat]?.matchedPost?.bgColor || "rgba(0,0,0,0)",

24 post[feat]?.matchedPost?.bgColor || "rgba(0,0,0,0)",

24 }}

25 }}

25 >

26 >

26− {post[feat]?.matchedPost?.image && (

27+ {(post[feat]?.matchedPost?.image || post[feat]?.matchedPost?.tile) && (

27 <img

28 <img

28 className="rounded-xl w-24 object-cover"

29 className="rounded-xl w-24 object-cover"

29− src={post[feat]?.matchedPost?.image}

30+ src={post[feat]?.matchedPost?.image || post[feat]?.matchedPost?.tile}

30 />

31 />

31 )}

32 )}

32 </div>

33 </div>

@@ -34,7 +35,7 @@ export default function Post({ post }) {

34 <h4 className="text-xl pb-2 leading-6 font-bold">

35 <h4 className="text-xl pb-2 leading-6 font-bold">

35 {post?.[feat].title}

36 {post?.[feat].title}

36 </h4>

37 </h4>

37− {badge(post[feat].type)}

38+ <EcosystemBadge type={post[feat].type} />

38 </div>

39 </div>

40 </div>

40 <div className="markdown mt-8 mb-8">

41 <div className="markdown mt-8 mb-8">

@@ -73,6 +74,15 @@ export default function Post({ post }) {

73 </Link>

74 </Link>

74 )}

75 )}

75

76

77+ {post[feat].type === "Community" && (

78+ <Link href={href || "#"} passHref>

79+ <a class="button-sm text-white flex-col bg-green-400 cursor-pointer pr-4 w-fit">

80+ More about {post[feat].title}

81+ </a>

82+ </Link>

83+ )}

84+

85+

76 {post[feat].type === "Marketplace" && (

86 {post[feat].type === "Marketplace" && (

77 <Link href={href || "#"} passHref>

87 <Link href={href || "#"} passHref>

78 <a class="button-sm text-white flex-col bg-green-400 cursor-pointer pr-4 w-fit">

88 <a class="button-sm text-white flex-col bg-green-400 cursor-pointer pr-4 w-fit">

@@ -80,26 +90,18 @@ export default function Post({ post }) {

80 </a>

90 </a>

81 </Link>

91 </Link>

82 )}

92 )}

93+

94+ {post[feat].type === "Group" && (

95+ <Link href={href || "#"} passHref>

96+ <a class="button-sm text-white flex-col bg-green-400 cursor-pointer pr-4 w-fit">

97+ More about {post[feat].title}

98+ </a>

99+ </Link>

100+ )}

101+

83 </div>

102 </div>

84 ) : null;

103 ) : null;

85 });

104 });

86}

105}

87

106

88−const badge = (type) => {

107+

89− return (

90− <div

91− className={classnames(

92− "uppercase font-bold text-white text-xs w-fit rounded-lg mb-2 px-2 py-1",

93− {

94− "bg-[#B37ED7]": type === "Organization",

95− "bg-[#83b2d4]": type === "Application",

96− "bg-wall-600": type === "Podcast",

97− "bg-[#8dd5b1]": type === "Marketplace",

98− "bg-[#B5966D]": type === "Article",

99− }

100− )}

101− >

102− {type}

103− </div>

104− );

105−};

components/ecosystem/SpotlightArchive.jsnew file+66

@@ -0,0 +1,66 @@

1+import { Container, IntraNav, SingleColumn, Section } from "@urbit/foundation-design-system";

2+import Header from "../Header";

3+import Footer from "../Footer";

4+import Meta from "../Meta";

5+import Head from "next/head";

6+import Link from "next/link";

7+import EcosystemSidebar from "./EcosystemSidebar";

8+import Sidebar from "../Sidebar";

9+

10+export default function SpotlightArchive({ posts, search }) {

11+ const post = {

12+ title: "Spotlight Archive",

13+ description: "The archive of ecosystem spotlights.",

14+ };

15+ return (

16+ <Container>

17+ <Head>

18+ <title>Archive • Spotlight • Urbit</title>

19+ {Meta(post)}

20+ </Head>

21+ <IntraNav ourSite="https://urbit.org" search={search} />

22+ <SingleColumn>

23+ <Header search={search} />

24+ <Section>

25+ <div className="measure">

26+ <h1>Ecosystem</h1>

27+ </div>

28+ </Section>

29+ <Section className="flex">

30+ <Sidebar>

31+ <EcosystemSidebar />

32+ </Sidebar>

33+ <div>

34+ <h3 className="mb-12">Spotlight Archive</h3>

35+ {posts.map((post) => {

36+ return (

37+ <div key={post.slug} className="mb-24 cursor-pointer">

38+ <Link href={`/ecosystem/spotlight/${post.slug}`}>

39+ <div>

40+ <h3 className="text-green-400">{post.title}</h3>

41+ <div className="type-ui mt-2">

42+ {["featured-1", "featured-2", "featured-3"].map(

43+ (feat, i) => {

44+ if (post?.[feat]) {

45+ return (

46+ <>

47+ {i ? ", " : ""}

48+ <span>{post[feat].title}</span>

49+ </>

50+ );

51+ }

52+ }

53+ )}

54+ </div>

55+ </div>

56+ </Link>

57+ </div>

58+ );

59+ })}

60+ </div>

61+ </Section>

62+ </SingleColumn>

63+ <Footer />

64+ </Container>

65+ );

66+}

components/gateway/Image.js+1−2

@@ -1,5 +1,4 @@

1−import Sigil from "../Sigil";

1+import { Sigil } from "@urbit/foundation-design-system";

2−

3const GatewayImage = ({

2const GatewayImage = ({

4 error = false,

3 error = false,

5 patp = false,

4 patp = false,

content/applications/~bacwyl-samweg/templeochess.md+4−3

@@ -1,11 +1,12 @@

1+++

2title = "Temple O Chess"

3−shortcode = "~ropmer-nosnux-bacwyl-samweg/templeochess"

3+shortcode = "~bacwyl-samweg/templeochess"

4license = "MIT"

5−image = "https://templeos.org/Templeos-header.png"

5+image = "https://0x0.st/oFuT.png"

6−bgColor = "#11FFFF"

6+bgColor = "#FFFF55"

7developer = "~bacwyl-samweg"

8website = "https://youtu.be/Raej8C2yIEc"

9+description = "chess game from Temple OS"

9+++

10+++

10

11

11### Chess from Temple OS

12### Chess from Temple OS

content/applications/~disreb-winner-mittec/urbit-go.md+1

@@ -6,6 +6,7 @@ image = "https://winnermittec.space/icon.svg"

6bgColor = "#D37504"

7developer = "~winner-mittec"

8website = "https://winnermittec.space/"

9+description = "Go on Urbit"

9+++

10+++

10

11

11The classic board-game Go, now on Urbit!

12The classic board-game Go, now on Urbit!

content/applications/~doller-doller-rabsef-bicrym/books.md → content/applications/~dister-dozzod-dalten/books.mdrenamed+3−3

@@ -1,8 +1,8 @@

1+++

2−title = "books"

2+title = "Books"

3developer = "Quartus Co."

4−shortcode = "~doller-doller-rabsef-bicrym/books"

4+shortcode = "~dister-dozzod-dalten/books"

5−description = "it just makes cents"

5+description = "It just makes cents"

6license = "MIT"

7website = "https://dalten.org"

8bgColor = "#E44D11"

content/applications/~dalten/gora.md → content/applications/~dister-dozzod-dalten/gora.mdrenamed+1

@@ -21,3 +21,4 @@ Gora has two distros in

21circulation - these can be found at:

22~laddys-dozzod-dalten (Vue.js frontend)

23~mister-dozzod-dalten (sail frontend)

24+The canonical distro for all Quartus and Dalten Collective apps can always be found at ~dister-dozzod-dalten

content/applications/~dister-dozzod-dalten/keep.mdnew file+13

@@ -0,0 +1,13 @@

1++++

2+title = "Keep"

3+developer = "Quartus Co."

4+shortcode = "~dister-dozzod-dalten/keep"

5+description = "State backup for your agents"

6+license = "MIT"

7+website = "https://dalten.org"

8+bgColor = "#E44D11"

9++++

10+

11+Keep is backup utility for preserving the state of your applications across breaches. Unlike [peat](https://urbit.org/ecosystem/applications/~dister-dozzod-dalten/peat), Keep can backup the state of any arbitrary agent, but does not offer granular control of specific graphs or other targeted contexts.

12+

13+For support with any of Quartus' applications, please visit the [Quartus public group](https://urbit.org/ecosystem/groups/~mister-hilper-dozzod-dalten/quartus)

content/applications/~magped-magped-rabsef-bicrym/orca.md → content/applications/~dister-dozzod-dalten/orca.mdrenamed+5−3

@@ -1,13 +1,15 @@

1+++

2−title = "orca"

2+title = "Orca"

3−developer = "~dalten"

3+developer = "Quartus Co."

4−shortcode = "~magped-magped-rabsef-bicrym/orca"

4+shortcode = "~dister-dozzod-dalten/orca"

5description = "Now THIS is podchatting"

6license = "MIT"

7website = "https://dalten.org"

8bgColor = "#13181C"

9+++

10

11+** ocra has been deprecated and will soon be replaced with updated tooling supporting chat federation for the new Groups backend **

12+

11Now THIS is podchatting

13Now THIS is podchatting

12

14

13![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/orca.png)

15![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/orca.png)

content/applications/~magped-magped-rabsef-bicrym/peat.md → content/applications/~dister-dozzod-dalten/peat.mdrenamed+2−2

@@ -1,14 +1,14 @@

1+++

2title = "peat"

3developer = "Quartus Co."

4−shortcode = "~magped-magped-rabsef-bicrym/peat"

4+shortcode = "~dister-dozzod-dalten/peat"

5description = "Graph Backup and Restoration Utility"

6license = "REKT"

7website = "https://dalten.org"

8bgColor = "#574D5A"

9+++

10

11−Peat is Urbit's first backup utility.

11+Peat is Urbit's first backup utility and works with the %graph-store backend. Quartus is also working to support backup and recovery for arbitrary agent state via %keep, as well as updated utility tooling that supports the new Groups backend.

12

13![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/peat.png)

14

content/applications/~magped-magped-rabsef-bicrym/wrdu.md → content/applications/~dister-dozzod-dalten/wrdu.mdrenamed+3−3

@@ -1,8 +1,8 @@

1+++

2title = "wrdu"

3−developer = "~dalten"

3+developer = "Quartus Co."

4−shortcode = "~magped-magped-rabsef-bicrym/wrdu"

4+shortcode = "~dister-dozzod-dalten/wrdu"

5−description = "word game by ~dalten for our mothers"

5+description = "Word game by ~dalten for our mothers"

6license = "MIT"

7website = "https://dalten.org"

8bgColor = "#79A86B"

content/applications/~fabnev-hinmur/escape.md+1−1

@@ -6,7 +6,7 @@ description = "EScape from Eternal September. The UI from Uqbar."

6license = "MIT"

7website = "https://uqbar.network"

8bgColor = "#f2f3ef"

9−image = "https://escape-app-dist.s3.us-east-2.amazonaws.com/uqbar-logo.png"

9+image = "https://escape-app-dist.s3.us-east-2.amazonaws.com/escape-logo.png"

10+++

11

12EScape is a fully-integrated social management and DAO Tooling system. EScape provides a simple, intuitive, and unified interface for managing groups, messaging ships, receiving notifications, and interacting with other Urbit apps.

content/applications/~finmep-lanteb/chess.md+5−3

@@ -1,12 +1,14 @@

1+++

2title = "Chess"

3shortcode = "~finmep-lanteb/chess"

4−developer = "~finmep-lanteb & ~sigryn-habrex"

4+developer = "~bonbud-macryg, ~finmep-lanteb, ~nordus-mocwyl, ~rovmug-ticfyn, ~sigryn-habrex"

5description = "Fully peer-to-peer chess over Urbit"

6license = "GPL3"

7−website = "https://github.com/ashelkovnykov/urbit-chess"

7+website = "https://github.com/thecommons-urbit/chess"

8bgColor = "#ffffff"

9image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/finmep-chess.svg"

10+++

11

12−Fully decentralized, peer-to-peer Chess app for Urbit

12+Fully decentralized, peer-to-peer Chess app for Urbit

13+

14+![chess example](https://raw.githubusercontent.com/thecommons-urbit/chess/master/images/urbit-chess-demo.png)

content/applications/~hanfel-dovned/board.mdnew file+14

@@ -0,0 +1,14 @@

1++++

2+title = "Board"

3+shortcode = "~dister-hanfel-dovned/board"

4+license = "MIT"

5+image = ""

6+bgColor = "#9E34EB"

7+developer = "~hanfel-dovned"

8+website = "https://github.com/hanfel-dovned/Board"

9+description = "A digital bulletin-board"

10++++

11+

12+An implementation of [Robin Sloan’s Spring ‘83](https://www.robinsloan.com/lab/specifying-spring-83/) concept as an Urbit app called %board. Imagine a digital bulletin-board where each item is a person’s miniature homepage, and the pages you see are based on who you know.

13+

14+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/board.png)

content/applications/~hanfel-dovned/pony.mdnew file+12

@@ -0,0 +1,12 @@

1++++

2+title = "Pony"

3+shortcode = "~dister-hanfel-dovned/pony"

4+license = "MIT"

5+image = ""

6+bgColor = "#232323"

7+developer = "~hanfel-dovned"

8+website = "https://github.com/hanfel-dovned/Pony"

9+description = "Pony is an app for longform threaded conversations"

10++++

11+

12+Pony is an app for longform threaded conversations, like a blend of email and message boards. Create private threads with arbitrary sets of ships, fork threads to new sets of participants, schedule messages to be sent later, and much more.

content/applications/~hanfel-dovned/slam.md+1

@@ -6,6 +6,7 @@ image = "https://hanfel-dovned.sfo3.digitaloceanspaces.com/slam-tile.png"

6bgColor = "#100032"

7developer = "~hanfel-dovned"

8website = "https://github.com/hanfel-dovned/Slam"

9+description = "A social arcade game"

9+++

10+++

10

11

11Slam is a social arcade game where you battle waves of enemies that are generated from your pals' gorae.

12Slam is a social arcade game where you battle waves of enemies that are generated from your pals' gorae.

content/applications/~hanrut-sillet-dachus-tiprel/blog.mdnew file+16

@@ -0,0 +1,16 @@

1++++

2+title = "%blog"

3+shortcode = "~hanrut-sillet-dachus-tiprel/blog"

4+license = "MIT"

5+image = ""

6+bgColor = "#533E78"

7+developer = "~dachus-tiprel"

8+website = "https://dachus-tiprel.tlon.network/blog/introducing-blog"

9+description = "The easiest and most versatile publishing app on Urbit"

10++++

11+

12+A publishing tool for creating a basic blog with markdown and css.

13+

14+Blog is just what it sounds like. A new tool from Uqbar, the app lets anyone on Urbit spin up and customize a blog that displays to the net at an auto-generated URL. Nothing could be breezier. Plus it’s got payments through Uqbar and group-blogging settings on the roadmap. Find out more about it on it's [creator's blog](https://dachus-tiprel.tlon.network/blog/introducing-blog).

15+

16+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/blog.png)

content/applications/~lander-dister-dozzod-dozzod/groups.mddeleted−31

@@ -1,31 +0,0 @@

1−+++

2−title = "Groups"

3−developer = "Tlon"

4−shortcode = "~lander-dister-dozzod-dozzod/landscape"

5−description = "A suite of applications to communicate on Urbit"

6−license = "MIT"

7−website = "https://tlon.io"

8−bgColor = "#DC5F3F"

9−+++

10−

11−

12−Groups is Tlon's flagship app: a community center, workspace, gallery, publisher, and messenger. Designed as a tool for collectives and organizations of various sizes on Urbit, Groups can host a company communication suite, a DAO, a blog, a music syndicate, and just about anything that involves collaboration, publication, or communication.

13−

14−![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/groups.png)

15−

16−*Messages–send encrypted direct messages to one or many friends:*

17−

18−Reach out to your friends directly via Messages, a simple chat tool that lets you talk one-on-one or with many.

19−

20−*Notebooks–write and publish documents or blog posts:*

21−

22−Write a blog post, create a magazine, draft an announcement or documentation using Notebooks, a short and long form text editor. You can add images, give other ships permission to comment on your posts, and mirror your content on the mainnet with ~tirrel's %studio app.

23−

24−*Collections–maintain a mood board and gather links:*

25−

26−Assemble a feed of images, save links for later, make a mood board, or start a forum on Collections, a repository for day-to-day digital trawling.

27−

28−*Profiles–personalize your Urbit ID:*

29−

30−Make your Urbit ID yours: set a nickname, write a bio, change your avatar, or choose to stay anonymous. You can also pin featured groups on your profile. Hint: It’s a good way to share and discover new groups to join.

31−

content/applications/~larryx-woldyr/osmosis.mdnew file+12

@@ -0,0 +1,12 @@

1++++

2+title = "Osmosis"

3+shortcode = "~larryx-woldyr/osmosis"

4+license = "MIT"

5+image = "https://holium-app-globs.nyc3.cdn.digitaloceanspaces.com/osmosis/osmosis-logo-wc.png"

6+bgColor = "#180D39"

7+developer = "~larryx-woldyr"

8+website = "https://https://osmosis.zone/"

9+description = "Interchain liquidity lab."

10++++

11+

12+A fully self-hosted Osmosis frontend, deployed via Urbit.

content/applications/~larryx-woldyr/safe.mdnew file+12

@@ -0,0 +1,12 @@

1++++

2+title = "Safe"

3+shortcode = "~larryx-woldyr/safe"

4+license = "MIT"

5+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/safe.jpeg"

6+bgColor = "#180D39"

7+developer = "~larryx-woldyr"

8+website = "https://safe.global/"

9+description = "Safe front-end"

10++++

11+

12+A fully self-hosted Safe frontend, deployed via Urbit.

content/applications/~larryx-woldyr/uniswap.mdnew file+12

@@ -0,0 +1,12 @@

1++++

2+title = "Uniswap"

3+shortcode = "~larryx-woldyr/uniswap-v3"

4+license = "MIT"

5+image = "https://cryptologos.cc/logos/uniswap-uni-logo.png"

6+bgColor = "0xffffff"

7+developer = "~larryx-woldyr"

8+website = "http://uniswap.org"

9+description = "Self-hosted Uniswap interface"

10++++

11+

12+A self-hosted Uniswap interface for swapping assets on Ethereum.

content/applications/~larryx-woldyr/urbhue.mdnew file+18

@@ -0,0 +1,18 @@

1++++

2+title = "Hue"

3+shortcode = "~larryx-woldyr/urbhue"

4+license = "MIT"

5+image = "https://i.imgur.com/czmkmoK.png"

6+bgColor = "#F0B43D"

7+developer = "~larryx-woldyr"

8+website = "https://ajlamarc.com"

9+description = "Controlling Philips Hue"

10++++

11+

12+In this prototype, Philips Hue Lightbulbs and groups can be controlled from a standard Urbit application by using the Hue Remote API.

13+

14+History and logging of the bulb are collected to provoke consideration of what should be controlled and tracked by the people living in a smart home.

15+

16+This app will hopefully inspire people to think of the potential utility of Urbit in the smart home, inspire non-Urbit users to think of Urbit in non-community driven scenarios, and be a small step forward in understanding the affordances for Urbit in the home.

17+

18+For more information on `%urbhue`, check out our Urbit group: `~pilwyc-fastec/communal-computing-for-urbit`

content/applications/~lomder-librun/realm.mdnew file+18

@@ -0,0 +1,18 @@

1++++

2+title = "Realm"

3+shortcode = "~lomdyr-librun/realm"

4+license = ""

5+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/realm-icon.png"

6+bgColor = ""

7+developer = "Holium"

8+website = "https://www.holium.com/"

9+description = "A desktop interface for Urbit"

10++++

11+

12+Realm is a desktop app for Urbit communities (currently in private alpha).

13+

14+[Sign up for the alpha.](https://www.holium.com/)

15+

16+<iframe width="560" height="315" src="https://www.youtube.com/embed/gdu4QtFR-Bs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

17+

18+Note that the shortcode will not install this application.

content/applications/~niblyx-malnus/gol-cli.mdnew file+15

@@ -0,0 +1,15 @@

1++++

2+title = "Goals"

3+shortcode = "~dister-dozzod-niblyx-malnus/gol-cli"

4+license = "MIT"

5+image = ""

6+bgColor = "#362711"

7+developer = "~niblyx-malnus"

8+website = ""

9+description = "Hierarchically nested goals and projects"

10++++

11+

12+### Goals helps you track and share interrelated tasks

13+

14+

15+Goals is primarily dealing with four kinds of relationships: containment/ownership, virtual nesting, precedence, and priority. These fundamental relationships between goals and that any other important information about a goal does not require any complex sort of topological representation, but can simply be a piece of data associated with the goal.

content/applications/~nocsyx-lassul/sphinx.md+1

@@ -6,6 +6,7 @@ image = "https://nyc3.digitaloceanspaces.com/hmillerdev/nocsyx-lassul/2022.7.16.

6bgColor = "#b25068"

7developer = "~nocsyx-lassul"

8website = "https://github.com/arthyn/sphinx"

9+description = "Community powered search"

9+++

10+++

10

11

11### Community powered search

12### Community powered search

content/applications/~nodmyn-dosrux/basket.mdnew file+34

@@ -0,0 +1,34 @@

1++++

2+title = "basket"

3+shortcode = "~nodmyn-dosrux/basket"

4+license = "MIT"

5+image = "https://0x0.st/oFHB.png"

6+bgColor = "#F2F2F2"

7+developer = "Assembly Capital"

8+website = "https://github.com/bacwyls/basket"

9+description = "show off your meme collection"

10++++

11+

12+

13+### Basket is a simple db of tagged images

14+

15+The frontend displays the most recent image in the full window,

16+so it can be used to add some personal style to an urbit desktop environment.

17+

18+In addition to being a personal db, basket is an experimental app on top of the 'rooms' primitive in [Realm](https://twitter.com/HoliumCorp).

19+

20+Members of a room have temporary write-access to each others basket db.

21+The frontend makes it ergonomic and fun to share / collaboritively create this data.

22+

23+In theory (at scale), this creates a kind of decentralized giphy.

24+

25+The images you know about are the images your friends have shared with you.

26+It gamifies the creation of rich, human curated image metadata.

27+One obvious use case for this is keeping track of memes.

28+

29+To export the full dataset you can GET `http://yoururbitship.com/~/scry/basket/images.json`

30+Then you might want to use a python script to actually download the images to local storage.

31+

32+Eventually, it would be nice to have a simple way to export and share the dataset.

33+

34+Read full documentation on the [Github repository](https://github.com/bacwyls/basket).

content/applications/~nodmyn-dosrux/vita.mdnew file+20

@@ -0,0 +1,20 @@

1++++

2+title = "vita"

3+shortcode = "~nodmyn-dosrux/vita"

4+license = "MIT"

5+image = "https://bwyl.nyc3.digitaloceanspaces.com/vita%2Fvita.png"

6+bgColor = "#F2F2F2"

7+developer = "Assembly Capital"

8+website = "https://github.com/assemblycapital/vita"

9+description = "monitor your app distributions"

10++++

11+

12+### Keep track of your app distributions

13+

14+To get downloads, `:vita` periodically scrys %cs /subs for each desk and caches the results.

15+

16+`:vita` accepts foreign pokes attesting to activity on a desk.

17+`/lib/vita-client.hoon` helps any agent send vita activity pokes.

18+It sends a maximum of one poke per day, and allows users to opt-in / opt-out depending on developer preference.

19+

20+Read full documentation on the [Github repository](https://github.com/assemblycapital/vita).

content/applications/~paldev/scooore.mdnew file+14

@@ -0,0 +1,14 @@

1++++

2+title = "sc'o're"

3+developer = "~paldev"

4+shortcode = "~paldev/scooore"

5+description = "leaderboard for groups' ['o']s, as seen on tv!"

6+license = "MIT"

7+image ="https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/scooore.svg"

8+website = "https://pal.dev/suite/scooore"

9+bgColor = "#FDFF54"

10++++

11+

12+A leaderboard of your peers' emoji reactions in Groups.

13+

14+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/scooore.png)

content/applications/~sogryp-dister-dozzod-dozzod/groups.mdnew file+40

@@ -0,0 +1,40 @@

1++++

2+title = "Groups"

3+shortcode = "~sogryp-dister-dozzod-dozzod/groups"

4+license = "MIT"

5+image = "https://bootstrap.urbit.org/icon-groups.svg"

6+bgColor = "#EFF0F4"

7+developer = "Tlon"

8+website = "https://github.com/tloncorp/landscape-apps"

9+description = "Groups is a decentralized platform that integrates with Talk, Notebook, and Gallery for a full, communal suite of tools."

10++++

11+

12+Start, host, and cultivate communities. Own your communications, organize your resources, and share documents. Groups is a decentralized platform that integrates with Talk, Notebook, and Gallery for a full, communal suite of tools.

13+

14+ <video autoPlay muted loop playsInline>

15+ <source

16+ src="https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/groups-create-a-group.webm"

17+ type="video/webm"

18+ />

19+ </video>

20+

21+Teams, clubs, DAOs, and secret societies use Groups to digitally congregate, using channel integrations to extend their capabilities.

22+

23+ <video autoPlay muted loop playsInline>

24+ <source

25+ src="https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/groups-create-a-channel.webm"

26+ type="video/webm"

27+ />

28+ </video>

29+

30+Write, edit, and publish longform or shorter documents with Notebook, a basic text editor for announcements, internal meeting minutes, blogs, and everything in between.

31+

32+ <video autoPlay muted loop playsInline>

33+ <source

34+ src="https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/notebooks.webm"

35+ type="video/webm"

36+ />

37+ </video>

38+

39+

40+Gather links to images, articles, and web pages to maintain a collection of references with Gallery, a versatile and interoperable repository for day-to-day digital trawling.

content/applications/~sogryp-dister-dozzod-dozzod/talk.mdnew file+21

@@ -0,0 +1,21 @@

1++++

2+title = "Talk"

3+shortcode = "~sogryp-dister-dozzod-dozzod/talk"

4+license = "MIT"

5+image = "https://bootstrap.urbit.org/icon-talk.svg"

6+bgColor = "#2B5DC0"

7+developer = "Tlon"

8+website = "https://github.com/tloncorp/landscape-apps"

9+description = "Talk is a decentralized chat app that integrates with Groups, Notebook, and Gallery for a full, communal suite of tools."

10++++

11+

12+Send peer-to-peer direct messages to one or many friends. Talk is a simple chat tool for catching up, getting work done, and everything in between.

13+

14+ <video autoPlay muted loop playsInline>

15+ <source

16+ src="https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/talk.webm"

17+ type="video/webm"

18+ />

19+ </video>

20+

21+Start threads. React with emojis. Respond to your Groups chat channels from Talk. When integrated with Groups, both direct messages and team chats appear in Talk. Two apps in one place.

content/applications/~sortug/gate.mdnew file+27

@@ -0,0 +1,27 @@

1++++

2+title = "Gate"

3+shortcode = "~dister-dozzod-sortug/gate"

4+license = "MIT"

5+image = "https://s3.sortug.com/img/fav.png"

6+bgColor = "#000000"

7+developer = "Sortug Development"

8+website = "https://sortug.com"

9+description = "Seamless QR login"

10++++

11+

12+# Secure, seamless login for Urbit

13+

14+Let's make joining Urbit easier!

15+

16+Why do this?

17+![code](https://s3.sortug.com/img/gate-code.png)

18+When you can do this?

19+![gate](https://s3.sortug.com/img/gate-gate.png)

20+

21+Logging in to any Urbit app requires you to input your ship's URL and the `+code` generated on dojo. This requires people to login to their ship's terminal, output the code on dojo, then copy and paste it in their browser or app. This is bad enough if you have a ship running locally, but if you have it running remotely (as is common) the process becomes seriously annoying.

22+

23+Mainstream mobile apps such as Signal handle first login much more seamlessly; after registration is done, further logins are done via QR code. The app produces a QR code, you scan it, and that's it. That's the state-of-the-art, battle-tested user experience for modern applications. Now available on Urbit.

24+

25+Gate makes it easier for newcomers to use Urbit, and greatly enhances the user experience of native applications, desktop and mobile, that Urbit deserves.

26+

27+Users can login to Urbit just by scanning a QR code, receive a URL link and login to an Urbit ship instantly by clicking on it. That simple. Most importantly, hosting providers can use Gate to send a QR code or a URL link to a user, and have the user access his Urbit apps with a simple camera scan or click of a link, making the onboarding process much easier for non-technical users.

content/applications/~sortug/trill.md+2−2

@@ -1,6 +1,6 @@

1+++

2title = "Trill"

3−shortcode = "~hoster-dozzod-sortug/trill"

3+shortcode = "~dister-dozzod-sortug/trill"

4license = "MIT"

5image = "https://s3.urbit.cloud/img/trill-logo.png"

6bgColor = "#000000"

@@ -24,4 +24,4 @@ There are no ads in Trill, no "trends", no analytics. We don't even know how man

24### More information

25You can install the app by searching for ~dister-dozzod-sortug on your Grid interface, or by running `|install ~dister-dozzod-sortug %trill` in Dojo.

26

27−The official group of the app is at ~hoster-dozzod-sortug/trill on the Groups app.

27+The official group of the app is at ~hoster-dozzod-sortug/trill on the Groups app.

content/applications/~sortug/ufa.md+1−1

@@ -1,6 +1,6 @@

1+++

2title = "Urbit Feed Aggregator"

3−shortcode = "~hoster-dozzod-sortug/ufa"

3+shortcode = "~dister-dozzod-sortug/ufa"

4license = "MIT"

5image = "https://s3.urbit.cloud/img/lan.png"

6bgColor = "#000000"

content/applications/~tiller-tolbus/membrane.mdnew file+14

@@ -0,0 +1,14 @@

1++++

2+title = "Membrane"

3+shortcode = "~mister-master-tiller-tolbus/membrane"

4+license = "MIT"

5+image = "https://tiller-tolbus.nyc3.digitaloceanspaces.com/membrane.png"

6+bgColor = ""

7+developer = "~tiller-tolbus"

8+website = ""

9+description = "Spreadsheets and databases"

10++++

11+

12+### Membrane is a spreadsheet tool for Urbit

13+

14+Spreadsheets were the original tool for the productivity power user, so it is only fitting that we bring them to Urbit. Keep a budget, run a formula, and share your sheets with friends using Membrane.

content/applications/~tirrel/scene.mdnew file+14

@@ -0,0 +1,14 @@

1++++

2+title = "Scene"

3+shortcode = ""

4+license = ""

5+image = "https://tirrel.io/assets/scene-logo-stroke.svg"

6+bgColor = "rgb(0, 0, 0)"

7+developer = "Tirrel Corp."

8+website = "https://tirrel.io"

9+description = "The new Urbit desktop, by ~tirrel corp."

10++++

11+

12+![Screenshot](https://tirrel.io/assets/scene-demo-screenshot.webp)

13+

14+[Download scene here](https://tirrel.io/scene/index.html).

content/applications/~tirrel/studio.md+1−1

@@ -1,7 +1,7 @@

1+++

2title = "Studio"

3shortcode = "~tirrel/studio"

4−license = "MIT"

4+license = ""

5image = "https://tirrel.io/assets/stool.svg"

6bgColor = "rgb(160, 226, 167)"

7developer = "Tirrel Corp."

content/applications/~worpet-bildet/portal.mdnew file+16

@@ -0,0 +1,16 @@

1++++

2+title = "Portal"

3+shortcode = "~worpet-bildet/portal"

4+license = ""

5+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/portal.svg"

6+bgColor = "rgb(0,0,0)"

7+developer = ""

8+website = ""

9+description = "Portal is the front page"

10++++

11+

12+### Portal is the front page for urbit

13+

14+Portal made its debut as the solution to decentralized discovery on Urbit. Portal enables anyone on Urbit to curate content, apps, and groups for other ships to discover

15+

16+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/portal-screenshot.png)

content/apprenticeships.md+5−12

@@ -1,6 +1,6 @@

1+++

2title = "Become an Apprentice"

3−date = "2022-10-26"

3+date = "2023-01-04"

4weight = 1

5description = "Everything you need to know about applying for an apprenticeship"

6+++

@@ -17,21 +17,14 @@ Becoming an apprentice is easily one of the best ways to level up your skills, a

17

18Apprenticeships are for those that are new to Urbit development (or an area of it), and would like to find their grounding by working on a pre-existing codebase and problem set. Nearly all apprenticeships involve some degree of Hoon work, so you should make sure that you've completed [Hoon School](https://developers.urbit.org/guides/core/hoon-school) and [App School](https://developers.urbit.org/guides/core/app-school/intro) in either their asychronous or [cohort formats](https://developers.urbit.org/courses) prior to signing up.

19

20−There are two ways to sign up for an apprenticeship:

20+To become an apprentice, [apply for an open apprenticeship](/grants?program=apprenticeship&open=true&wip=false&completed=false#view-grants)

21

22−1. [Apply for an open apprenticeship](/grants?program=apprenticeship&open=true&wip=false&completed=false#view-grants)

23−2. [Sign up to be matched to a mentor](https://airtable.com/shrUZQpHqRtudHhAx)

24−

25−Apprenticeships are sometimes posted on the site to be claimed, but more often than not they emerge out of a conversation between a mentor and an enthusiastic potential apprentice. This is because mentors are generally busy engineering, and while they know many things that need to be done, getting those ideas into writing is difficult.

22+Although some apprenticeships are posted on this site to be claimed, more often than not they emerge out of a conversation between a mentor and an enthusiastic potential apprentice. This is because mentors are generally busy engineering, and while they know many things that need to be done, getting those ideas into writing is difficult.

26−

27−When you [sign up to be matched](https://airtable.com/shrUZQpHqRtudHhAx), the Urbit Foundation will review your application, pass it around to available mentors, and more often than not a call will get scheduled with the lead for a project that may be a good fit.

28

23

29## How it works

24## How it works

30

25

31Once a mentor has written up an apprenticeship, and approved an apprentice, The Urbit Foundation will perform a quick KYC step and send contracts to all parties for signing. Once those contracts are executed, work can proceed.

26Once a mentor has written up an apprenticeship, and approved an apprentice, The Urbit Foundation will perform a quick KYC step and send contracts to all parties for signing. Once those contracts are executed, work can proceed.

32

27

33−The mentor will host a group with a chat and notebook where ongoing asychronous discussions can occur, and long-form content can be shared.

34−

35Mentors and apprentices work together by having weekly pairing sessions and maintaining an open line of communication over Urbit. It's expected that mentors put at least two hours per week into supporting their apprentice.

28Mentors and apprentices work together by having weekly pairing sessions and maintaining an open line of communication over Urbit. It's expected that mentors put at least two hours per week into supporting their apprentice.

36

29

37## Funding

30## Funding

@@ -40,6 +33,6 @@ Apprenticeships pay 1 star upon the sucessful completion of the apprenticeship,

40

33

41## Getting Paid

34## Getting Paid

42

35

43−When an apprentice has completed the scope of their grant, they will create a detailed writeup of the work completed and their learnings, post it in the Apprenticeship notebook, and get the approval of their mentor. After recieving this approval from your mentor, please [submit an invoice here](https://airtable.com/shrXXCs1uaxtNSBcg). Upon successful review of this notebook post by the Urbit Foundation and an invoice recieved for the amount agreed upon in your grant or milestone, the Foundation will pay your star allocation to the Ethereum address you have provided.

36+When you have completed the scope of your grant, you will create a detailed writeup of the work completed and your learnings, share the writeup with your mentor, and get your approval of completion. After recieving this approval from your mentor, please [submit an invoice here](https://airtable.com/shrXXCs1uaxtNSBcg). Your mentor must also contact `~marfun-pacpet` to confirm completion of the apprenticeship and approve the payment. Once the Urbit Foundation receives approval from your champion and an invoice for the amount agreed upon in your grant or milestone, the Foundation will pay your star allocation to the Ethereum address you have provided.

44

37

45−We approve and issue payments within 30 days of invoice receipt and approval, although often payment is made more quickly as transactions are batched with other grantees who have recently completed milestones. If you are having any issues accepting stars through [Bridge](https://bridge.urbit.org) please contact `~taller-ravnut` for assistance.

38+We approve and issue payments within 30 days of invoice receipt and approval, although often payment is made more quickly. If you have any questions regarding getting paid or submitting an invoice, please contact `~marfun-pacpet` for assistance.

content/articles/2023-02-20_trailblazing-urbit-startup-makes-earth-shaking-acquisition.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Trailblazing Urbit Startup Makes Earth Shaking Acquisition"

3+publication = "Globe Newswire"

4+author = "Globe Newswire"

5+date = "2023-02-20"

6+URL = "https://www.globenewswire.com/en/news-release/2023/02/20/2611391/0/en/Trailblazing-Urbit-Startup-Makes-Earth-Shaking-Acquisition.html"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/articles/globe-newswire.jpeg"

8++++

9+

10+Holium Corp closes $2.9 million in seed funding and acquires Third Earth in record pace.

content/articles/2023-05-10_urbit-a-network-older-and-weirder-than-bitcoin.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Urbit, a Network Older and Weirder Than Bitcoin, Finally Turns Toward Growth"

3+publication = "Coindesk"

4+author = "Bradley Keoun"

5+date = "2023-05-10"

6+URL = "https://www.coindesk.com/tech/2023/05/10/urbit-a-network-older-and-weirder-than-bitcoin-finally-turns-toward-growth/"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/articles/coindesk.jpg"

8++++

9+

10+The peer-to-peer network started in 2002 says it's taking on "MEGACORP," much in the same vein as many blockchain networks. A bit more fun are the "secret code names" that users are assigned.

content/blog/aesthetic-culture-1.md+1−1

@@ -5,7 +5,7 @@ date = "2020-11-11"

5

6[extra]

7description = "One of the most exciting things about Urbit is the aesthetic and design around it, developed partly by Tlon (through the design of Urbit itself) and partly by the community (by producing great Urbit art)."

8−author = "Nikolai Mallett"

8+author = "~nartes-fasrum"

9ship = "~nartes-fasrum"

10image = "https://media.urbit.org/site/posts/essays/help-the-environment.jpg"

11+++

content/blog/ares.mdnew file+51

@@ -0,0 +1,51 @@

1++++

2+title = "Ares"

3+date = "2023-06-26"

4+description = "A light technical description of Ares, the new Urbit runtime"

5+

6+[extra]

7+author = "Noah Kumin"

8+ship = "~librex-dozryc"

9+image = "https://storage.googleapis.com/media.urbit.org/blog/ares-header.png"

10++++

11+

12+![Image](https://storage.googleapis.com/media.urbit.org/blog/ares-header.png)

13+

14+## What is Ares?

15+

16+Ares is a new Urbit runtime that will be much faster and manage a much larger amount of data than previous versions of the runtime. Those new to Urbit commonly ask if they will be able to host photos and videos on their Urbit ships. Ares—a joint project from the Urbit Foundation, Tlon, and Zorp—sets the stage for us to be able to answer, simply, “Yes.” Ares is still a work in progress, but we expect to see the new binaries rolled out later this year. There are three components to the project. Let’s talk about them one by one.

17+

18+## 1. Code Generation

19+

20+Modern CPUs are extraordinarily fast. But until now your Urbit hasn’t been able to take full advantage of this fact. One way to conceptualize the problem is to imagine a train that is only able to go as fast as a track-worker can lay down track for it. In this analogy, your CPU is the train, and the track-worker is the Urbit runtime. The aim is to have large sections of track laid down ahead of time. Ares includes a codegen system that compiles Nock, Urbit’s assembly language, to machine code that the CPU can predict well.

21+

22+This system addresses what has until now been a problem: Nock is meant to invoke other code in a given Urbit computer’s “subject.” Or, in more common parlance, in the computer’s “state.” Your state changes with every new message your Urbit computer sends and receives, or with any new event in any app. That makes it hard to make the resulting machine code run fast, since the CPU needs to read from the subject while it’s running in order to figure out what machine code will be run next.

23+

24+The new code generation process in Ares solves this problem by using a system which the developers have called “subject knowledge analysis.” What does this mean? By analyzing how an Urbit subject might change over the course of a Nock computation, Ares will learn about the subject's tree shape and about its data dependencies (*i.e.*, the way that later parts of the computation depend on earlier parts of the computation). This allows those parts of the subject which are known at the time of compiling Nock to machine code to remain known at later points in the computation.

25+

26+To go back to our metaphor of train tracks, this is what allows the “track” to be laid down ahead of time. This set of known parts of the subject typically includes Nock formulas stored in [cores](https://developers.urbit.org/guides/core/hoon-school/F-cores#cores). This allows the resulting machine code to use direct jumps to perform Nock function calls. Without this “subject knowledge analysis,” the CPU would have had to perform an “indirect jump” by calculating the location to which a later instruction would jump. Now your computer’s CPU can jump directly to where it’s supposed to go.

27+

28+## 2. 2stackz Noun Allocator

29+

30+Ares will make use of what we’re calling the *2stackz noun allocator*. With the advent of Ares, your Urbit will be a virtual machine with two stacks and no heap. What does this mean? Traditionally, a program has a *stack* and a *heap*. The stack is a linear data structure within a program used for the program’s execution. The heap is a less structured region of memory that is used for storing large pieces of data or data that you want to keep around for a while without taking up space in the stack. However, the heap is slower, because its system for allocating memory is less orderly. (Imagine, say, trying to find a specific pair of socks in a heap of clothing.)

31+

32+Ares recognizes that because Nock is much more constrained than most languages, the Urbit runtime doesn’t actually need a heap. Instead you can take the function call stack and split it in two. The top of either stack can then be used as a little temporary heap. Whenever a function executes, you copy the data that gets returned from one stack to the other. And all the intermediate products that get created when running that function (*i.e.*, other functions that got called by the initial function) sit there as *garbage* (unwanted or unused data) in between the two stacks. But you don’t have to do the same sort of bookkeeping—tracking and updating these values—that you would have to do with a heap.

33+

34+Every piece of data in your Urbit computer is a noun. A noun is an atom (a positive integer or zero) or a cell (a pair of nouns). Before Ares, both allocating and freeing a noun in the Urbit runtime were processes that took a lot of time. (To *allocate* a noun is to put that noun in memory and to *free* it is to tell your urbit that you don’t need it any more.) Ares should make both of these processes much faster. This is good news because the Urbit runtime allocates nouns (particularly pairs of nouns, known as cells) like nobody’s business.

35+

36+## 3. Persistent Memory Arena

37+

38+Ares’s Persistent Memory Arena is for managing large amounts of data within your urbit in such a way that your urbit does not get slow. If you have terabytes of data within your Urbit, you can only have a very small subset of that within your hardware’s RAM at a given time. The rest of that data is going to have to live on disk—the section of your hardware that is more capacious but takes more time to access.

39+

40+To deal with this fact, your motherboard moves data back and forth between RAM and disk depending on what data needs to be accessed at a given time. This is known as *paging*, because it does so one *page* (usually four kilobytes) at a time. Traditionally operating systems will handle paging for you, but they do it in a generic way. The Persistent Memory Arena is designed specifically for managing Urbit's single-level store.

41+

42+A *single-level store* means that there’s no distinction in the operating system between data that lives in RAM and data that lives on disk. Instead of having two levels from which you can access data, you only have one, and the system itself manages which parts of the data are in RAM and which are in disk. The Persistent Memory Arena is an optimization for handling a large amount of data in a single level store. It is for nouns that persist between computations. Using the PMA, your urbit’s state can grow large without being hemmed in by the limitations of your hardware’s RAM.

43+

44+

45+## Updates and Links

46+

47+You can find the Ares GitHub repository [here](https://github.com/urbit/ares). The technical proposal is [here](https://github.com/urbit/ares/blob/status/docs/proposal/proposal-nock-performance.md). Check back at the Urbit Google Groups [listserv](https://groups.google.com/a/urbit.org/g/dev/), the [@zodisok](https://twitter.com/zodisok) Twitter account, and the Urbit Foundation [group](https://tlon.network/lure/~halbex-palheb/uf-public) for updates about the upcoming release.

48+

49+–

50+

51+*Noah Kumin is the founder and editor in chief of the [Mars Review of Books](https://marsreview.org/).*

content/blog/foss-1.mdnew file+64

@@ -0,0 +1,64 @@

1++++

2+title = "Urbit's Open Source Culture, Part I"

3+date = "2023-05-31"

4+description = "How did Urbit cultivate a unique open source software culture? Let's take a look at how we got to where we are today."

5+

6+[extra]

7+author = "N E Davis"

8+ship = "~lagrev-nocfep"

9+image = "https://upload.wikimedia.org/wikipedia/commons/a/a9/SR71_factoryfloor_SkunkWorks.jpg"

10++++

11+

12+![](https://upload.wikimedia.org/wikipedia/commons/a/a9/SR71_factoryfloor_SkunkWorks.jpg)

13+

14+> “Open source is an intellectual property destroyer. I can't imagine something that could be worse than this for the software business and the intellectual-property business.” (Jim Allchin, Microsoft executive)

15+

16+A founder's personal enquiry into the foundations of practical computing grew into a skunkworks startup to build an alternative basis for principled computing, and has now evolved into a burgeoning open source platform and community.

17+

18+- [Moron Lab, “Maxwell's equations of software (Nock)” (~2010.1.9)](https://moronlab.blogspot.com/2010/01/nock-maxwells-equations-of-software.html)

19+- [Moron Lab, “Urbit: functional programming from scratch” (~2010.1.13)](https://moronlab.blogspot.com/2010/01/urbit-functional-programming-from.html)

20+

21+How did Urbit cultivate a unique open source software culture? Let's take a look at how we got to where we are today.

22+

23+Open source culture really got going in the 1980s with the restrictive Unix licensing scheme and the consequent publication of the GNU software tools. With the marriage of GNU to Linux ([“I'd like to interject for a moment”](https://copypastatext.com/id-just-like-to-interject-for-a-moment/)), a full stack, from the bare metal to the end user, was possible. Usenet and early Internet forums furthermore encouraged interested developers to start contributing actively.

24+

25+The ethos of open source software drew on a number of sources, from William Gibson's _Neuromancer_ trilogy to “A Cypherpunk's Manifesto.” Those involved were often motivated by a healthy distrust of proprietary software. The big break for open source software (OSS) came with the [Unix ownership lawsuits](https://en.wikipedia.org/wiki/Unix_wars), which gave GNU/Linux a chance to break into the bigtime for systems software. The [2001 case against Microsoft](https://en.wikipedia.org/wiki/United_States_v._Microsoft_Corp.) as a monopoly lent further credence to the open source mandate.

26+

27+During this time, Urbit began life as a personal dissertation, in a sense, to derive a minimalist practical set of computing expressions as a combinator calculus. The early concepts that became part of Urbit, such as kelvin versioning and Maxwellian code, show up during its first decade. Nock was not open source for two reasons: the founder's conviction that as software it was already public domain, and the fact that there was no one yet to collaborate with.

28+

29+It was about a decade before Tlon was started as a small bespoke programming house to work on the esoteric project of defining something usable on top of the minimalist Nock specification. No one knew about Urbit besides some blog readers, and unless you worked in or next to Tlon you had basically zero chance of following the project via software alone.

30+

31+Early Tlon did a fairly good job of putting their software out there, but the documentation and nomenclature were considered obscurantist and the project was described as performance art or a deliberate wild goose chase. These combined to make Urbit appear fairly opaque, despite open development using GitHub and the liberal MIT license. System components like Nock and Arvo were declared public domain or liberally licensed.

32+

33+To this point (let's say 2019), Urbit was by license and by code an open source project, but had a reputation for being basically impossible for an outsider, even one with a fair amount of coding experience, to really figure out what's going on without serious handholding from the core devs. (Nor is this inappropriate for a small startup at this stage—it simply is the way most nominally OSS projects function.) However, the mystery engaged others beyond Tlon to brave the wilds and figure out what this Urbit project was all about.

34+

35+Urbit’s goal has always been to produce a stable kernel for all time, referred to by a metaphor of losing heat energy and entropy. As Urbit gradually cooled from red hot slag to what we'll call a developer alpha, Tlon began a project of greater outreach to the developer community. In particular, crypto software developers saw attractive aspects in Nock's concision and apparent provability and in Urbit's functional-as-in-math approach to operating system and application state. Tlon started a Discord for onboarding and troubleshooting, including community concierges who were tasked with engaging anyone with ship troubles. This tapped into and fostered a culture of Urbiters aggressively helping others debug and troubleshoot their ships, which continues to this day. Tlon also began Hoon 101 to teach outsiders how to actually build things on Urbit.

36+

37+As Urbit slowly grew into a larger developer community, some hard strategic questions about project scope and direction came into focus. There had always been a provision for Urbit to have some sort of foundation with stewardship over the project—either the Urbit Educational Foundation or something similar. Like the Linux Foundation, this organization would serve to coordinate activity between various companies and individuals contributing to the Urbit project. The foundation would receive an endowment of galaxies earmarked to fund Urbit's development.

38+

39+Urbit's use of address space to fund development means that the builders, even those who have discovered Urbit relatively recently, are able to acquire a significant stake in the project and its success.

40+

41+In practical terms, Tlon started the Urbit Foundation internally first as `urbit.org`, then rolled it out as a standalone company with a mandate to first build itself into a viable cultivator of Urbit, then to take over Urbit core development. By early 2023, the Urbit Foundation was in a position to take over core development for the platform.

42+

43+There have been several aspects of this journey that have led Urbit to have a thriving and promising open source software culture:

44+

45+1. Urbit's nature as a functional operating system has a deep appeal to software developers and others who find appeal in a mathematically elegant system, including the guarantees made by innovations such as the scry namespace bindings and the public key infrastructure.

46+2. Hoon is a mood. What I mean by that is that Hoon's unique aesthetics, subject-oriented paradigm, and the utility of cores give coders a unique experience, like systems programming in APL would feel like.

47+3. The developer docs are finally prioritized and made publicly legible. Large swaths of the operating system and standard library are finally documented.

48+4. Third-party software distribution is made trivial. Decentralized peer-to-peer open source software distribution without having to go through a GitHub intermediary changes the game.

49+5. Urbit's educational program expands from Tlon's initial offerings to a community program (Hooniverse/Hooniversity), then to a dedicated program with specific course milestones under the auspices of the Urbit Foundation.

50+6. Urbiters start meeting in person at Assembly and other events. After the 2020 efflorescence of the Urbit community, this is the first time most of the newer people were able to meet in real life. (This is a substantially different situation than the pre-2019 Urbit environment—most people didn't know Tlonners first, they knew Urbit first and mainly online.)

51+7. Three major active groups form dedicated to all-purpose coding on Urbit:

52+ A. Hooniverse, ~hiddev-dannut/new-hooniverse, originally strictly for the community Hoon School but now for all of the UF's educational efforts.

53+ B. The Forge, ~middev/the-forge, for advanced technical discussion.

54+ C. `[battery payload]`, ~dister-dozzod-lapdeg/battery-payload, the UF's developer community group.

55+8. The Urbit Foundation begins an active grants program. At first focusing on userspace and cultural grants, this eventually leans back into kernel work.

56+9. As the Urbit Foundation takes over core development, this necessitates changing that process from being a one-company project to requiring coordination, said coordination being much easier in the open than in closed meetings. (This also enables Tlon to focus on product delivery over core development.)

57+10. The Urbit Foundation begins using a `gather.town` “Urbit Hacker House,” which puts people together for synchronous interrupts. Any community member can wander in and be a fly on the wall or an active interlocutor.

58+ A. This enables the UF to start hosting daily pull request triage and a rapid assignment of tasks in the open.

59+ B. Communications strategy meetings are also public.

60+ C. Build parties (originally conceived as app-in-a-day) demonstrate pair programming, achieve inter-programmer communication of information akin to IRL programming, and allow anyone to participate.

61+

62+We find ourselves, as Urbit developers, having grown together a strong and unique culture of open source software development verging on radical transparency. It's not just code and license being open—it's the entire ensemble of programmer culture and on-platform dogfooding (to the extent possible). The greybeards and the noobs encounter each other directly and openly all the time, in `gather.town` and in Urbit groups.

63+

64+From modest beginnings, Urbit has achieved some small traction in the world and grown an exemplary open source culture. What will it take for Urbit to succeed in the future? That's the next entry.

content/blog/foss-2.mdnew file+59

@@ -0,0 +1,59 @@

1++++

2+title = "Urbit's Open Source Culture, Part II"

3+date = "2023-06-13"

4+description = "How will Urbit continue to foster its innovative open source software culture?"

5+

6+[extra]

7+author = "N E Davis"

8+ship = "~lagrev-nocfep"

9+image = "https://spacecenter.org/wp-content/uploads/2023/02/img-apollo-mission-control-3.jpg"

10++++

11+

12+![](https://spacecenter.org/wp-content/uploads/2023/02/img-apollo-mission-control-3.jpg)

13+

14+> God watches over fools, drunks, and the United States of America. (Otto von Bismarck, apocryphal)

15+

16+In our last installment, we considered how Urbit has grown its own robust open source culture. Now we look to the future: what will it take for Urbit to succeed, not only as an exemplary open source project but as a computing platform that delivers on its promise?

17+

18+Part of what makes an open source culture vibe is remix culture, the ability to rework the source material to produce novel components or manifestations. Urbit has the raw materials for this in spades, memetically and technically. It is up to us to keep these tools in our developers’ and enthusiasts’ hands.

19+

20+The default answer, which isn't terrible, is that Urbit should keep doing what it's done to get this far:

21+

22+1. Urbit should continue to prioritize decentralized development.

23+2. Urbit should lean into ownership-based incentives. Indeed, this is the most effective lever that the Urbit Foundation has.

24+3. Urbit should maintain the developer's republic. Core developers should rub shoulders with first-time Hooners.

25+4. Urbit should continue to ship source with code, since that is how code is actually distributed. The means of open source software are _necessarily in the user's hands_ with Martian software.

26+

27+There are some areas in which we hope to improve. Our documentation continues to expand, as do our educational offerings. We have a mandate to use the Urbit Foundation’s endowment of stars to produce the mature Urbit.

28+

29+What else should we have an eye to in the near future? There’s always more to do, but by prioritizing the items on this short list we would continue to elaborate our open source bona fides as a community and a steering foundation.

30+

31+1. **Code accessibility should be a priority.** Any computer language falls on the spectrum between machine legibility (the pole of machine code and assembly language) and human legibility (the pole of [Scratch](https://scratch.mit.edu/). All code must walk this line.

32+

33+ Hoon has had a reputation for being a language of dense expressions, which we believe is now being cleared by sunshine. However, Hoon's extensive sugar syntax and irregular expressiveness can make it challenging for those relatively new to Hoon to decipher programs. We can support their learning and entry into the ecosystem by defining a subset of Hoon syntax that we adhere to in all of the docs and some of the userspace code. Even if there is a "better" way to write it, we should prefer this restricted discipline in those cases. Let's call this subset "Hoon Prime." Hoon Prime will not always be the most concise Hoon code, and it will likely fail to maintain certain well-established preferences, like heavier expressions going to the bottom, but it should encourage developers to produce generators and agents from `%base`-distributed models as quickly as possible.

34+

35+ Hoon Prime should also adopt a standard of literate programming. Several example files already display such a self-documenting nature:

36+

37+ - [`simple.hoon` for solid-state subscriptions](https://github.com/wicrum-wicrun/sss/blob/master/urbit/app/simple.hoon)

38+ - [`deco.hoon` for doccords](https://github.com/urbit/urbit/blob/develop/pkg/arvo/lib/deco.hoon)

39+ - [`pals.hoon`](https://github.com/Fang-/suite/blob/master/app/pals.hoon)

40+ - [`rudder.hoon` for serving websites](https://github.com/Fang-/suite/blob/master/lib/rudder.hoon)

41+

42+ Our userspace code accessibility model should allow contributors from widely different skill levels to interact. We need to surface and document code patterns as cleanly as possible in the code we distribute. We need to include comments and unit tests so people can see how and why code works like it does.

43+

44+ Code accessibility cannot be an afterthought. We need to upgrade as much code as possible to A standards [per the style guide](https://developers.urbit.org/reference/hoon/style#grading).

45+

46+2. We need to improve the developer experience. Part of this involves better coding support, and part of this involves better debugging support.

47+

48+ To promote better coding, we should continue to develop IDE integrations like the Hoon Language Server. We've had some significant wins here, but rust never sleeps. We should also continue to produce userspace and middleware support libraries. We need to pay attention to how developer preferences are manifesting in their workflows and tooling.

49+

50+ Better error messaging and debugging support, perhaps even a framework for line-by-line code execution, would be invaluable. Upgrading Dojo and generator support is an easy win. Any tool friction is a sin and we need to track this and think about how to improve use.

51+

52+3. We need our open source culture to continue to develop in the sunlight. We need to highlight and communicate user stories for developer tools, new and old. We need to share these from inside of companies in the ecosystem. I'm not going to call for “best practices”—it's too early and that's too corporate—but tacit knowledge and horizontal skill transfer need to be encouraged through active pair programming and utilization of build parties and the like.

53+

54+ We need to expose how bugs occur, propagate, and are corrected. The core development team has committed to public [postmortems](https://github.com/urbit/urbit/issues/6583) when things go wrong.

55+

56+4. Ultimately, Urbit has to stay playful. Urbit makes programming, even systems programming, a lot of fun. Fun is open-ended and surprising. It allows for whimsy in code and product.

57+

58+Our developer onboarding and open source culture should be a model for the entire open source world. This is neither impossible nor impractical—we've made huge strides in legibility, and we're sailing with the wind.

59+

content/blog/hoon-4-lispers.mdnew file+764

@@ -0,0 +1,764 @@

1++++

2+title = "A Perspective on Lisp and Hoon"

3+date = "2023-06-15"

4+description = "Lisp is an éminence grise of programming. How does Hoon compare?"

5+

6+[extra]

7+author = "N E Davis"

8+ship = "~lagrev-nocfep"

9+image = "https://engineering.stanford.edu/sites/default/files/styles/card_1900x950/public/images/news/john_mccarthy.jpeg?h=3751da6c&itok=6tPSih53"

10++++

11+

12+![John McCarthy, inventor of Lisp, at Stanford.](https://engineering.stanford.edu/sites/default/files/styles/card_1900x950/public/images/news/john_mccarthy.jpeg?h=3751da6c&itok=6tPSih53)

13+

14+> In the beginning, von Neumann created the machine. And the machine was with rigorous form and code, and no compiler yet moved upon the face of the tubes. And the evening and the morning were the first day.

15+>

16+> And John Backus said, Let there be FORTRAN, and there was Fortran. And Fortran ruled over the assembly.

17+>

18+> And John McCarthy saw the lambda calculus, that it was very good. And McCarthy made the LISP and divided the programmers who were for the array from the programmers who were for the list.

19+>

20+> And the Fortran and the Lisp were the second day. And God set them in the firmament to give light upon the earth.

21+

22+Two great temperaments of programming language design span these poles: Fortran as the engineer of assembler-first hard-nosed array coding and Lisp as the math professor running down to the machine room waving papers. While they have ceded some to the practicalities of the other over time, each is a trope of a particular computing paradigm. In this article, we will examine the Lisp pole in light of Urbit's development language, Hoon.

23+

24+Hoon is a statically typed functional programming language that is designed to be safe, efficient, and expressive. Hoon has a unique syntax relying heavily on symbolic expressions (using “runes”) rather than traditional keywords and operators. Hoon's underlying execution language, Nock, has been described as a “pico-Lisp“, making reference to its nature as a cell-based combinator calculus. Both languages (Nock and Hoon) follow very much in the philosophical steps of Lisp but seek to improve the genre.

25+

26+Lisp is known for its powerful macro system, which allows developers to write code that generates more code at compile time, and for its powerful `eval` function; while Hoon provides a flexible metaprogramming system that allows developers to manipulate code at compile time and hot-swap code at runtime.

27+

28+This article will contrast classical Lisp syntax and assumptions with Hoon's design. As Lisp is a family of languages rather than a single implementation, I will strive to make generally applicable statements or qualify the discussion—I welcome nuance in your responses about the different major Lisp dialects.

29+

30+Hoon's characteristic structure has arisen from these overarching design principles:

31+

32+1. Hoon must compile to Nock, and benefits from reflecting Nock's calculational worldview.

33+2. Hoon must be capable of live upgrades; that is, conscious brain surgery on itself.

34+3. Hoon should grow organically based on actual developer usage patterns.

35+

36+Our investigation of Lisp and Hoon will compare their syntax, their metaprogramming affordances, and their underlying philosophies.

37+

38+

39+## Syntax

40+

41+Hoon has many commonalities with Lisp and its most common calling convention is sugared to appear like Lisp. The conventions of Nock differ—e.g. using `[]` brackets instead of `()` parentheses—and Nock does not have non-numeric tokens or names. Hoon serves as a more human-friendly syntax which mediates common expressions and structures much as C overlays assembly language. For practical purposes, we never need to write Nock code by hand, and so while Nock informs Hoon's design choices, we don't need to understand any Nock to talk about Hoon.

42+

43+Both Lisp and Hoon are homoiconic, meaning that code and data are directly represented the same way: Lisp code is represented as Lisp data structures, and Hoon code is represented as Hoon data structures. Homoiconicity means that code can be manipulated and transformed as data at runtime. While the most compelling investigation in this article focuses on metaprogramming, we need to start with a comparative syntax and grammar so we understand how code and data are represented.

44+

45+Before all of that, let us compare a simple program implemented in both Lisp and Hoon. Both programming languages are species of functional languages for which expressions result in values, but they handle side effects differently: in Hoon side effects are strictly impossible (although a runtime workaround permits I/O and necessary effects), while in Lisp side effects are permitted (although opinions on their use vary). We will therefore not use a trivial “Hello World” example. Instead we will calculate the arithmetic mean of a set of numbers of known size.

46+

47+```scheme

48+(define (mean a)

49+ (if (null? a)

50+ 0

51+ (/ (apply + a) (length a))))

52+```

53+

54+```hoon

55+:: Common (sugared) form

56+++ mean

57+ |= a=(list @ud)

58+ ?~ a 0

59+ (div (roll a add) (lent a))

60+

61+:: Rune (unsugared) form

62+++ mean

63+ |= a=(list @ud)

64+ ?~ a 0

65+ %+ div

66+ %- roll [a add]

67+ %- lent a

68+```

69+

70+The Scheme code has the advantage that it reads almost English-like as one works through the logic, but implicitly relies on familiarity with the `if`/`then`/`else` structure and function application using `()` (on which more soon).

71+

72+The Hoon code uses the `%` function application runes (differentiated by number of arguments) to apply the function calls. With syntactic sugar, this looks similar to the Lisp call, with `++roll` instead of `apply` and `++lent` instead of `length`.

73+

74+Throughout I will use code examples for Lisp taken from [Rosetta Code](https://rosettacode.org/wiki/Category:Scheme). I will select or compose Hoon examples to be structurally similar to the Lisp code in order to facilitate comparison. I will also avoid sugar syntax that would obscure the structure of the Hoon code; in some cases this will make it slightly less readable than its equivalent in practice.

75+

76+### Syntax in Lisp

77+

78+#### Types

79+

80+Lisp types are dynamic, checked at runtime rather than on compilation. Since everything is an object, some assumptions can be made about manipulation and behavior. Most Lisp dialects share these types:

81+

82+- Numbers, including integers and floating-point numbers.

83+- Characters.

84+- Strings, as a sequence of characters.

85+- Lists, as a sequence of objects (including lists).

86+- Symbols, names used to refer to a function, variable, or other object.

87+- Arrays, a fixed-size multidimensional indexed object collection.

88+

89+Lisp code, being dynamically typed, is inclined to try a value and see if it works in a given context. However, some restrictions can be made, such as an argument type declaration on a function:

90+

91+```lisp

92+(defun add-two-integers (x y)

93+ (declare (type integer x y))

94+ (+ x y))

95+```

96+

97+Lisp types are to some extent (justly) influenced by the underlying platform architecture: Lisp is generally compiled directly to machine code (like a C program), with the notable exception of [Clojure](https://clojure.org/reference/lisps) which runs on the Java Virtual Machine.

98+

99+#### Operators, Functions, Macros, and Thunks

100+

101+Lisp syntax is characterized by its use of nested lists, called S-expressions (symbolic expressions), which consist of parentheses enclosing atoms or other S-expressions. The basic structure of an S-expression is an operator (or function) followed by its arguments, all enclosed in parentheses. For example, the following S-expression performs a simple arithmetic operation:

102+

103+```lisp

104+(+ 1 2 3)

105+```

106+

107+Lisp uses prefix notation, where the operator comes before the operands, and parentheses are used to group expressions. The S-expression is evaluated from left to right (in most Lisps save Scheme), with the operator being applied to its arguments.

108+

109+Operators in Lisp operate on values of different basic types. Lisp dialects vary in their particular base types, but typically include numbers, strings, booleans, and so forth. The core data type is the list, of course (LISP is for LISt Processing). Since Lisp biases towards list processing, many operators are comfortable receiving an arbitrary number of values as inputs, as in the code sample above.

110+

111+In Lisp, [`cons`](https://en.wikipedia.org/wiki/Cons) describes the procedure to construct a pair of objects. This seemingly modest capability is fundamental to how Lisp builds lists—and since everything is a list, `cons` has consequences. One fundamental convention is the `cons` cell, which consists of two other Lisp objects and is how lists are actually constructed.

112+

113+![](https://upload.wikimedia.org/wikipedia/commons/thumb/1/1b/Cons-cells.svg/450px-Cons-cells.svg.png)

114+

115+Lisp operations are built either as functions or as macros. Functions produce results directly from their inputs. Macros by contrast are basically function-building functions, and produce expressions that can be evaluated with inputs to get a result.

116+

117+A Lisp function is created using `defun`:

118+

119+```lisp

120+> (defun square (x) (* x x))

121+SQUARE

122+

123+> (square 2)

124+4

125+```

126+

127+(Lisp dialects tend to not be case-sensitive.)

128+

129+Lisp functions are first-class objects and can be manipulated and passed like values of basic types as well.

130+

131+Before we can look at macros, we need to consider Lisp's notion of evaluation and in particular deferred evaluation. For Lisp, an expression can be marked as a literal value rather than evaluated to produce a result. The quote `'` symbol is used to mark expressions for prevented evaluation:

132+

133+```lisp

134+'(1 2 3) ; evaluates to the list (1 2 3)

135+'foo ; evaluates to the symbol FOO

136+(1 5) ; evaluates to the list (1 5)

137+'(1 (+ 2 3)) ; evaluates to the list (1 (+ 2 3))

138+```

139+

140+Backtic or backquote `` ` `` allows you to switch an expression in and out of evaluation mode, along with `,` to mark evaluated components for splicing back into the unevaluated expression.

141+

142+```lisp

143+`(1 2 3) ; evaluates to the list (1 2 3)

144+`foo ; evaluates to the symbol FOO

145+`(1 ,(+ 2 3)) ; evaluates to the list (1 5)

146+```

147+

148+A Lisp macro is essentially a compile-time function.

149+

150+```lisp

151+> (defmacro square (x)

152+ "Returns the square of the input value."

153+ `(* ,x ,x))

154+

155+> (square 2)

156+4

157+```

158+

159+(The `` ` `` notation constructs the expression with values spliced in by `,`.)

160+

161+A deferred evaluation, called a thunk, is a closure that inherits its lexical environment but is deferred for later computation. Thunks enable lazy code evaluation and separate the computation’s definition from its execution.

162+

163+```lisp

164+(defun create-thunk (function &rest arguments)

165+ (lambda () (apply function arguments)))

166+

167+(defun invoke-thunk (thunk)

168+ (funcall thunk))

169+

170+;; Creating a thunk that calculates the factorial of a number

171+(defvar factorial-thunk (create-thunk #'(lambda () (factorial 5))))

172+

173+;; Invoking the thunk to get the result

174+(print (invoke-thunk factorial-thunk)) ; Output: 120

175+```

176+

177+In this code example, `create-thunk` accepts a function and returns a thunk created using a lambda function to encapsulate the computation. `invoke-thunk` is used to invoke the thunk to get the actual result. The actual application creates a deferred factorial implementation and then finally invokes it. Without the last line, the actual calculation would never be executed.

178+

179+As Paul Graham wrote, “The unusual thing about Lisp-- in fact, the defining quality of Lisp-- is that it can be written in itself.” A Lisp program is an S-expression, and in principle we can run the equation the other way: certain S-expressions are valid Lisp programs. Although uncommon in practice due to code safety issues, the `eval` function is illustrative of Lisps’ ability to evaluate a Lisp expression that is represented as a data structure. It takes a single argument, which is a Lisp expression, and returns the value of that expression. Lisp programs can in principle generate new code—or modify existing code—and evaluate it on the fly, since code is data.

180+

181+```lisp

182+(defvar x 10)

183+(defvar y 20)

184+(defvar z '(+ x y))

185+

186+(eval z)

187+```

188+

189+Besides explicitly named functions and macros, Lisp frequently employs lambda expressions to produce functions on demand at the point of use.

190+

191+```lisp

192+> ((lambda (x y) (+ x y)) 5 10)

193+15

194+```

195+

196+Naturally, we have not covered all of Lisp, but the above should motivate how Hoon differs from Lisp. Furthermore, Lisp is really a family of languages, so there is a fair amount of variation in specifics.

197+

198+- [Paul Graham, _On Lisp_](http://www.paulgraham.com/onlisptext.html)

199+

200+### Syntax in Hoon

201+

202+#### Types

203+

204+Hoon compiles to Nock and runs on a Nock virtual machine interpreter. Nock knows only about nouns, that is to say either simple unsigned integers or pairs of other nouns.

205+

206+> To be exact, a noun is an S-expression, except that classic S-expressions have multiple atom types ("S" is for "symbol"). Since Nock is designed to be used with a higher-level type system (such as Hoon's), it does not need low-level types. An atom is just an unsigned integer of any size.

207+

208+

209+One of the biggest differences between Hoon and Lisp lies in their respective type systems: Hoon is statically typed while Lisp is dynamically typed. Furthermore, since Hoon compiles to Nock, ultimately every value, expression, and program in Hoon results in a noun (an atom or unsigned integer, or a cell or pair of nouns). (The compiler may make this process slightly opaque, but it is deterministic.) Types, if values are known, must match or nest properly at compile time.

210+

211+Hoon implements types as a metadata layer over bare Nock numbers and atoms. (The implementation details do not concern us but can be seen using the `!,` zapcom rune, which produces the abstract syntax tree of an expression.) Hoon atom types include various numeric types (signed and unsigned, hexadecimal, binary, etc.); address space identifiers (such as ~zod); IP addresses; UTF-8 text; and floating-point values, [among many others](https://developers.urbit.org/blog/literals). As these are interpretations laid over the bare integer, it is trivial to convert among them, a convenience like C affords.

212+

213+```hoon

214+:: raw unsigned decimal integer

215+> 123

216+123

217+

218+:: hexadecimal integer

219+> `@ux`123

220+0x7b

221+

222+:: UTF-8 text

223+> `@t`123

224+'{'

225+

226+:: relative datetime (a small fraction of a second)

227+> `@dr`123

228+~s0..0000.0000.0000.007b

229+

230+:: address mnemonic (ship name)

231+> `@p`123

232+~rux

233+

234+:: IPv4 address

235+> `@if`123

236+.0.0.0.123

237+

238+:: IPv6 address

239+> `@is`123

240+.0.0.0.0.0.0.0.7b

241+```

242+

243+A cell is a pair of two nouns, and of course many compound types exist, including lists (a null-terminated series of cells). A file path in Urbit is, for instance, a list of resource names (a `path`). A manipulable text string is a list of single bytes for characters (a `tape`). Maps (associative arrays), sets, and other containers round out the basic data structure types, but more complex types such as HTTP headers and app metadata are available. Even app actions have an associated type so that the set of actions is enumerable and validated. Here, for instance, are some cryptographic types from the standard library:

244+

245+```hoon

246++$ jacobian [x=@ y=@ z=@] :: jacobian point

247++$ point [x=@ y=@] :: curve point

248++$ domain

249+ $: p=@ :: prime modulo

250+ a=@ :: y^2=x^3+ax+b

251+ b=@ ::

252+ g=point :: base point

253+ n=@ :: prime order of g

254+ ==

255+```

256+

257+Hoon expressions are ultimately binary trees of cells and atoms—Hoon is homoiconic and so code is directly represented as a data structure which can be interpreted as a value as well. This facilitates Hoon's ability to upgrade itself in place, as we will see.

258+

259+Hoon commonly implements types structurally via _molds_, or functions which coerce to type or crash. A mold is a way of asserting known type information over a value, typically at compile time, in a way that allows for data transformation and data validation. This leads to some interesting cases such as the difference between a null-terminated tuple and a true list, which some functions require.

260+

261+```hoon

262+> ~[1 2 3]

263+[1 2 3 ~]

264+

265+> `(list @)`~[1 2 3]

266+~[1 2 3]

267+

268+> (snag 2 ~[1 2 3])

269+mull-grow

270+-need.[i=@ud t=%~]

271+-have.%~

272+nest-fail

273+dojo: hoon expression failed

274+

275+> (snag 2 `(list @)`~[1 2 3])

276+3

277+```

278+

279+Hoon implements a unique character literal syntax for every single atom type, allowing any value to be unambiguously interpreted by the parser per the developer's intent. You can see this somewhat in evidence in this comparison chart:

280+

281+| Type | Lisp Type | Hoon Type |

282+| --- | --- | --- |

283+| (Unsigned) integer | `1` | `1` |

284+| Signed integer | `-1`, `1` | `-1`, `--1` |

285+| Symbol | `x` | `%x` |

286+| Real/FP | `1.5` | `.1.5` |

287+| Character | `#\c` | `'c'` |

288+| Text | `"Hello"` | `'Hello'` (as atom); `"Hello"` (as list) |

289+| Rational | `2/3` | (no Hoon equivalent) |

290+| Address | (no Lisp equivalent) | `~sampel-palnet` |

291+

292+Much of Hoon's practical power derives from how it represents and manipulates nouns as data and as code.

293+

294+> The type of type is just a normal datatype in Hoon, and a lot of the system manipulates types. In particular, the `!>` rune, when applied to a piece of data, uses compile-time type reflection to produce something called a "vase": a pair of type and data, similar to a `Data.Dynamic` in Haskell, or a limited form of a dependent pair. Since the Arvo kernel does a lot of dynamic compilation, it uses vases to implement something akin to a dynamically typed language using Hoon. This allows for type-safe dynamic program loading, program execution, and data migration. (Ted Blackman ~rovnys-ricfer, [“Why Hoon”](https://urbit.org/blog/why-hoon))

295+

296+A `vase` in Hoon is a cell of type and value. Typically `vase`s are produced with the `!>` zapgar rune. We use `vase`s to carry type information where otherwise it may be lost, such as in transmission over the wire to another Urbit instance.

297+

298+```hoon

299+> !>('hello')

300+[#t/@t q=478.560.413.032]

301+

302+> !>([5 10])

303+[#t/[@ud @ud] q=[5 10]]

304+

305+> !>(`(list @)`~[1 2 3])

306+[#t/it(@) q=[1 2 3 0]]

307+

308+> !>(`(list @)`~)

309+[#t/it(@) q=0]

310+```

311+

312+A `vase` can be used at runtime to resolve a value from a dynamic context into an executable Hoon expression, and this is commonly done with web-based input, for instance, where insufficient information will be available at compile time to resolve the type correctly.

313+

314+#### Expressions

315+

316+Nock explicitly consists of binary trees, since any Nock structure or program consists entirely of atoms (bare values) and cells (pairs of nouns).

317+

318+![](https://storage.googleapis.com/media.urbit.org/docs/userspace/hoon-school/binary-tree.png)

319+

320+Expressions are oriented around runes, which act as operators to join or manipulate expressions. To construct a cell of two values like `1` and `2`, one uses the `:-` cencol rune. (Hoon cells implement what we call an “implicit `cons`”, meaning that two nouns composed together are simply unified in a shared binary tree.)

321+

322+```

323+ :-

324+ / \

325+1 2

326+```

327+

328+To invoke a function named `add`, one can provide a `%-` cenhep rune with the function name and the arguments.

329+

330+```

331+ %-

332+ / \

333+add :-

334+ / \

335+ 1 2

336+```

337+

338+We write this Hoon expression one of two ways, either separated by whitespace or using parentheses:

339+

340+```

341+> %- add :- 1 2

342+3

343+

344+> %-(add :-(1 2))

345+3

346+```

347+

348+Hoon employs “sugar syntax” for many common code patterns to make them easier to write and (sometimes) to read. Since Hoon had the advantage of knowing about Lisp's syntax beforehand, the standard invocation syntax in Hoon (formally a `%` rune) uses the irregular `()`-based syntax like Lisp. In this case, we could instead write the Lisp-like expression:

349+

350+```hoon

351+> (add 1 2)

352+3

353+```

354+

355+which results in basically the same expression once the parser is done.

356+

357+(Although Hoon ultimately compiles to Nock, it is more natural in some ways to approach the syntax of a program as an array of $n$-ary trees, where each “slot” in an expression can have zero, one, or many children. Zero children refers to a tree address containing a terminal value like a symbol or an integer.)

358+

359+Rune syntax is Hoon's answer to the Lisp proliferation of parentheses—by restricting expressions to a definite number of children, Hoon avoids needing to explicitly terminate most expressions. In some ways, runes are an ASCII-based equivalent of APL's symbolic character operators.

360+

361+```apl

362+life ← {⊃1 ⍵ ∨.∧ 3 4 = +/ +⌿ ¯1 0 1 ∘.⊖ ¯1 0 1 ⌽¨ ⊂⍵}

363+```

364+

365+Rather than permit polymorphic language statements, Hoon requires each rune to be extremely tightly defined. While many statements may be functionally equivalent to an `if` or a `cond` statement, for instance, Hoon allows the developer to select a particular expressive rune if desired.

366+

367+- `?:` typical `if`/`then`/`else` branch

368+- `?=` branch on type

369+- `?@` branch if atom

370+- `?^` branch if cell

371+- `?+` switch on type with default

372+- `?-` switch on type without default

373+- `?~` branch if null

374+

375+The next examples explore an interesting difference between Lisp `cond` and Hoon `?+` wutlus swtich statements: Hoon switches over _types_ not _values_, and `term` symbols as constants are instances of self-matching types.)

376+

377+```scheme

378+(define (weather f)

379+ (cond ((> f 80) 'too-hot)

380+ ((> f 60) 'nice)

381+ ((< f 35) 'too-cold)

382+ (else 'typical-midwest)))

383+```

384+

385+```hoon

386+|%

387+++ weather

388+ |= f=@ud

389+ ?: (gth f 80) %too-hot

390+ ?: (gth f 60) %nice

391+ ?: (lth f 35) %too-cold

392+ %typical-midwest

393+++ symbol-to-message

394+ |= msg=term

395+ ?+ msg 'Typical Midwest'

396+ %too-hot

397+ 'Too hot outside'

398+ %nice

399+ 'Nice outside'

400+ %too-cold

401+ 'Too cold here'

402+ ==

403+--

404+```

405+

406+Lisp expects a program to be a running series of expressions, naturally composed together as a list. Hoon, in contrast, expects everything to be an evaluable expression (no implicit `progn`, for instance): thus, series of expressions must be composed together, e.g. using `=>` tisgar to concatenate two expressions.

407+

408+This code example defines an expression and immediately evaluates another expression against it:

409+

410+```hoon

411+=> [a=1 b=2 c=3]

412+::

413+b

414+```

415+

416+Hoon code is compiled to Nock, but it is not a simple macro over Nock—multiple Hoon expressions could result in an identical Nock expression, and the same Hoon expression evaluated against different subjects could result in different Nock expressions. Hoon code is parsed to an abstract syntax tree first, which includes type metadata, then compiled into the appropriate Nock statement. Here we use the `!,` zapcom rune to turn a Hoon expression into its AST, then `!=` zaptis to compile a Hoon expression to Nock.

417+

418+```hoon

419+> !,(*hoon `@ux`+(1))

420+[ %ktls

421+ p=[%sand p=%ux q=0]

422+ q=[%ktls p=[%sand p=%$ q=0] q=[%dtls p=[%sand p=%ud q=1]]]

423+]

424+

425+> !=(`@ux`+(1))

426+[4 1 1]

427+```

428+

429+Hoon has much more syntactic sugar than Lisp. Not only is the Lisp-like `()` execution convention sugar for `%:` cencol to invoke a function, there are in fact many ways to evaluate code expressions. Consider, for instance:

430+

431+| Rune | Usage |

432+|---|---|

433+| `%-` | Evaluate a function against a single noun. |

434+| `%+` | Evaluate a function against a cell (pair of nouns). |

435+| `%^` | Evaluate a function against a trio of nouns. |

436+| `%:` | Evaluate a function with many arguments ($n$-ary, unspecified number of nouns). |

437+| `%~` | Evaluate a higher-order function to produce a function. |

438+

439+This gives a Hoon developer an extreme amount of flexibility in constructing and laying out code expressions. In fact, many Hoon programs read as a hybrid of imperative code and functional code, since the ability to lay out intent line-by-line feels rather like C.

440+

441+Hoon conventions and sugar syntax have evolved organically as core developers discovered or invented useful design patterns and appropriately concise syntax.

442+

443+#### Functions (Gates) and Cores

444+

445+The most important structural concept in Hoon is the core, which organizes code into a binary tree of `[code data]`, or as we call it in Hoon, `[battery payload]`. Since cores have a standard structure, this means that many kinds of direct manipulations (metaprogramming) are possible, such as altering the input arguments to a function or manipulating the code variance model. Cores play a role in Hoon similar to that of objects in many other languages.

446+

447+Any function (“gate” in Hoon parlance) is a core, whose `battery` is the compiled Nock code and whose `payload` includes its view of the system, including the standard library, and its input arguments. The `|=` bartis rune is most commonly used to make a gate:

448+

449+```hoon

450+:: Select the larger of two values ("max").

451+|= [a=@ b=@]

452+?: (gth a b)

453+ a

454+b

455+```

456+

457+The gate definition rune `|=` bartis has two children, a specification of the expected input and the expression. When invoked, the values of the specification (or "sample") are provided to the expression, which then evaluates to return a noun.

458+

459+One quirk of Hoon is that since everything is an address (or “axis”) in a binary tree, you can access anything in your scope (“subject”) through its axis. Most commonly you attach a face to a value (like a gate), but you don't have to. At any point, to refer to the previous statement, you can invoke the head of the tree, `-`; to wit,

460+

461+```hoon

462+> =/ a 5

463+ -

464+a=5

465+```

466+

467+The name `a` is also attached to the value and can be used to identify the value. (To the Hoon parser there is no real difference; this is a programmer quality-of-life affordance.)

468+

469+```hoon

470+> =/ a 5

471+ a

472+5

473+```

474+

475+Thus faces (names) are attached to gates (functions) within a particular scope or context, such as a `|%` core. Each core defines a collection of values and gates (collectively termed “arms”) which occupy a shared scope. For example, the following library demonstrates a few floating-point operations in Hoon. Each function can see the parent subject (including `hoon.hoon` and some other cores) as well as its neighboring arms (such as `++pow-n` called by `++exp`).

476+

477+```hoon

478+|%

479+:: Factorial, x!

480+++ factorial

481+ |= x=@rs

482+ =/ t=@rs .1

483+ |- ^- @rs

484+ ?: =(x .1) t

485+ $(x (sub:rs x .1), t (mul:rs t x))

486+:: Absolute value, |x|

487+++ absolute

488+ |= x=@rs

489+ ?: (gth:rs x .0) x

490+ (sub:rs .0 x)

491+:: Exponential function, exp(x)

492+++ exp

493+ |= x=@rs

494+ =/ rtol .1e-5

495+ =/ p .1

496+ =/ po .-1

497+ =/ i .1

498+ |- ^- @rs

499+ ?: (lth:rs (absolute (sub:rs po p)) rtol) p

500+ $(i (add:rs i .1), p (add:rs p (div:rs (pow-n x i) (factorial i))), po p)

501+:: Power, restricted to integeres only, x**n

502+++ pow-n

503+ |= [x=@rs n=@rs]

504+ ?: =(n .0) .1

505+ =/ p x

506+ |- ^- @rs

507+ ?: (lth:rs n .2) p

508+ $(n (sub:rs n .1), p (mul:rs p x))

509+--

510+```

511+

512+Ultimately, however, the faces resolve back to an axis and the code is composed by the compiler into a Hoon syntax tree and thence to Nock for the runtime interpreter.

513+

514+The nature of cores derives from Nock and is key to understanding how Hoon works. All nontrivial structures in Hoon are cores. For instance, even a gate is a regular `|%` core, with `|=` expanding to `|%`. The following code snippets are identical to the Hoon compiler after parsing.

515+

516+```hoon

517+:: increment a number by two

518+|= p=@ud

519++(+(p))

520+```

521+

522+```hoon

523+:: increment a number by two

524+=+ ^~(*p=@ud)

525+|%

526+++ $

527+ +(+(p))

528+--

529+```

530+

531+Although Lisp's `'` quoting has no direct equivalent in Hoon, there are a couple of structures that can provide a similar effect. The most important of these is the `|.` trap, which defines an expression to be evaluated at a later time—Hoon’s equivalent of Lisp’s thunk. For instance, traps are used when testing code that _should_ fail, as the expression can be defined and deferred until the test framework is ready to process it.

532+

533+```hoon

534+> =foo |.((add 1 41))

535+

536+> -:foo

537+[8 [9 36 0 2.047] 9 2 10 [6 [7 [0 3] 1 1] 7 [0 3] 1 41] 0 2]

538+

539+> (foo)

540+42

541+```

542+

543+(To understand the second entry, recall that code is the in head of the core—here, we see the Nock code for the operation defined in the `|.` trap.)

544+

545+[Wet gates](https://developers.urbit.org/guides/core/hoon-school/R-metals) present the most macro-like feature in Hoon. A regular function, or “dry gate” (as above), receives an argument (the sample); the type system tries to cast the sample to the type specified by the gate, and fails if not possible. Wet gates instead defer type evaluation and instead attempt to use the sample (or arguments) directly in the expression. This produces a parametric polymorphism. (This comes close to dynamic typing, but type is still checked at compile time.) Wet gates are commonly used as gate-building gates, such as mold-producing gates like `++list`.

546+

547+Consider a function like `++turn` which transforms each element of a list.

548+

549+```hoon

550+> `tape`(turn ~[77 97 114 115] @t)

551+"Mars"

552+```

553+

554+To use `++turn`, we need a list and a transformation function. The type of the list we produce depends on the type of the list and the type of the transformation function. The actual gate `++turn` should work to transform each element of the list for on any function and any list, so long as the function's argument is the list item.

555+

556+Wet gates are therefore used when incoming type information is not well known and needs to be preserved. This includes parsing, building, and structuring arbitrary nouns. (Beyond Lisp analogues, you can think of C++'s templates and operator overloading, and Haskell's typeclasses.)

557+

558+This example compares the Lisp deferred factorial thunk with an equivalent Hoon trap. (Hoon includes `++factorial` since it is not part of the standard library.)

559+

560+```scheme

561+(defun create-thunk (function &rest arguments)

562+ (lambda () (apply function arguments)))

563+

564+(defun invoke-thunk (thunk)

565+ (funcall thunk))

566+

567+;; Creating a thunk that calculates the factorial of a number

568+(defvar factorial-thunk (create-thunk #'(lambda () (factorial 5))))

569+

570+;; Invoking the thunk to get the result

571+(print (invoke-thunk factorial-thunk)) ; Output: 120

572+```

573+

574+```hoon

575+=>

576+|%

577+++ factorial

578+ |= n=@ud

579+ |-

580+ ?: =(n 1) 1

581+ %+ mul n

582+ %= $

583+ n (dec n)

584+ ==

585+++ factorial-5

586+ |. (factorial 5)

587+--

588+(factorial-5)

589+```

590+

591+### Subject-Oriented Programming

592+

593+Urbit programming employs a paradigm deriving from the nature of Nock (_a fortiori_ Hoon), subject-oriented programming. Every expression of Hoon is evaluated relative to its subject, a piece of data that represents the environment, or the context, of an expression.

594+

595+The subject refers to the parent binary tree of an expression, more or less, and serves as state, lexical scope, environment, and function argument. (We can be precise about the definition in all cases—e.g. the subject of a gate in a core is the core itself—but don't need to for this essay.) Lisp supports variable scope and global variables, such that any part of the program can access a particular binding. Hoon's subject-oriented programming model naturally provides its equivalent of scope: all code is evaluated against a subject and name bindings proceed by depth-first match (with permitted skips to prevent unwanted masking).

596+

597+> Subject orientation in Nock and Hoon stems partly from minimalism (there's just one subject, which serves as state, lexical scope, environment, and function argument), partly from a desire to simplify compilation (the type of the subject is a full specification of the compile-time environment for a source file), and partly in order to give the language a more imperative feel.

598+>

599+> Everything about a scope, including name bindings, aliases, and docstrings, is stored in the subject's type. This allows Hoon's compilation discipline to be similarly minimal: the compiler is a function from subject type and Hoon source to product type and compiled Nock. Running this Nock against a value of the subject type produces a vase of the result. It's hard to imagine a more streamlined formalism for compilation. (Ted Blackman ~rovnys-ricfer, [“Why Hoon”](https://urbit.org/blog/why-hoon))

600+

601+The subject is typically the core in which an expression is evaluated, but can be more narrowly defined; consider, for instance, our example from above:

602+

603+```hoon

604+=> [a=1 b=2 c=3]

605+::

606+b

607+```

608+

609+A slightly different program fails:

610+

611+```hoon

612+=> [a=1 b=2 c=3]

613+::

614+(add a b)

615+```

616+

617+because the `++add` gate is not defined in the subject against which the expression is evaluated, the first statement.

618+

619+### Comparative Examples

620+

621+#### Find in List

622+

623+```scheme

624+(define index-of

625+ (lambda (needle haystack)

626+ (let ((tail (member needle haystack)))

627+ (if tail

628+ (- (length haystack) (length tail))

629+ (throw 'needle-missing)))))

630+```

631+

632+```hoon

633+:: Produces the index of the first occurrence of nedl in hstk

634+:: as the unit of an atom.

635+++ find

636+ |= [nedl=(list) hstk=(list)]

637+ =| i=@ud

638+ |- ^- (unit @ud)

639+ =+ [n=nedl h=hstk]

640+ |-

641+ ?: |(?=(~ n) ?=(~ h))

642+ ~

643+ ?: =(i.n i.h)

644+ ?~ t.n

645+ `i

646+ $(n t.n, h t.h)

647+ ^$(i +(i), hstk +.hstk)

648+```

649+

650+#### Filter a List

651+

652+```scheme

653+(define filter

654+ (lambda (fn lst)

655+ (let iter ((lst lst) (result '()))

656+ (if (null? lst)

657+ (reverse result)

658+ (let ((item (car lst))

659+ (rest (cdr lst)))

660+ (if (fn item)

661+ (iter rest (cons item result))

662+ (iter rest result)))))))

663+```

664+

665+```hoon

666+:: Cycle through the members of a list a, passing them to a gate b

667+:: and produce a list of all of the members that produce TRUE.

668+++ skim

669+ |* [a=(list) b=$-(* ?)]

670+ |-

671+ ^+ a

672+ ?~ a ~

673+ ?:((b i.a) [i.a $(a t.a)] $(a t.a))

674+```

675+

676+- Several examples in the above section were drawn from [UW's CSE 341 course notes](https://courses.cs.washington.edu/courses/cse341/03wi/scheme/basics.html) and from [Rosetta Code](https://rosettacode.org/).

677+

678+

679+## Metaprogramming

680+

681+A Lisp program is really a list, or a list of lists (nested as much as necessary). While this can be interpreted as an $n$-ary tree, tree structure is not the preferred structural metaphor. A Hoon program is a noun, or equivalently a binary tree. Every component of it is directly addressable and thus in principle reflective. Both languages are homoiconic, with code and data representations being the same. What are the consequences of homoiconicity?

682+

683+### Metaprogramming in Lisp

684+

685+Metaprogramming is the practice of writing code that manipulates other code at either compile-time or runtime. In Lisp, metaprogramming is a core feature of the language, and it allows developers to create programs that are incredibly powerful and flexible. Lisp's metaprogramming capabilities are primarily built on two features: macros and syntax manipulation.

686+

687+Macros in Lisp are a way to define new language constructs that are more expressive and more powerful than those provided by the language itself. When a Lisp program is compiled or interpreted, macros are expanded into regular Lisp code, allowing the macro to generate new code based on its input arguments. Since Lisp code is represented as data, it can be manipulated using the same functions and operators used to manipulate other data structures.

688+

689+For instance, Lisp macros could allow you flexibility in expressing a common operation. Imagine you're working on a project that requires a lot of complex math calculations. Rather than writing out each calculation manually, you could define a macro that takes an expression in infix notation (e.g. `2 + 3 * 4`), and transforms it into a Lisp expression that can be evaluated directly. Thus you could compose math expressions in a more human-natural way without having to worry about details of Lisp syntax.

690+

691+Lisp can also manipulate its own syntax. This is sometimes done through the use of reader macros, which operate at the level of the Lisp reader, which is responsible for converting textual input into Lisp expressions. Reader macros can be used to extend the syntax of Lisp, allowing developers to define new conventions or domain-specific languages for specific types of data or operations. Beyond reader macros, Lisp can permit the developer to change the parser (and as long as the result is a Lisp expression, the interpreter or compiler will be fine with this). Top-level functions can be replaced or modified (“advised”). Symbol macros can change source code.

692+

693+Lisp's `'` quote and the `eval` statement allow single expressions to be inhibited or evaluated at will, which is incredibly useful when dealing with symbols that may not be defined yet or in the composition of macros.

694+

695+In addition to macros and syntax manipulation, Lisp dialects typically provide a number of other features that make metaprogramming easier, such as the ability to inspect and modify the runtime environment, and the ability to create or redefine functions and classes at runtime.

696+

697+### Metaprogramming in Hoon

698+

699+While Hoon explicitly avoids macros and domain-specific language specializations, there are many aspects of Hoon which allow or exploit code reflection and manipulation.

700+

701+In practice, Hoon is intended as a systems programming language for the Urbit Nock VM. Hoon's metaprogramming has as a consequence mainly focused on aspects of core manipulation (such as code building and wet gates) and on live code upgrades (what I'll call hot-swapping code). Hoon eschews macros and in particular has a philosophical stance against domain-specific languages (DSLs). (There are some exceptions, notably Sail, Hoon's XML/HTML syntax; and JSON reparsing.)

702+

703+Hoon has the ability to parse arbitrary text strings (typically files) into executable ASTs and Nock. Symbols can be directly converted to and from regular text strings.

704+

705+As the programming language for a “hundred-year computer”, Hoon needs the ability to hot-swap code at runtime. Elements of cores can be removed or replaced. (Really, Hoon code is immutable: the system is actually making a copy with a specified change.) Every app and even the OS itself can define a state transition function and upgrade along a deterministic pathway.

706+

707+Hoon is in principle extremely reflective as it simply compiles to a Nock noun. Since everything is a stationary tree, it is straightforward to manipulate any object. There are no magic binary blobs or opaque data types: if you have a file handle or an Ethereum block or a websocket connection object, it is a tree and you can work with it directly. (Cf. [“Why Hoon”](https://urbit.org/blog/why-hoon).) Obtaining—or changing—details about gate sample or core behavior becomes a routine part of the Hoon developer’s toolkit. Given such regularity, it would be desirable to expose further capabilities of code reflection and introspection explicitly for the interpreter and IDE.

708+

709+One of the most common design patterns in Hoon is that of the higher-order function, or what Hoon calls “gate-building gates”. These are gates (functions) that produce gates (functions). For instance, as Hoon is statically typed a list must have an associated element type at compile time. `++list` is a gate builder that produces a type gate, which can then be applied to the actual values:

710+

711+```hoon

712+list :: gate builder

713+(list cord) :: gate for list of cords (strings)

714+`(list cord)`~['a' 'b' 'c'] :: list type applied to value

715+```

716+

717+Hoon represents a “hyperlambda” with respect to anonymous function creation: one very often defines gates at their point of use, particularly when operating on each member of a list or set. Similar to Lisp's frequent use of `lambda`, the one-time-use function is available at the point of call as an anonymous gate. (More generally, every gate is anonymous and we have to attach a name to it as a search path, but that's a bit out of scope here.)

718+

719+```scheme

720+((lambda (x1 x2)

721+ (* (- x1 x2) (- x1 x2)))

722+ 2 -5)

723+```

724+

725+```hoon

726+%- |= [x1=@ x2=@]

727+ (pro:si (dif:si x1 x2) (dif:si x1 x2))

728+[--2 -5]

729+```

730+

731+Like Lisp, Hoon yields a lot of power to the user–developer. One could implement a fairly regular Lisp on top of Hoon with very few changes—and perhaps even implement a pure-Hoon discipline yielding a statically-typed Lisp à la TypeScript from JavaScript.

732+

733+- [~tacryt-socryp, “Hick, a more traditional Lisp than Hoon”](https://gist.github.com/tacryt-socryp/b08dc66b7bcc760e914c4db5c9fd7ba7)

734+

735+

736+## Philosophy

737+

738+Hoon's focus on atoms, static typing, and symbolic expressions make it a highly expressive and efficient language for building applications on the Urbit platform, while Lisp's flexible syntax and macro system make it a popular choice for a wide range of programming tasks.

739+

740+Lisp has evolved greatly since John McCarthy's founding. Like Unix, a complicated family tree has finally settled down into a few strong contenders: Scheme, Common Lisp, Clojure, Racket.

741+

742+Lisp has tended to be fractious: as many have noted, and [Mark Tarver eloquently expressed](http://web.archive.org/web/20080803193859/http://www.lambdassociates.org/blog/bipolar.htm), the Lisp platform appeals to idiosyncratic visions for completist platforms. There's a looseness in the community's coherence as a result.

743+

744+For a few reasons, the Urbit community has managed to avoid such splintering (the [Urbit Classic joke](http://urbit-classic.org/) aside). With a single sponsoring organization, first Tlon Corporation and since 2022 the Urbit Foundation, to steward the ecosystem and a philosophical commitment to protocol-as-platform, Urbit should avoid partition into competing bazaars.

745+

746+Urbit's governing philosophy as a technical program is laid out in the [Precepts](https://urbit.org/blog/precepts). A sampling:

747+

748+> A.13. If you don't completely understand your code and the semantics of all the code it depends on, your code is wrong.

749+

750+> A.16. Explicit state is better than implicit state.

751+

752+> A.20. One hundred lines of simplicity is better than twenty lines of complexity.

753+

754+> D.3. Not being qualified to solve a problem is no reason not to solve it.

755+

756+There is significant overlap here with the ideals of the Lisp developer community present. Scheme like Hoon aims at minimalism and ample use of lambda expressions. [Clojure](https://www.clojure.org/about/rationale) aims at strengthening Lisp by building it on a modern platform (the JVM); it would agree with Urbit's disdain for nondeterminism: “pervasive, unmoderated mutation simply has to go”. Racket was designed for production systems and to some extent with a hope to unify parts of the developer stack.

757+

758+In many ways, Hoon is more Lisp-y than Lisp: that is, it represents a point more polar towards the telos of Lisp than any extant Lisp. By shedding the skin of lists and focusing on binary trees, Urbit achieves a deeper conceptual unification within itself. Hoon doesn't properly supersede Lisp—it requires running on a particular VM architecture, for instance—but Hoon's focus on typing, the nature of Hoon's binary-tree homoiconicity, and its employment of pure functional concepts make it a strong new tool for those to whom Lisp already appeals.

759+

760+Hoon goes farther than Lisp, however. Hoon is an accessible and practical, if unconventional, tool for simplifying the developer stack, ultimately to a single language. Ultimately, Urbit is a technical project to encode human digital freedom into the very protocol we use—with Hoon its nose-to-tail _lingua franca_. Hoon carries the torch that Lisp kindled into a new user-oriented future.

761+

762+To close, I quote Urbit Foundation CTO Ted Blackman on why Urbit follows its particular design discipline:

763+

764+> The promise of Urbit lies in its reimagination of the digital world using components that are as constrained and limited as possible. By adhering firmly to principle and doubling down on minimalism at every turn, we get an OS that provides far stronger guarantees than Unix with a thousand times less code. Given the complexity of modern software, this is what's required to put personal computing back into the hands of people. (Ted Blackman ~rovnys-ricfer, [“Why Hoon”](https://urbit.org/blog/why-hoon))

content/blog/interplanetary_commerce.md+1−1

@@ -34,4 +34,4 @@ The Urbit Foundation is soliciting contributors to this project through Urbit Gr

34

35## An Ocean

36

37−After honing our commercial tools on these use-cases, we’ll sail into a blue ocean. On the horizon: beautiful products, deployable at scale, built with the robust primitives of Urbit OS. Extensibility is Urbit’s promise to middle-men: every Web2.0 service they use to scalp us will find its P2P analog on Urbit. We invite developers and entrepreneurs of all stripes to join in the feeding frenzy. Ideas are constantly nucleating in [Urbitcoiners](web+urbitgraph://group/~pindet-timmut/urbitcoin-cash) and [Urbit Community](web+urbitgraph://group/~bitbet-bolbel/urbit-community/graph/~darrux-landes/business-building-on-urbit).

37+After honing our commercial tools on these use-cases, we’ll sail into a blue ocean. On the horizon: beautiful products, deployable at scale, built with the robust primitives of Urbit OS. Extensibility is Urbit’s promise to middle-men: every Web2.0 service they use to scalp us will find its P2P analog on Urbit. We invite developers and entrepreneurs of all stripes to join in the feeding frenzy. Ideas are constantly nucleating in [Urbitcoiners](web+urbitgraph://group/~pindet-timmut/urbitcoiners) and [Urbit Community](web+urbitgraph://group/~bitbet-bolbel/urbit-community/graph/~darrux-landes/business-building-on-urbit).

content/blog/pin-the-face-that-launches-a-thousand-ships.mdnew file+146

@@ -0,0 +1,146 @@

1++++

2+title = "Pin the Face that Launches a Thousand Ships"

3+date = "2023-04-07"

4+description = "A guest post by ~nospex-larsut"

5+[extra]

6+image = "https://storage.googleapis.com/media.urbit.org/blog/6a0120a85dcdae970b016766c94c14970b-800wi.jpg"

7+author = ""

8+ship = "~nospex-larsut"

9++++

10+_The original article can be found [here](https://nospex-larsut.arvo.network/blog/whyhoon) using [%blog](https://urbit.org/applications/~hanrut-sillet-dachus-tiprel/blog)._

11+

12+![](https://storage.googleapis.com/media.urbit.org/blog/6a0120a85dcdae970b016766c94c14970b-800wi.jpg)

13+

14+## Pin the Face that Launches a Thousand Ships[^1] ##

15+_A short piece addressing some of the standard hesitations to learning Hoon, considered in light of all of the recent exciting network activity._

16+

17+### Setting The Table ###

18+One can draw many distinctions between the Urbit apps that were available this time last year and those released thus far in 2023, but the most important of these may be that the former were apps noticed and used almost exclusively by users already on Urbit, where the latter - notably Pongo, Realm, Tirell Studio, Groups 2, Portal, etc - are apps that are _creating Urbit users_.

19+

20+Prior to the start of 2023, the superficial, yet incomplete, take was something to the effect that much of Urbit’s appeal was largely an affinity with the ideas and principles surrounding the project.

21+

22+People who found their way to Urbit latched on to philosophical entry points, among them values such as calm computing, decentralized/privacy/data-ownership maximalism, or aspirations of replacing a generations-deep legacy computing system that entrenched an ethos of doing things fundamentally inefficiently & incorrectly, in ways that not only hobbled the potential of the internet, but resulted in outright harm to its users through establishing platform models and incentives that consciously sought to manipulate the behavior of those users in countless subtle and not-so-subtle ways.

23+

24+Urbit was a nexus, collecting people from disparate backgrounds & disciplines to something like a spiritual oasis, yes, though one seemingly situated a million miles from anywhere familiar to the outside world; its appeal was more a function of the shared ethos of the community and a shared sense of its potential rather than the existence of new & immediately useful alternatives for day-to-day compute tasks.

25+

26+The energy of Assembly '22 was palpaple; it almost seemed that widespread adoption was around the corner. Inevitably, some of the post-Assembly ‘22 buzz seemed to fizzle as the ensuing months went by; many ships launched during that time went dormant, wondering if the potential hinted at would materialize; the shallow criticisn/meme for getting on to Urbit became, “I’m here… um, now what.”

27+

28+This whole time though, the project was simultaneously also an incredibly busy construction site.

29+

30+Remarkably short-lived, “I’m here… um, now what?’ is unraveling with the realization that this universe has always been accelerating, and this new wave of apps establishes a very visible & powerful reference point for truly appreciating that acceleration and the distance traveled; after what seemed like a brief post-Assembly fizzle, the network is again kinetic and crackling with energy, but in reality it was never slowing down.

31+

32+The latest generation of apps marks an important shift in the trajectory of Urbit adoption. Much of this is possible thanks to the proliferation of hosting options - whether [Native Planet’s](https://nativeplanet.io/) self-hosted solutions or through turnkey models - which collectively have vastly streamlined the Urbit onboarding process such that getting on the network is no longer the equivalent of scaling a forbidding & remote mountain peak, arriving at the threshold of a silent monastery, heaving its heavy door ajar to find it seemingly abandoned only a thin sliver of light to illuminate your path, nobody there to acknowledge your arrival much less offer a tour. The thrill of having finally gotten there dampened by the increasing sense that all of its life is subterranean and the real journey is just beginning.[^2]

33+

34+Single-click onboarding and preloaded apps & groups may not seem like a lot for newcomers, but these things have increased tremendously the ability to get on Urbit compared to just six months ago.

35+

36+And just as a selection of competing hosting providers expanded the number of possible onramps, this new crop of Urbit apps likewise provides a complimentary function as entry points - hidden doors to Urbit embedded in the Apple/Android app stores - in ways that Urbit apps never enjoyed previously, all helping to further reduce the friction of onboarding by orders of magnitude. A user searching for a Telegram alternative stumbles across Pongo; new eyes find Urbit without ever intentionally seeking it out.

37+

38+The animating ideas behind the project, I think, remain as alive as ever - Urbit does not need to jockey to become the ‘current thing’ if it can much more efficiently become the undercurrent thing; without having to waste a single breath converting users at the margin on the necessity or virtue of recreating the web in a decentralized & privacy-oriented manner, new users are able to become advocates for apps that provide practical utility for day-to-day compute, creative, and communication needs - but that also happen to be built on such infrastructure. The yew tree doesn’t propagate itself by trying to convince the bird that it is desirable that there be more yew trees in the world, it just wraps its seed in a tasty & nutritious berry and lets the bird carry it off.

39+

40+Compelling apps, built on continually-improving and innovative infrastructure & development tooling is one piece of the adoption curve. These things bring users, who bring perspectives, feedback, ideas, wants, and needs. It brings their attention to earn it. If they are spending time on Urbit apps, they will also be exposed to whatever else is being shared on Urbit through those apps – what will catch their attention that maybe they are not seeing elsewhere? Suffice to say this is all basically network effects 101, so on to the question of learning Hoon.

41+

42+### Some Grains of Salt ###

43+Perhaps that was a lot of table-setting to get to the original inspiration of this piece, in which I wish to present some arguments to the standard objections or concerns that seem to arise for people thinking of learning Hoon. My aim is not to twist any arms or legs, but only to offer some considerations for those on the fence. Hopefully the preceding bit of history at least reveals some shred of the potential opportunities for Hooners (and other creatives - we absolutely need those as well).

44+

45+But first the grain of salt with which you should take the following:

46+I currently Hoon at something approximating a tenth-grade level. I am by no means a natural born developer, nor am I moving towards a dynamic career switch to full-time Urbit dev. Not by any stretch of the imagination. While I am interested in continuing to learn Hoon for a variety of reasons, none are likely to reverberate very far beyond my own ship.

47+

48+My Hoon education began in the summer/fall ’22 cohort of Hoon School Live. In my early 40’s, I walked into it slightly intimidated by its reputation, and with a personal technical background not much deeper than writing Excel formulas, a little Python, and building simple websites (like, 20 years ago). At the moment, I am much better at reading it than writing it, but thanks to HSL & ASL (and everyone involved with those efforts), it does make sense to me.

49+

50+So despite not exactly practicing what all I am about to preach, the foregoing, combined with having talked to enough people on the fence about learning Hoon, I feel somewhat qualified to at least offer some perspective for those considering the question.

51+

52+### The Standard Hesitations ###

53+The following hesitancies seem to be the recurring ones, and we’ll take them one at a time, although they share a significant degree of overlap.

54+<ol>

55+<li> But I already know languages x, y, z, etc and can build things with them now.</li>

56+<li> I hear Hoon is very difficult / weird / etc.</li>

57+<li> Urbit’s future is uncertain; investing in learning Hoon seems risky.</li>

58+<li> I don’t see many immediate jobs for Hoon devs.</li>

59+</ol>

60+

61+__Hesitancy 1: But I _already know_ languages x, y, z, etc and can build things with them _now_.__

62+

63+A valid contention in that one has invested in skills they are eager to put to use or continue to use. But can you build what you want to build - and where you want to build it? And what is the cost in terms of personal satisfaction to working on something which doesn’t truly excite you?

64+

65+There is something of the sunk-cost fallacy is at work here. It is not always a bad impulse, and opportunity costs are very real. But if there is something compelling about Urbit - and the fact that one is at least seriously considering learning Hoon suggests this is the case - and one is willing to view their existing proficiency in some other language as a demonstration of their capability to learn any programming language, then existing knowledge should not act as a barrier to pursuing new knowledge, particularly if there is a suspicion that working on Urbit may afford more intellectually stimulating and enjoyable opportunities.

66+

67+Consider also that a person working on things that truly animate them, despite maybe being relatively less experienced in the language, nonetheless has much more room to grow in a smaller pool where they may create closer connections, have more access to the perspectives of experienced devs, and get noticed for their contributions faster than those that may exist for a person working on things they are decidedly less passionate about amidst a pool of thousands.

68+

69+Yet another upside of working in Urbit is the sheer amount of projects yet to be built (not all require Hoon, btw); projects that may be intriguing to a developer but which already exist in some other language/product have yet to be built on here, and there is a need for them. The amount of still low-hanging fruit and infrastructure work remaining to be done, let alone potential app and utilities, is substantial, and this is a community that generally speaking, respects anybody who can come in and start contributing with minimal direction or permission.

70+

71+And is time spent learning Hoon really time spent not building things? Are you not building skills, reputation, friendships, problem-solving skills, camaraderie - building a better self - throughout the learning process? One can easily present the argument that the cost in this regard is much less than it may seem at first glance.

72+

73+Since one can only try to subjectively weigh the opportunities open to them with their current skills against the nebulous costs of _not_ pursuing something that has piqued their interest, the dilemma often cannot but remain unanswered until one takes the steps to find out; until then, it remains a persistent, nagging 'what if'?. It may take several months to feel really comfortable writing Hoon, but there is a relatively low cost to spending a few weeks to dive in and see if one has an aptitude or affinity for it.

74+

75+__Hesitancy 2: Hoon is difficult and/or weird.__

76+

77+Recognizing that there are a lot of runes, and that Hoon is odd compared to other languages,

78+

79+- learning just a handful[^3] of them along with the basic families (create cores with | runes, call functions with % runes, conditionals statements are built with ? runes, etc) will get one well on their way. </li>

80+- if Hoon is not your first language, you have already demonstrated a capacity for becoming comfortable working within a framework of structure and syntax that was, relative to your previous inexperience, alien and weird. And while there are additional wrinkles in dealing with a functional language, the majority of CS concepts remain relevant and are transferable.

81+

82+And if Hoon is your first language, it is all uncharted territory anyway and not having anything to compare it to means one is essentially in the same situation as in learning any new language, and in that respect it mirrors almost any endeavor to grasp new modes of problem-solving under a unique set of conditions and constraints. Even if you do not stick with Hoon, the new perspectives in problem-solving experience are valuable, and most of the fundamental concepts will be transferable to other languages.

83+

84+You might also consider how to use Hoon’s reputation for difficulty to your advantage from the standpoint that, if you are firmly convinced that it is or will be unduly difficult, then that should yield a much deeper satisfaction after proving you are in fact capable of learning it.

85+

86+And from a more opportunistic standpoint, realize that others who allow this reputation to dissuade them create outsized opportunities for those who are willing to learn it. One can very usefully calibrate expectations here to use the reputation to provide some cover - if it really is that hard, iit is ok to not get it at first, and you can succeed where others gave up or failed to even try.

87+

88+Speaking from my own experience, the sheer amount of terminology was somewhat overwhelming at first, and this was true of both HSL & ASL (more so the latter, IMO). Many of the names seem arbitrary, but like anything, making it familiar is largely a function of effort.

89+

90+Recognize that Hoon's unique syntax and functional paradigm are integral to its design and purpose. Instead of trying to force parallels between Hoon and other languages or concepts you already know, just immerse yourself in it with an open mind and willingness to grasp its distinct features and the reasoning behind them.

91+

92+<div class="polaroid">

93+ <img src="https://storage.googleapis.com/media.urbit.org/docs/userspace/hoon-school/binary-tree-bottom-row-full.png" alt="Tree">

94+ <div class="container">

95+

96+ <p>See - it's easy!</p>

97+ </div>

98+</div>

99+

100+__Hesitancy 3: Urbit’s future is uncertain; investing in learning Hoon seems risky.__

101+

102+Much of the table-setting for this piece was an attempt to frame the potential opportunity for devs of any level. Keeping things in perspective, Urbit is just about to hit [3,000 active ships](https://twitter.com/urbitfoundation/status/1637931937351491584). There are several reasons why recent activity may be much more indicative of even greater future growth than one might assume from looking at the chart:

103+<ul>

104+<li>a. Maybe very obviously, the growth of the last three months is not simply a 1:1 reflection of the work of the last three months, but of the many preceding years of core development that made a significant increase in percentage terms within a very short interval possible. The stage is set for much faster growth.</li>

105+<li>b. Previously mentioned, but all these threads are interconnected in that, the more eyes on Urbit, the more ideas, talent and additional users will be introduced to, and recognize the depth, of the opportunity here. A steadily stabilizing building environment (thanks to a)) that attracts and can support more users should continue to build momentum. </li>

106+</ul>

107+

108+Remaining sober about reality, 3,000 users is not exactly a ton in web 2 terms; for Urbit, it is simultaneously very many and very little. But with better apps providing more reasons to be on Urbit, working in unison with better UX and onboarding, those users have more reason to stay engaged with Urbit once they are on, which means anything an aspiring Hooner or creator can think of to give them compelling reasons to make them even more engaged is an opportunity.

109+

110+Deliberately twisting the fomo screws a little, it is as true for learning Hoon as it is of anything else that the more widely adopted a platform or language becomes, the safer a bet it will be in terms of stability and longevity. With the accretion of that stability however, the window for realizing the benefits of gaining early experience and exposure in a less-crowded space diminishes accordingly as the sense of perceived riskiness in staking ground there decreases. Like any investment, uncertaintly about the future carries the gift of a difficult to quantity but very real species of camaraderie, credibility, and respect that is only available to those willing to get involved at early stages, and which is lost as the project starts to look increasingly like a 'sure thing.' Hard to value, but weigh that aspect when considering if one should begin learning now or wait until things look ‘slightly more certain’ - what is the bar for this certainty? What is ‘certain enough’?

111+

112+Urbit, by (beautiful) design, is a very low-time preference project in some respects, but it is growing quickly. And the longer you’ve been watching Urbit grow, the more perspective you have of how much can happen in a very short time.

113+

114+When there are 10,000, 100,000 active ships it will be a trip in itself to remember that you started learning Hoon back when there were "only" 3,000, and contributed in maybe some non-trivial way to attract some quantity of new ones by building something you were excited about building.

115+

116+__Hesitancy 4: I don’t see many immediate jobs for Hoon devs.__

117+

118+_Not yet you don’t_. Much of the response to Objection 3 is also relevant here.

119+

120+The pool of Urbit companies is not fixed. It is not an insurmountable obstacle to start up a small-scale dev shop with a handful of talented devs.

121+Money flowing into Urbit is being reported with increasing frequency, and this is only the incoming money that you _hear about_. As Urbit grows, money will chase money, bringing more jobs and more opportunities. For better, or worse, of course, money changes things - more money will necessarily mean more discipline, more focus on shipping product, etc. But not having money changes things too. Money comes here in no small part because it sees the energy and intensity with which this community has been building out Urbit - regardless of whether money was flowing in or out of it - it attracted devs because the project itself was an ambitious worthwhile good in itself.

122+

123+There is much opportunity here for bright, motivated developers willing to make the effort to learn. One only has to bump the total current dev headcounts up against the growing momentum of the project to see the opportunity, whether it be in core projects, apps, or novel pairings with creators to determine ways to distribute and produce content on Urbit. The speed of deployment on Urbit compared to other projects and relative exposure to other platforms affords a significant advantage to motivated, talented people in terms of visibility - when an app gets published on Urbit, everyone sees it.

124+

125+### Wrapping Up ###

126+Hopefully the above provides some perspetive on reframing some of the standard hesitancies. None of them are irrational. However, if none of the above sways you, ask what projects or features might materialize on Urbit that would make you wish you started learning Hoon a year ago (which, in the grand scheme, would make you a reasonably well-experienced Hooner) and then consider that you could wait for that thing to materialize, or play an active part in making it a reality that will attract many other users to the network, along with making others feel like they should have started learning Hoon a year ago.

127+

128+And if the Hoon question is indeed a recurrent & nagging one, attempt to replace it with the question, “two months from now (approximately the duration of an HSL cohort), would I rather have tried learning Hoon and discovered that I don’t like it and be done with the question, or still be sitting here wondering if I should learn Hoon?”

129+

130+The resources for learning Hoon are growing:<br>

131+● [Hoon School Live](https://developers.urbit.org/courses/hsl)<br>

132+● [App School Live](https://developers.urbit.org/courses/asl) <br>

133+● [App Workshop Live](https://developers.urbit.org/courses/awl) <br>

134+● An upcoming [Core Dev course](https://developers.urbit.org/courses/csl)<br>

135+● The growing corpus of [documentation](https://developers.urbit.org/reference/hoon/overview)<br>

136+● And of course the most valuable resource of all is all the people on the network who are willing to answer questions and help one learn. Find them in the Hacker House.

137+<p>

138+

139+If something about Urbit is drawing you toward it, if the project resonates with you in a way that other things in tech do not - if you are truly intrigued by it and want to be here - it is reasonable to assert that the process of learning Hoon is not simply a tax with questionable upside, but a productive process in and of itself; that the very process of learning it will embed you deeper into a space you want to be in.

140+

141+So learn Hoon. Not only is it fun, but as an Urbiter, it is something of a cultural heritage, and the conduit between reality and whatever your endless imagination conceives Urbit’s potential to be - space here is wide open, and any of today’s aspiring Hooners has the potential to pin the face that launches a thousand ships.

142+

143+----------------

144+[^1]: To 'pin a face' is to declare a variable in Hoon.

145+[^2]: Maybe some slight dramatization; this aspect also made it fun for those not in need of immediate gratification.

146+[^3]: [See 'Rune Utilization in Hoon'](https://developers.urbit.org/blog/rune-frequency-202212)

content/blog/using-urbit-in-2023.mdnew file+55

@@ -0,0 +1,55 @@

1++++

2+title = "Using Urbit in 2023"

3+date = "2023-02-06"

4+description = "There are more ways to run Urbit than ever, and more options coming soon."

5+[extra]

6+image = "https://storage.googleapis.com/media.urbit.org/blog/usingurbit-2023.jpg"

7+author = "Josh Lehman"

8+ship = "~wolref-podlex"

9++++

10+

11+![](https://storage.googleapis.com/media.urbit.org/blog/usingurbit-2023.jpg)

12+

13+Recent years have seen several iterations on ways to run an Urbit node and join the network. [Port](https://github.com/latterbolden/port) and support for running Urbit from Windows were added a couple of years ago and have previously been recommended ways of running Urbit. We no longer recommend these options for the vast majority of users in favor of better options that are now available.

14+

15+Read on to learn about the background underpinning these decisions and your options for joining the network going forward.

16+

17+

18+

19+# Background

20+

21+With the introduction of Landscape in 2020 the demand for being on the network rose substantially from what it had been, yet the only way of running Urbit was through the command line, which was a significant barrier for entry.

22+

23+In 2021 Port and a native Windows binary were both introduced via contributions from the open source community: Port was built via our [grants](https://urbit.org/grants/cross-platform-desktop-urbit-app) [program](https://urbit.org/grants), and the Windows binary was contributed via a [pull request](https://github.com/urbit/urbit/pull/4675). Together, these two projects enabled users to run Urbit locally without requiring command-line knowledge. Port was summarily added as an officially recommended way to run Urbit.

24+

25+Over the course of 2022 it became clear that, while often useful for trying Urbit out, the experience of running Urbit locally via Port was fundamentally limited: Urbit runs best as a server, and laptops provide neither a stable running environment nor consistent web-based access from other devices.

26+

27+Windows presented further challenges, particularly around maintenance: our team of runtime engineers has had their progress stymied by the need to support Windows, which has substantially different requirements from macOS and Linux. It’s ultimately much more important to our team that we make progress on the versions of the runtime that run well in a server environment, which is the best way to use Urbit, than for local installations.

28+

29+Going forward we no longer recommend Port as an officially supported option for joining the network, and have dropped support for the native Windows binary as of version [1.16](https://groups.google.com/a/urbit.org/g/dev/c/3S6A8Qf8Qzg) of the runtime. That said, it’s worth noting that Port *is not deprecated*! It is still actively [maintained here](https://github.com/latterbolden/port) by the same people that have been maintaining it since the beginning.

30+

31+Let’s move on and talk about your options for getting on the network going forward.

32+

33+

34+# Joining the Network Today

35+

36+Over the course of 2022 many companies emerged and built products that will get you on Urbit, and their teams are constantly working to provide you with a great experience.

37+

38+If you’re not comfortable at the command line you should use a [hosting provider](https://urbit.org/getting-started/hosted). Hosting providers run your Urbit for you and take care of any ongoing maintenance required. If you eventually want to transition to running Urbit yourself, they’ll let you pack up your node and run it however you want: whether that’s at a different hosting provider or your own infrastructure. Learn about [recommended hosting providers in our getting started guide.](https://urbit.org/getting-started/hosting-providers)

39+

40+For more technical users the [command line](https://urbit.org/getting-started/cli) is still a reliable option. For casual testing you can boot a planet or comet on your local macOS or Linux-based machine, and for more serious usage you should refer to our [cloud hosting guide](https://urbit.org/getting-started/cloud-hosting) to get set up on a VPS. A newer option for self-hosting is [Native Planet’s](https://nativeplanet.io) suite of [software](https://www.nativeplanet.io/software) for turning a local computer into an Urbit server complete with DNS.

41+

42+

43+# Coming soon

44+

45+New options for joining Urbit are just around the corner.

46+

47+Word has it that [Tlon](https://tlon.io/hosting) will soon allow you to invite your friends to groups directly from within their [suite of applications](https://tlon.io/landscape), with onboarding handled seamlessly through their hosting service.

48+

49+[Holium’s Realm app](https://www.youtube.com/watch?v=gdu4QtFR-Bs), a collaborative desktop computing environment available on macOS (for now), allows users to sign up with an existing Urbit or brand new hosted one — all seamlessly surfaced through Realm’s signup flow. You can sign up for the private alpha [here](https://holium.com).

50+

51+Tirrel’s [Scene](https://planet.one/scene) is a desktop application with built-in hosting, like Realm, that works on macOS, Windows and Linux, and it’s available now. Hosting is powered by their [Planet One](https://planet.one) service.

52+

53+For the self-hosting enthusiasts out there Native Planet has created [purpose-built Urbit home servers](https://www.nativeplanet.io/hardware) that [make self-hosting easy](https://twitter.com/jmrphy/status/1616196970384887808) and look great doing it.

54+

55+Joining Urbit has never been easier, and it’s constantly getting easier. See you on the network!

content/bounties.md+9−11

@@ -1,15 +1,15 @@

1+++

2title = "Guide to Bounties"

3−date = "2022-10-26"

3+date = "2023-01-04"

4weight = 1

5description = "A guide to posting and claiming bounties"

6+++

7

8−Bounties are opportunities to do work on Urbit in exchange for address space or other funding. Bounties can be provided by companies, DAOs or individuals ("benefactors") in the Urbit universe. To the extent that they benefit the rest of the universe, the Urbit Foundation will [chip in on funding](#funding).

8+Bounties are opportunities to do work on Urbit in exchange for address space or other funding. Bounties can be provided by companies, DAOs or individuals ("sponsors") in the Urbit universe. To the extent that they benefit the rest of the universe, the Urbit Foundation will [chip in on funding](#funding).

9

10For **workers**, bounties offer substantial funding opportunities and, compared to [apprenticeships](/grants/apprenticeships), are a way to take on larger challenges in a more autonomous manner. Learn how to [work on a bounty here](#work-on-a-bounty).

11

12−For **benefactors**, bounties allow you to scale your workforce through the Urbit community, get critical tools built, or just fund cool projects that you want to see exist. Learn how to [post a bounty here](#post-a-bounty).

12+For **sponsors**, bounties allow you to scale your workforce through the Urbit community, get critical tools built, or just fund cool projects that you want to see exist. Learn how to [post a bounty here](#post-a-bounty).

13

14## Work on a Bounty

15

@@ -17,17 +17,17 @@ You can see [open bounties here](/grants?program=bounty&open=true&wip=false&comp

17

18### How it works

19

20−After applying, the Urbit Foundation will circulate the details of your application to the benefactor and schedule a follow-up interview to see if you would be a good fit for the project. Should your application be accepted, you will undergo a quick KYC process and recieve a contract for signature. Some bounties may also entail additional direct compensation from the benefactor for which the Urbit Foundation is not responsible for managing; please discuss these parameters directly with your Champion.

20+After applying, the Urbit Foundation will circulate the details of your application to the sponsor and schedule a follow-up interview to see if you would be a good fit for the project. Should your application be accepted, you will undergo a quick KYC process and recieve a contract for signature. Some bounties may also entail additional direct compensation from the sponsor for which the Urbit Foundation is not responsible for managing; please discuss these parameters directly with your sponsor.

21

22−The benefactor of the bounty is ultimately responsible for signing off on completed work. They'll also be the primary point of contact while work is underway, although the Urbit Foundation may assign personnel to assist on bounties that it is particularly invested in.

22+The sponsor of the bounty is ultimately responsible for signing off on completed work. They'll also be the primary point of contact while work is underway, although the Urbit Foundation may assign personnel to assist on bounties that it is particularly invested in.

23

24−Benefactors are vetted by the Urbit Foundation as trustworthy to ensure their ability to fund the work that they post. The Urbit Foundation also collaborates heavily with benefactors to ensure that the bounty is [well-specified](#well-specified-bounties), which ensures that your project is both properly scoped and technically viable.

24+Sponsors are vetted by the Urbit Foundation as trustworthy to ensure their ability to fund the work that they post. The Urbit Foundation also collaborates heavily with sponsors to ensure that the bounty is [well-specified](#well-specified-bounties), which ensures that your project is both properly scoped and technically viable.

25

26### Getting Paid

27

28−After you've finished your work on a given milestone, you will need to get signoff from your Champion. To do this, make a notebook post in the Champion's designated group with the details of the milestone completed, any relevant instructions, github repos, or app download links, and solicit review from your champion. Their reply of `approved` in the notebook post comments will constitute signoff and you'll need a link to that milestone post when you [submit an invoice](https://airtable.com/shrXXCs1uaxtNSBcg). Upon successful review of this notebook post by the Urbit Foundation and an invoice recieved for the amount agreed upon in your grant or milestone, the Foundation will pay your star allocation to the Ethereum address you have provided.

28+After you've finished your work on a given milestone, you will need to get signoff from your sponsor. To do this, contact your sponsor with the details of the milestone completed, any relevant instructions, github repos, or app download links, and solicit review from your sponsor. They can submit their approval to the Foundation by contacting `~marfun-pacpet`, at which point you are ready to [submit an invoice](https://airtable.com/shrXXCs1uaxtNSBcg). Once the Urbit Foudnation receives approval from your sponsor and an invoice for the amount agreed upon in your grant or milestone, the Foundation will pay your star allocation to the Ethereum address you have provided.

29

30−We approve and issue payments within 30 days of invoice receipt and approval, although often payment is made more quickly as transactions are batched with other grantees who have recently completed milestones. If you are having any issues accepting stars through [Bridge](https://bridge.urbit.org) please contact `~taller-ravnut` for assistance.

30+We approve and issue payments within 30 days of invoice receipt and approval, although often payment is made more quickly. If you have any questions regarding getting paid or submitting an invoice, please contact `~marfun-pacpet` for assistance.

31

32## Post a Bounty

33

@@ -35,8 +35,6 @@ To get started posting a new bounty, [submit it via this form](https://airtable.

35

36We at the Urbit Foundation will work with you to ensure that all bounties have [clear specifications](#well-specified-bounties) — this ensures that they get what you pay for. If your bounty submission is missing details or could be otherwise improved, we'll provide that feedback and work with you to refine your bounty.

37

38−You will also be required to host an Urbit group within which there is a chat channel for discussion around the scoping and execution of the bounty, and a notebook for the final specification as well as contributor reports of milestone completion.

39−

40### Well-specified Bounties

38### Well-specified Bounties

41

39

42A well-specified bounty generally has these elements:

40A well-specified bounty generally has these elements:

@@ -45,7 +43,7 @@ A well-specified bounty generally has these elements:

45- **Project Requirements**: An articulation of what constitutes complete work. User stories, Figma designs, interface specifications, and other technical constraints are all examples of requirements. It is recommended to reference any specific requirements — such as key user stories — on a milestone level to ensure clarity in which requirements need to be met at each stage of the project.

43- **Project Requirements**: An articulation of what constitutes complete work. User stories, Figma designs, interface specifications, and other technical constraints are all examples of requirements. It is recommended to reference any specific requirements — such as key user stories — on a milestone level to ensure clarity in which requirements need to be met at each stage of the project.

46- **Worker Requirements**: A description of the skills and/or qualifications required of a prospective worker. Technologies or skills known, years of experience, work schedule (e.g. time availability), and demonstrable accomplishments are all examples of this.

44- **Worker Requirements**: A description of the skills and/or qualifications required of a prospective worker. Technologies or skills known, years of experience, work schedule (e.g. time availability), and demonstrable accomplishments are all examples of this.

47- **Milestones**: Logical segments of work that can be considered done on their own. Breaking the project up into smaller pieces will help a new worker pick up the work should that be necessary, keeps the worker motivated with incremental achievement and remuneration, and is generally a sign of a clear specification. Milestones don't always make sense; sometimes there's only one.

45- **Milestones**: Logical segments of work that can be considered done on their own. Breaking the project up into smaller pieces will help a new worker pick up the work should that be necessary, keeps the worker motivated with incremental achievement and remuneration, and is generally a sign of a clear specification. Milestones don't always make sense; sometimes there's only one.

48−- **Timeline**: If you're trying hit a certain deadline, make sure to specify absolute dates on the milestones. Otherwise, use relative dates (e.g. _two months_) to give the worker an idea of how long each milestone will take. This helps form an agreement between benefactor and worker on volume of work, and grounds to seek other arrangements should schedules be missed.

46+- **Timeline**: If you're trying hit a certain deadline, make sure to specify absolute dates on the milestones. Otherwise, use relative dates (e.g. _two months_) to give the worker an idea of how long each milestone will take. This helps form an agreement between the sponsor and worker on volume of work, and grounds to seek other arrangements should schedules be missed.

49

47

50The more detail in the bounty's specification, the better the results and the smoother your working relationship will be with a contributor. Once a contributor has been selected, parameters such as absolute dates or other open ended questions will be updated prior to contract to ensure there are clear expectations for all parties involved

48The more detail in the bounty's specification, the better the results and the smoother your working relationship will be with a contributor. Once a contributor has been selected, parameters such as absolute dates or other open ended questions will be updated prior to contract to ensure there are clear expectations for all parties involved

51

49

content/campus/_index.mdnew file+37

@@ -0,0 +1,37 @@

1++++

2+title = "Software Developers"

3+slug = "software-developers"

4+description = "Getting started as a software developer on Urbit"

5+sort_by = "weight"

6++++

7+

8+

9+Urbit offers foundational primitives that make it easy to build decentralized applications. This means developers can focus on creativity and application logic instead of operations to make sure the server or database doesn't go down.

10+

11+

12+Here are a few links to resources for developers:

13+

14+

15+### [Urbit Developers Overview](https://developers.urbit.org/)

16+An overview of using Urbit for development.

17+

18+### [Lightning Tutorials](https://developers.urbit.org/guides/quickstart/intro)

19+Get a feel for the process of making and deploying an Urbit app in half an hour, no previous experience required.

20+

21+### [Core Curriculum](https://developers.urbit.org/guides/core)

22+Learn the Urbit stack at your own pace.

23+

24+The Foundation also regularly runs a series of cohort-based live courses that go over the core curriculum, free and open to all. One lesson per week over the course of about eight weeks.

25+

26+### [Live Courses](https://developers.urbit.org/courses)

27+Learn the Urbit stack as part of a group.

28+

29+### [New Hooniverse](https://urbit.org/groups/~hiddev-dannut/new-hooniverse)

30+Discussion group for learning the Urbit stack. Open to beginner, intermediate, and advanced developers.

31+

32+

33+### [TomeDB](https://holium.gitbook.io/tomedb/)

34+A framework for building Urbit apps solely with Javascript.

35+

36+### [Grants](https://urbit.org/grants)

37+Build on Urbit and take ownership of the network in the process.

content/campus/blockchain-enthusiasts.mdnew file+35

@@ -0,0 +1,35 @@

1++++

2+title = "Blockchain Enthusiasts"

3+slug = "blockchain-enthusiasts"

4+description = "Learn how sound computing and sound money fit together"

5+weight = 4

6+[extra]

7+flatten_pagination = "true"

8+hide_next_title = "true"

9+hide_previous_title = "true"

10+image = "https://media.urbit.org/site/understanding-urbit/urbit-id/urbit-id-cards%402x.png"

11++++

12+

13+We have yet to see the promised Cambrian explosion of general-purpose decentralized applications promised by blockchains. What happened?

14+

15+While blockchains are good for some problems, there remain others where a more general purpose computing solution is more useful. This is precisely what Urbit is for. Urbit’s vision of sound, easy-to-use, decentralized computing dovetails neatly with that of sound, easy-to-use, decentralized money.

16+

17+Learn more on how Urbit and blockchains work together:

18+

19+### [Bitcoin on Urbit: The Sovereign Stack](https://urbit.org/bitcoin)

20+How Urbit and Bitcoin fit together

21+

22+### [Azimuth](https://developers.urbit.org/reference/azimuth/azimuth)

23+Urbit’s PKI system on Ethereum

24+

25+### [Uqbar](https://uqbar.network)

26+The Urbit-native blockchain

27+

28+The leader in this space is Uqbar, an Urbit-native layer 2 blockchain that settles on Ethereum.

29+

30+From their [clearpaper](https://uqbar-network.gitbook.io/uqbar-clearpaper/uqbar-clearpaper/uqbar-clearpaper):

31+

32+>Leveraging Urbit’s peer-to-peer infrastructure, Uqbar provides a blockchain-native decentralized operating system uniquely positioned to deliver the composable primitives necessary to build a rich, functional distributed application layer. It fuses the trusted settlement of Ethereum with the decentralization, security, and interoperability benefits of full-scale peer-to-peer networking, unlocking the latent power of programmable blockchains.

33+

34+

35+

content/campus/creatives.mdnew file+21

@@ -0,0 +1,21 @@

1++++

2+title = "Creatives"

3+slug = "creatives"

4+description = "Urbit for everyone"

5+weight = 5

6+[extra]

7++++

8+

9+Urbit offers creatives the means to truly own the distribution of their work. An application becomes a tool you own rather than a service whose terms can change overnight. And with digital ownership on a decentralized network, the incentives of advertising based centralized services and an attention economy no longer apply.

10+

11+What would the world look like with more decentralized digital ownership? Check out the links below for a preview.

12+

13+### [Tirrel Studio](https://urbit.studio)

14+

15+Host, publish, and earn on Urbit. See the [Mars Review of Books.](https://marsreview.org/)

16+

17+

18+### [Meetup Grant](https://urbit.org/grants/community-meetups)

19+

20+Through our Grants program, the foundation rewards community-builders who

21+host regular meetups and help people learn about the project.

content/communities/urbit-austin.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Urbit Austin"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-austin.png"

5++++

6+

7+Curious about Urbit? Questions about Hoon syntax? Fed up with the current state of the internet? Join us to talk about the internet's future.

8+

9+––

10+

11+[Meetup page](https://www.meetup.com/Urbit-Austin/)

content/communities/urbit-berlin.mdnew file+16

@@ -0,0 +1,16 @@

1++++

2+title = "Urbit Berlin"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-berlin.png"

5++++

6+

7+If you are sick of the current state of the web, of handing over your data and entire online presence to a handful of American corporations, of a web fueled with ads, then Urbit might be for you.

8+

9+Are you curious about Urbit and want to try it? Are you an Urbit OG looking to find to find others? Do you want to build your own peer-to-peer apps and leave the centralized web behind?

10+

11+We meet regularly in Berlin, and we try to have a theme or presentation for each meetup.

12+

13+

14+––

15+

16+[Meetup page](https://www.meetup.com/urbit-berlin/)

content/communities/urbit-christchurch.mdnew file+13

@@ -0,0 +1,13 @@

1++++

2+title = "Urbit Christchurch"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-christchurch.jpg"

5++++

6+

7+Curious about Urbit? Questions about Hoon syntax? Fed up with the current state of the internet? Join us to talk about the internet's future.

8+

9+––

10+

11+[Eventbrite](https://chchurbit.eventbrite.com)

12+

13+[Telegram](https://t.me/chchurbit)

content/communities/urbit-cph.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Urbit København"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-cph.png"

5++++

6+

7+~norsyr-torryn/nordics

8+

9+––

10+

11+[Twitter](https://twitter.com/UrbitCPH)

content/communities/urbit-dc.mdnew file+19

@@ -0,0 +1,19 @@

1++++

2+title = "DC Metro Urbit Meetup Group"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-dc.png"

5++++

6+

7+This is a DC/Northern Virginia/Southern Maryland Urbit discussion group.

8+

9+It is for Urbit users or the urbit-curious or people who like to think and talk about decentralization, independence, and freedom on the internet.

10+

11+We will socialize, discuss urbit and related topics, and support lab and learning activities.

12+

13+Find us on urbit chat at ~tillys-fasryp/nova-urbit-meetup-lobby-3347

14+

15+––

16+

17+[Meetup page](https://www.meetup.com/dc-urbit-meetup-group/)

18+

19+[Twitter](https://twitter.com/dcurbit)

content/communities/urbit-denver.mdnew file+19

@@ -0,0 +1,19 @@

1++++

2+title = "Urbit Denver"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-denver.png"

5++++

6+

7+While Urbit is the animating force behind this group, people of all interest levels & familiarity with the project - be they long-time users, or newcomers simply wondering what the heck Urbit is - are welcome & encouraged to attend these meet-ups. The conversations are lively and span a wide variety of topics, ranging from Urbit to philosophy, tech, crypto, the arts, health and well-being, and much more.

8+

9+Our goal is simply to build a community of people interested in the project and the future it envisions, in which members can freely connect and discuss the project and the various ideas & values adjacent to it.

10+

11+And for those wondering what the heck is Urbit? Urbit is an ambitious reimagining of what the internet can be; it is a virtual computer and peer-to-peer network, built on a philosophy of human-scale computing, where you own all your data and identity. Urbit strives to once again make the computer a useful tool under the control of the user, and not vice versa. Still confused? Stop by and we'll (try to) explain it.

12+

13+––

14+

15+~nospex-larsut/mile-high-mars

16+

17+[Meetup page](https://www.meetup.com/mile-high-mars-denver-urbit-group/)

18+

19+[Organizer's Twitter](https://twitter.com/OnAPersonaLevel)

content/communities/urbit-london.mdnew file+15

@@ -0,0 +1,15 @@

1++++

2+title = "Urbit London"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-london.jpg"

5++++

6+

7+Urbit London is a monthly, occasionally biweekly, meet-up series aiming to establish a long-lasting community within the London tech and cultural scene.

8+

9+––

10+

11+~tichus-holnet/urblon

12+

13+[Twitter](https://twitter.com/urblon)

14+

15+[Telegram](https://t.me/urblon)

content/communities/urbit-mst.mdnew file+13

@@ -0,0 +1,13 @@

1++++

2+title = "Urbit MST (Utah)"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-utah.png"

5++++

6+

7+Are you looking for more than the options presented to you?

8+

9+Come to our Urbit (MST) meetup. All are welcome. Bring a computer and we can onboard you with a planet and hosting for free on site. Whether you are new to Urbit or fluent in Hoon, come and meet others in Utah interested in Urbit.

10+

11+––

12+

13+[Website](https://urbitmst.org/)

content/communities/urbit-ny.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Urbit NY"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-ny.png"

5++++

6+

7+We love experimenting with Urbit & tinkering with Arvo, Hoon, & Nock

8+

9+––

10+

11+[Meetup page](https://www.meetup.com/Urbit-New-York/)

content/communities/urbit-paris.mdnew file+23

@@ -0,0 +1,23 @@

1++++

2+title = "Urbit Paris"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbitparis.png"

5++++

6+

7+Join us for our monthly Urbit meetups in Paris!

8+

9+Whether you're a tech enthusiast, an established Urbit aficionado, or a newcomer to the scene, our community is meant to welcome and engage everyone.

10+

11+If you're confused about what Urbit is, no worries, most people are at first. Drop by and we'll give you our best explanations of what Urbit is and how it's going to change the internet as we know it.

12+

13+We'll introduce Urbit, help you boot your own ship, and make sure you go back home all set!

14+

15+See you there!

16+

17+––

18+

19+~solsup-soplyd/urbit-paris

20+

21+[Twitter](https://twitter.com/urbitparis)

22+

23+[Meetup](https://www.meetup.com/urbit-paris/)

content/communities/urbit-seattle.mdnew file+14

@@ -0,0 +1,14 @@

1++++

2+title = "Urbit Seattle"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-seattle.png"

5++++

6+

7+Urbit is a simple, durable computer that you own 100% and forever. In this group, we'll discuss ongoing project developments, technical details, and how to use Urbit. With occasional speakers that will present on various topics.

8+

9+

10+––

11+

12+[Meetup page](https://www.meetup.com/urbit-seattle/)

13+

14+[Twitter](https://twitter.com/SeattleUrbit)

content/communities/urbit-sf.mdnew file+15

@@ -0,0 +1,15 @@

1++++

2+title = "Urbit SF"

3+description = ""

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-sf.png"

5++++

6+

7+Want to own and control the server side? Your digital identity, data and computation?

8+

9+So do we — so we're building Urbit. We set this group up for anyone excited about this kind of stuff, even those who think we're totally crazy.

10+

11+Come join us to talk about what the future of the internet might look like.

12+

13+––

14+

15+[Meetup page](https://www.meetup.com/urbit-sf/)

content/community/_index.mddeleted−5

@@ -1,5 +0,0 @@

1−+++

2−title = "Community"

3−sort_by = "weight"

4−template = "list.html"

5−+++

content/community/community-grants.mddeleted−14

@@ -1,14 +0,0 @@

1−+++

2−title = "Community Grants"

3−description = "Select Urbit address space grants for your group or community."

4−weight = 3

5−[extra]

6−hideprevious = "true"

7−hidenext = "true"

8−+++

9−

10−Interested in getting your community on Urbit? We are currently accepting applications for select groups to get started on Urbit together using an [invite pool](/using/id/creating-an-invite-pool).

11−

12−To get started, fill out the application below. Any information you share will be held privately, and only for the purpose of consideration for the grant.

13−

14−<iframe src="https://docs.google.com/forms/d/e/1FAIpQLSf_uD5fUw6xqoxtzUhSwURFYO57XQl067N3vEdy7_rTD8T2VQ/viewform?embedded=true" width="640" height="1394" frameborder="0" marginheight="0" marginwidth="0">Loading…</iframe>

content/community/governance.mddeleted−25

@@ -1,25 +0,0 @@

1−+++

2−title = "Governance"

3−description = "On the governance of the project, including both the senate of galaxies and the core developers."

4−aliases = ["/governance"]

5−weight = 4

6−[extra]

7−hideprevious = "true"

8−hidenext = "true"

9−+++

10−

11−Our goal is to design Urbit simply, such that as many decisions as possible are made by the architecture of the system itself – that is, code should be law whenever possible. Code can’t anticipate every eventuality, however, and so the system design must include mechanisms that allow decisions to be made outside of the code.

12−

13−Within Urbit, this form of governance is conducted by two groups: the senate of galaxies, and the body of core developers. The senate of galaxies is empowered to make changes to the solidity contracts which define Azimuth, Urbit’s PKI, by majority vote. This process is defined by the contracts themselves.

14−

15−An owner of a galaxy (or a delegate) can propose a new iteration of the contract logic. The proposal can then be voted on for a period of thirty days. Once that period is over, if at least a quarter of the galaxies has voted, and the majority is in favor, the old logic contract will hand over the reigns to the new one.

16−

17−In a similar process, document hashes can be proposed. While their off-chain documents can't be "technically enforced", this mechanism is useful for the Senate to record more abstract decisions.

18−

19−For off-chain process around proposals, as suggested by core developers, please see [senate.md](https://github.com/urbit/azimuth/blob/master/senate).

20−

21−The group of core developers manages Urbit’s [GitHub repository](https://github.com/urbit/), which controls Arvo, Urbit’s operating system. Changes and upgrades are decided upon by consensus.

22−

23−You can participate in the governance of the senate by acquiring a galaxy. If you would like to be involved with the governance of Arvo, check out our [developer guide](/docs/development/develop) to learn how you can contribute to core development.

24−

25−

content/community/hosting-a-meetup.mddeleted−82

@@ -1,82 +0,0 @@

1−+++

2−title = "Hosting a Meetup"

3−description = "Best practices for hosting your Urbit meetups."

4−weight = 2

5−[extra]

6−flatten_pagination = "true"

7−hidenext = "true"

8−hide_previous_title = "true"

9−+++

10−

11−There are already [a few](/community/meetups) Urbit meetups that take place in cities around the United States. Want to start a meetup in your home town? Consider these best practices.

12−

13−### Create the Meetup Group Online

14−

15−The most straightforward way to start a meetup group online, like on [meetup.com](www.meetup.com). Services like this offer messaging, calendaring, payments, discussion boards, and basic group profiles.

16−

17−There are other options available but, regardless of what you choose, there should be a public place on the Web for people to access the group.

18−

19−Group suggestions:

20−

21−- Meetup.com

22−- Google groups

23−- Dedicated Website

24−

25−### Spread the word

26−

27−It’s not much fun if people don’t actually show up, so it’s important to get the word out. Use your existing network to tell people about your event. Remember it takes time to build a community, so don’t be discouraged if only a few people show up at first. Post to social media and email your friends. Also, be sure to email [support@urbit.org](mailto:support@urbit.org), and we'll promote your meetup.

28−

29−Outreach methods:

30−

31−- Post to social media

32−- Email your friends

33−- Put up signs

34−

35−### Format

36−

37−Meetups are about sharing ideas and meeting like-minded people. There are a few formats that can help achieve this goal. As the organizer, take the lead and prepare ahead of time. Think of some topics for the group to discuss, and try to ensure that the conversation isn’t dominated by one or two people.

38−

39−Presentations and guided group discussions are great ways to share ideas. If you have a speaker for your event, coordinate ahead of time and make sure they have everything they will need to make a great presentation and ask them to arrive early to the event. If you have a speaker, be sure to record the talk so that it can be posted online.

40−

41−Format considerations:

42−

43−- Guided group discussion

44−- Presentation

45−

46−### Venue

47−

48−Your meeting location can determine the success of your event. Ideally, you’d want to be away from congested areas and find locations with good parking and transit options nearby. However, this isn’t always possible, so just do your best to accommodate. It’s also a good idea to locate the event near bars or restaurants so people can continue the conversation after the event officially ends.

49−

50−Location considerations:

51−

52−- Easily reachable

53−- Consider parking and distance to transit

54−- Check out public libraries

55−- Coworking spaces

56−- [peerspace.com](https://www.peerspace.com/)

57−

58−### Date and time

59−

60−Most people are able to attend meetups after work on non-holiday weekdays, between about 6-8pm. This isn’t true for everyone but it’s a good rule of thumb. It’s also a good idea to avoid holidays and days when there are large sporting events happening.

61−

62−Date considerations:

63−

64−- Weekdays

65−- Between 6pm and 8pm

66−- Avoid holidays and weekends

67−

68−### Stay consistent

69−

70−Like basically anything worth doing, meetups take time, patience, and consistency. Come prepared to engage with people and have a good time. The more often you can meet the stronger the community can become, so schedule meetups regularly.

71−

72−### Bonus

73−

74−Here are a few tips and tricks to consider with hosting a meetup. You don’t have to have all these things at your first meeting, but try adding them in as you go.

75−

76−- Names tags

77−- Door signs

78−- Projector

79−- Extension cords and power strips

80−- Video camera

81−- Lapel microphone

82−- Bring your own internet

content/community/meetups.mddeleted−47

@@ -1,47 +0,0 @@

1−+++

2−title = "Meetups"

3−aliases = ["/meetups"]

4−description = "Information on Urbit meetups and other community-led, Urbit IRL groups."

5−weight = 1

6−[extra]

7−flatten_pagination = "true"

8−hideprevious = "true"

9−hide_next_title = "true"

10−+++

11−

12−![](https://media.urbit.org/site/meetup1.jpg)

13−

14−Turns out that getting Urbit fans together in one room is pretty fun. Here's an incomplete list of community-led Urbit IRL groups. These events are generally informal and very approachable – feel free to dive in.

15−

16−Interested in hosting an Urbit event of your own? Follow our [guide to meetup best-practices](/community/hosting-a-meetup). Send an email to [support@urbit.org](mailto:support@urbit.org) and we'll list your meetup on this page.

17−

18−### Asia

19−

20−| Location | Contact information |

21−| :--------- | :------------------------------------------------ |

22−| Moscow, RU | [Timepad](https://urbitmoscow.timepad.ru/events/) |

23−

24−### Europe

25−

26−| Location | Contact information |

27−| :------------- | :---------------------------------------------------------------------------------------------- |

28−| Copenhagen, DK | [Twitter](https://twitter.com/UrbitCPH), [Meetup.com](https://www.meetup.com/Urbit-Copenhagen/) |

29−

30−### North America

31−

32−| Location | Contact information |

33−| :---------------- | :----------------------------------------------------------------------------------------------- |

34−| Phoenix, AZ | [Twitter](https://twitter.com/UrbitPHX), [Meetup.com](https://www.meetup.com/urbit-phx/) |

35−| San Francisco, CA | [Meetup.com](https://www.meetup.com/urbit-sf/) |

36−| New York, NY | [Meetup.com](https://www.meetup.com/Urbit-New-York/) |

37−| Toronto, ON | [Twitter](https://twitter.com/UrbitToronto), [Meetup.com](https://www.meetup.com/Urbit-Toronto/) |

38−| Eugene, OR | [Twitter](https://twitter.com/EugeneUrbit) |

39−| Austin, TX | [Meetup.com](https://www.meetup.com/Urbit-Austin/) |

40−| Denton, TX | [Twitter](https://twitter.com/UrbitDFW) |

41−| Seattle, WA | [Meetup.com](https://www.meetup.com/urbit-seattle/) |

42−

43−### Oceania

44−

45−| Location | Contact information |

46−| :--------- | :------------------------------------------------ |

47−| Sydney, AU | [Meetup.com](https://www.meetup.com/Urbit-Sydney) |

content/ecosystem/spotlight/2022-december.mdnew file+40

@@ -0,0 +1,40 @@

1++++

2+title = "December 2022"

3+date = "2022-11-29"

4+

5+[featured-1]

6+title = "UF Public"

7+description = "The best place to get the latest updates from the team at the Urbit Foundation."

8+image="https://interstellar.nyc3.digitaloceanspaces.com/battus-datsun/2022.11.07..19.39.22-Sig.png"

9+content = """

10+Join the new and improved Urbit Foundation group to get updates from the Urbit Foundation spanning infrastructure development, developer activity, ecosystem news, announcements, and ways to get involved.

11+

12+

13+"""

14+

15+[featured-2]

16+title = "Groups"

17+description = "The new Groups application from Tlon is officially available."

18+content = """

19+

20+Test drive the future of Urbit now with Tlon's initial release of of Groups. This version features improved discoverability with features like searching by nickname, and creating public, private, or secret groups.

21+

22+Groups is part of the new Landscape suite of applications, and integrates seamlessly with Talk, Gallery, and Notes.

23+

24+Join the [Tlon group](/groups/~nibset-napwyn/tlon-public) for more information.

25+

26+![](https://storage.googleapis.com/media.urbit.org/site/ecosystem/spotlight/groups.jpg)

27+

28+"""

29+

30+[featured-3]

31+

32+title = "Scene"

33+image=""

34+description = "Explore Urbit with tirrel's desktop app, Scene."

35+content = """

36+

37+Tirrel is developing an outside-the-browser Urbit experience geared towards content creators. Check out their vision for Urbit as a desktop application.

38+

39+"""

40++++

content/ecosystem/spotlight/2023-february.mdnew file+48

@@ -0,0 +1,48 @@

1++++

2+title = "February 2023"

3+date = "2023-02-01"

4+

5+[featured-1]

6+title = "Realm"

7+description = "Realm is a desktop Urbit interface from that offers a variety of integrated features."

8+image="https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/realm-hero.png"

9+content = """

10+

11+Realm proposes an Urbit experience that is outside the browser, running as a full-screen cross-platform native application. It offers features like shared application suites, built-in audio chatrooms, an integrated crypto wallet, as well as its own web browser.

12+

13+![](https://media.urbit.org/site/featured/realm-screenshot.jpg)

14+

15+Realm is the flagship product of Holium, who are also building out several collaboration tools akin to a cloud productivity suite for Urbit and Realm. These applications can be bundled together into unique spaces – desktop environments that have been configured for communities and teams.

16+

17+![](https:///media.urbit.org/site/ecosystem/applications/app-suite.png)

18+

19+Realm is currently in private alpha. Visit [holium.com](https://holium.com) to sign up for the invitation waitlist. In the meantime, you can also enjoy an [entertaining podcast](/podcasts/2023-01-24_reject-triviality) in which Holium founder `~lomder-librun` talks about his vision for Realm, amongst many other interesting topics.

20+

21+"""

22+

23+[featured-2]

24+title = "Native Planet"

25+description = "Native Planet is building Urbit-native hardware as well software which enables standalone Urbit home servers."

26+image="https://storage.googleapis.com/media.urbit.org/site/ecosystem/spotlight/native-planet-thumb.jpg"

27+content = """

28+

29+Native Planet is Urbit's first dedicated hardware company. Their first product, the [Tellurian](https://www.nativeplanet.io/hardware), is a turnkey Urbit computer that you can run at home and access anywhere thanks to Native Planet's open-source [software](https://www.nativeplanet.io/software).

30+

31+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/getting-started/native-planet.jpg)

32+

33+What's the point of having a physical Urbit computer, besides the fact that they look very cool?

34+

35+You get the best of both worlds: the accessibility of cloud hosting, with the ownership of running Urbit locally. Groundseg and Startram make your Urbit accessible to any networked device without the need to trust any cloud service provider.

36+

37+

38+"""

39+

40+[featured-3]

41+title = "Urbit for Idiots | Galen Wolfe-Pauly, Tlon Corporation"

42+description = "Tlon CEO Galen Wolfe-Pauly talks to the Boys Club ladies and expounds on the fundamentals of Urbit."

43+image=""

44+content = """

45+

46+Is Urbit a computer? Is owning 'space' on the internet valuable? What is Urbit? How is it different from the the existing internet? Galen and Boys Club get to the bottom of these evergreen topics.

47+"""

48++++

content/ecosystem/spotlight/2023-june.mdnew file+40

@@ -0,0 +1,40 @@

1++++

2+title = "June 2023"

3+date = "2023-06-05"

4+

5+[featured-1]

6+title = "Labyrinth DAO"

7+description = ""

8+image=""

9+content = """

10+

11+Labyrinth DAO is a new decentralized autonomous organization for investing in Urbit projects. Supported by [Tribute Labs](https://tributelabs.xyz/), Labyrinth DAO will foster the growth and development of Urbit as it paves the way for the new internet. Find Labyrinth DAO on [Twitter](https://twitter.com/labyrinth_dao) or connect at labyrinthdao.io to get involved.

12+

13+

14+"""

15+

16+[featured-2]

17+title = "Osmosis"

18+description = ""

19+image=""

20+content = """

21+

22+Holium’s AJ LaMarc (~larryx-woldyr) has built Urbit front-ends for Uniswap, Osmosis, and Safe. This means that you can now swap or hold tokens and access your multi-sig from the comfort of your Urbit. You don’t have to rely on centralized services to provide interfaces for your favorite web3 platforms. You can download these apps on your Urbit today.

23+

24+Get

25+[Osmosis](/applications/~larryx-woldyr/osmosis) |

26+[Uniswap](/applications/~larryx-woldyr/uniswap) |

27+[Safe](/applications/~larryx-woldyr/safe)

28+

29+"""

30+

31+[featured-3]

32+title = "Zorp"

33+description = ""

34+image=""

35+content = """

36+

37+Zorp has built a secure-by-design zero-knowledge virtual machine (zkVM) with a uniquely minimal software supply chain which utilizes Nock as its instruction set. Nock, Urbit’s low-level language, is a famously simple instruction set. That property aligns itself well with what you might create if you were designing a language from first principles to do zero-knowledge proofs. Zorp’s zkVM could unlock new possibilities for crypto and more. Check back at Zorp’s [website](https://zorp.io/) and [Twitter](https://twitter.com/ZorpZK) for more info.

38+

39+"""

40++++

content/ecosystem/spotlight/2023-may.mdnew file+50

@@ -0,0 +1,50 @@

1++++

2+title = "May 2023"

3+date = "2023-05-01"

4+

5+[featured-1]

6+title = "The Mars Review of Books"

7+description = "The Mars Review of Books is a magazine in print and on Urbit. The third issue is now available in print and on online."

8+image="https://storage.googleapis.com/media.urbit.org/site/ecosystem/spotlight/mrb3-thumb.png"

9+content = """

10+

11+The *Mars Review of Books*, a magazine in print and on Urbit, recently put out its third issue — with pieces from Sean Thor Conroe, Marc Hochstein, Miles Routledge, Peter Nimitz and more. And now for the first time, the *MRB* is selling digital and print subscriptions exclusively through Urbit.

12+

13+![Mars Review in Print](https://storage.googleapis.com/media.urbit.org/site/ecosystem/spotlight/mrb3.png)

14+

15+Using payment rails from [Studio](http://localhost:3000/applications/~tirrel/studio) by [Tirrel](https://tirrel.io/), you can now plug in your credit card and subscribe directly to content hosted on an Urbit owned and operated by the people producing the content (in this case, the ~bidbel star).

16+

17+Visit marsreview.org to subscribe to the magazine, buy a print copy of Issue 3, or read selected unpaywalled pieces online.

18+

19+

20+"""

21+

22+[featured-2]

23+title = "Portal"

24+description = "Find and curate Urbit apps, groups, and media from fellow Urbit users"

25+image="https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/portal.svg"

26+content = """

27+

28+Portal is a lot like this ecosystem section of the Urbit website, except *on Urbit*. It’s a great place to find Urbit apps, Urbit groups, and recent media about your favorite Urbit developers and community members.

29+

30+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/portal-screenshot.png)

31+

32+Because Portal is on Urbit, networking among peers is built in. Anyone using Portal can curate their own list of apps and groups, and display that to other Portal users. It’s a great proof of concept for the way decentralized curation can work, a lot of fun to use, and the perfect place to start for anyone trying out Urbit for the first time.

33+

34+You’ll have to check it out on Urbit at ~worpet-bildet/portal

35+

36+"""

37+

38+[featured-3]

39+title = "%blog"

40+description = "Host a blog on your urbit with this application from ~dachus-tiprel."

41+image="https://storage.googleapis.com/media.urbit.org/site/ecosystem/spotlight/blog-thumb.png"

42+content = """

43+

44+Blog is just what it sounds like. A new tool from Uqbar, the app lets anyone on Urbit spin up and customize a blog that displays to the net at an auto-generated URL. Nothing could be breezier. Plus it’s got payments through Uqbar and group-blogging settings on the roadmap. Find out more about it on its [creator's blog](https://dachus-tiprel.tlon.network/blog/introducing-blog).

45+

46+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/ecosystem/applications/blog.png)

47+

48+Download it at ~hanrut-sillet-dachus-tiprel/blog and let the world know what’s on your mind. Bonus feature: a simple command allows you to automatically publish the URL of your latest blog entry to the notorious [Rumors](applications/~paldev/rumors) app.

49+"""

50++++

content/events/2021-04-27-bitcoin-launch.md+1−1

@@ -24,4 +24,4 @@ We’d like to take a moment to show it off, and discuss the future of commerce

24

25The event will have a live stream on Youtube, and a live-chat on Urbit, links to come.

26

27−Join the Bitcoin dev conversation in the Urbitcoiners group: [~pindet-timmut/urbitcoin-cash](web+urbitgraph://group/~pindet-timmut/urbitcoin-cash)

27+Join the Bitcoin dev conversation in the Urbitcoiners group: [~pindet-timmut/urbitcoin-cash](web+urbitgraph://group/~pindet-timmut/urbitcoiners)

content/events/2023-01-28-urbit-meetup-christchurch.mdnew file+21

@@ -0,0 +1,21 @@

1++++

2+title = "Urbit Meetup - Christchurch"

3+starts = "2023-01-28T10:30:00"

4+ends = "2023-01-28T12:00:00"

5+timezone = "Pacific/Auckland"

6+location = "363 St Asaph Street, Christchurch"

7+image = "https://silo.sgp1.digitaloceanspaces.com/silo/dinnul-namrud/2023.1.20..04.41.17-kishan-modi-9Pq4o76GpAo-unsplash.jpg"

8+registration_url = "https://chchurbit.eventbrite.com"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~dinnul-namrud"

16+

17++++

18+

19+The first meetup in Christchurch is at The Lotus Heart on the 28th January at 10:30am. Stick around afterwards for a drink and bite to eat if you desire.

20+

21+Please RSVP to the Meetup. Friends are most welcome!

content/events/2023-01-31-urbit-meetup-krakow.mdnew file+26

@@ -0,0 +1,26 @@

1++++

2+title = "Urbit Meetup - Kraków"

3+starts = "2023-01-31T19:00:00"

4+ends = "2023-01-31T22:00:00"

5+timezone = "Europe/Amsterdam"

6+location = "HEVRE - Beera Meiselsa 18, 31-058 Kraków, Poland"

7+image = "https://kongres-magazine.eu/wp-content/uploads/2021/11/hevre_krakow-1.png"

8+registration_url = "https://www.meetup.com/urbit-sf/events/291029359?utm_medium=referral&utm_campaign=share-btn_savedevents_share_modal&utm_source=link"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~dalweb-donfun"

16+

17+[[hosts]]

18+patp = "~wistec-bisrum"

19+

20++++

21+

22+The first meetup in Poland will be in Kraków on Tuesday the 31st of January. You are welcome to join ~dalweb-donfun and ~wistec-bisrum at the Hevre bar from 19:00 for some drinks and good Urbit discussions. Wether you are new to Urbit or already a full-time Hooner be welcome and bring some friends.

23+

24+Please RSVP to the Meetup.

25+

26+There is a planet waiting for you at Hevre.

content/events/2023-02-23-urbit-meetup-berlin.mdnew file+27

@@ -0,0 +1,27 @@

1++++

2+title = "Urbit Meetup - Berlin"

3+starts = "2023-02-23T20:00:00"

4+ends = "2023-02-23T23:00:00"

5+timezone = "Europe/Amsterdam"

6+location = "c-base - Rungestraße 20 · Berlin, Deutschland"

7+image = "https://upload.wikimedia.org/wikipedia/commons/6/60/Dr._MeTaMiNd_robolab_c-base_spacestation_hackerspace_Berlin_%2812933669604%29.jpg"

8+registration_url = "https://www.meetup.com/urbit-berlin/events/291660889/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~bithex-topnym"

16+

17++++

18+

19+The first Urbit Berlin meetup at our new location: c-base!

20+

21+If you are new to Urbit, this is a great time and place to learn more.

22+

23+For this first meetup we will simply meet, mingle and discuss new and exciting things happening on the network, like: App School Live, Uqbar, Scene, Native Planet, and the upcoming Volcano Summit in El Salvador.

24+

25+The vibe at c-base is great and retro-technological, there is an bar and we have a table booked just for us. There will be other Meetups on various technological and futuristic topics happening at the same time if you like to mingle around.

26+

27+Please RSVP to the Meetup.

content/events/2023-03-05-meetup-el-salvador.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+title = "Urbit Meetup – El Salvador"

3+starts = "2023-03-05T19:00:00"

4+ends = "2023-03-05T22:00:00"

5+timezone = "America/El_Salvador"

6+location = "Urbit Mansion - San Salvador"

7+image = "https://elsalvador.travel/img/slide04.jpg"

8+registration_url = "https://www.meetup.com/urbit-sf/events/290917526"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~nilrun-mardux"

16+

17+[[hosts]]

18+patp = "~rovnys-ricfer"

19+

20++++

21+

22+Just before we all gather for the [Urbit Volcano Summit](https://summit.urbit.org) we are inviting all Urbit people that are already in town and curious locals to an Urbit meetup at the Urbit Mansion in San Salvador. The exact location will be shared with the registered attendees a few days before.

23+

24+Drinks will be provided. See you there.

content/events/2023-03-25-urbit-meetup-christchurch.mdnew file+21

@@ -0,0 +1,21 @@

1++++

2+title = "Urbit Meetup - Christchurch"

3+starts = "2023-03-25T10:30:00"

4+ends = "2023-03-25T12:00:00"

5+timezone = "Pacific/Auckland"

6+location = "363 St Asaph Street, Christchurch"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-christchurch.jpg"

8+registration_url = "https://chchurbit.eventbrite.com"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~dinnul-namrud"

16+

17++++

18+

19+The next meetup in Christchurch is at The Lotus Heart on the 25th March at 10:30am. Stick around afterwards for a drink and bite to eat if you desire.

20+

21+Please RSVP to the Meetup. Friends are most welcome!

content/events/2023-04-18-urbit-lisbon.mdnew file+19

@@ -0,0 +1,19 @@

1++++

2+title = "Urbit Meetup - Lisbon"

3+starts = "2023-04-20T19:00:00"

4+ends = "2023-04-20T22:00:00"

5+timezone = "Europe/Lisbon"

6+location = "Quiosque São Paulo – Praça São Paulo, 1200-194 Lisboa"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/lisbon.jpeg"

8+registration_url = "https://www.meetup.com/urbit-sf/events/292978187"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~dalweb-donfun"

16+

17++++

18+

19+Around in Lisbon this Thursday? ~dalweb-donfun will be hosting a meetup at 7pm. Come by for a drink with other urbiters. RSVP to the meetup event or send ~dalweb-donfun a message on the network. See you on Thursday!

content/events/2023-04-27-urbit-meetup-berlin.mdnew file+27

@@ -0,0 +1,27 @@

1++++

2+title = "Urbit Meetup - Berlin"

3+starts = "2023-04-27T20:00:00"

4+ends = "2023-04-27T22:00:00"

5+timezone = "Europe/Amsterdam"

6+location = "MUTED HORN – Flughafenstraße 49, 12053 Berlin"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/DSCF1208_09_10.jpg"

8+registration_url = "https://www.meetup.com/urbit-berlin/events/293050078/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~bithex-topnym"

16+

17++++

18+

19+If you are new to Urbit, this is a great time and place to learn more.

20+

21+Topic: open grants – what do they say about the future of Urbit and what kind of knowledge do you need to start building on them?

22+

23+As always, we are also helping new people get on Urbit to try it out, answer technical questions and discuss philosophical questions around Urbit.

24+

25+We have temporarily changed locations to Muted Horn, one of the best craft beer pubs in Northern Europe. It is also possible to order food from nearby restaurants and eat there. If the weather is great we will be sitting outside.

26+

27+Please RSVP to the Meetup.

content/events/2023-04-27_urbit-austin-meetup-consensus.mdnew file+16

@@ -0,0 +1,16 @@

1++++

2+title = "Urbit Austin – Consensus 2023"

3+starts = "2023-04-27T18:30:00"

4+ends = "2023-04-27T20:00:00"

5+timezone = "America/Chicago"

6+location = "Garage – 503 Colorado St · Austin, TX"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/garage-austin.jpg"

8+registration_url = "https://www.meetup.com/urbit-austin/events/293135783"

9+description = "Urbit Austin meetup @ Consensus 2023 presented by the Urbit Foundation"

10+dark = true

11+

12++++

13+

14+Come hangout, drink cocktails at our open bar and talk Urbit during Consensus 2023. We will most likely have a short presentation or two from leaders of the top projects being built. We expect attendance from the Urbit Foundation, Tlon, Zorp, Uqbar, Holium, Assembly Capital and more. Rumor has it there might be free Urbit hats too.

15+

16+If you haven't joined the network yet, bring a computer and we will help you get set up. Other than that we'll have some food and good tunes as well. See you there!

content/events/2023-05-10_urbit-meetup-berlin.mdnew file+25

@@ -0,0 +1,25 @@

1++++

2+title = "Urbit Meetup - Berlin"

3+starts = "2023-05-10T20:00:00"

4+ends = "2023-05-10T22:00:00"

5+timezone = "Europe/Amsterdam"

6+location = "MUTED HORN – Flughafenstraße 49, 12053 Berlin"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/DSCF1208_09_10.jpg"

8+registration_url = "https://www.meetup.com/urbit-berlin/events/293192363/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~bithex-topnym"

16+

17++++

18+

19+We didn't get to cover all we wanted last time and there were lots of outstanding questions, so let's do another extra meetup, rather than wait another month!

20+

21+Tentative topic: Urbit identity, art, and culture. What kind of expression is Urbit uniquely suited for? What would be some cool grants we could apply for?

22+

23+We have temporarily changed locations to Muted Horn, one of the best craft beer pubs in Northern Europe with a cozy vibe. It is also possible to order food from nearby restaurants and eat there. If the weather is great we will be sitting outside.

24+

25+Please RSVP to the Meetup.

content/events/2023-05-14_urbit-meetup-london.mdnew file+23

@@ -0,0 +1,23 @@

1++++

2+title = "Urbit Meetup - London"

3+starts = "2023-05-14T18:00:00"

4+ends = "2023-05-14T20:00:00"

5+timezone = "Europe/London"

6+location = "Cleopatra's Needle – London"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-london.jpg"

8+registration_url = ""

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~tichus-holnet"

16+[[hosts]]

17+patp = "~dalweb-donfun"

18+

19++++

20+

21+This Sunday we'll be doing a meeting up at cleopatra's needle. You'll recognise us by Urbit caps and citing Hoon outloud. See you all on Sunday, byob. Rach out to us on Urbit in case you can't find us.

22+

23+![Picture](https://storage.googleapis.com/media.urbit.org/site/events/2023-05-11%2011.45.27.jpg)

content/events/2023-05-18_urbit-denver-meetup.mdnew file+19

@@ -0,0 +1,19 @@

1++++

2+title = "Urbit Meetup - Denver"

3+starts = "2023-05-18T18:30:00"

4+ends = "2023-05-18T20:30:00"

5+timezone = "US/Mountain"

6+location = "Avanti Food & Beverage - 3200 N. Pecos St, Denver, CO"

7+image = "https://urbits3bucket.fra1.digitaloceanspaces.com/UrbMeet6.jpg"

8+registration_url = "https://www.meetup.com/mile-high-mars-denver-urbit-group/events/293433336/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~nospex-larsut"

16+

17++++

18+Group will meet at the upstairs tables towards the rear of the venue - just take a left when you get to the top of the stairs. Message on the meetup app or through Urbit/Pongo (~nospex-larsut) if unsure.

19+Please RSVP to the Meetup.

content/events/2023-05-18_urbit-miami-meetup.mdnew file+20

@@ -0,0 +1,20 @@

1++++

2+title = "Urbit Meetup - Miami"

3+starts = "2023-05-18T21:00:00"

4+ends = "2023-05-19T03:00:00"

5+timezone = "America/New_York"

6+location = "Eagle Room @ The Broken Shaker 9PM - 3AM"

7+image = "https://i.imgur.com/8x7hpNv.jpg"

8+registration_url = "https://www.meetup.com/urbit-miami/events/293537002/"

9+description = "Miamese Martian congregation parties all night long. Drinks, Food, DJ. Semi-formal attire."

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~wolfun-batrex"

16+

17++++

18+Group will meet in the Eagle Room. Ask the hostess for directions. Event Space Aesthetic is Spectral South-Beach. DJ comes at 10PM. Bring proof of planet for Miamese Martians.

19+

20+Please RSVP to the Meetup page by clicking the RSVP button above.

content/events/2023-05-27_urbit-meetup-london.mdnew file+21

@@ -0,0 +1,21 @@

1++++

2+title = "Urbit London x Giga"

3+starts = "2023-05-27T19:00:00"

4+ends = "2023-05-27T00:00:00"

5+timezone = "Europe/London"

6+location = "HAMPTON TOWER - CANARY WHARF"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/Screenshot%202023-05-26%20at%2007.14.48.png"

8+registration_url = "https://lu.ma/a2ksogr8"

9+description = "urbLon × giga present: Water Wellness Retreat"

10+dark = true

11+darken_image = "true"

12+

13+

14+[[hosts]]

15+patp = "~tichus-holnet"

16+[[hosts]]

17+patp = "~narpel-machul"

18+

19++++

20+

21+Next Saturday, make your way to Hampton Tower in Canary Wharf. You will be escorted to the Giga Corp premises, in which the 7th Urbit London meet-up will take place. Expect drinks, discussion, and much more. https://t.me/urblon

content/events/2023-05-27_urbit-meetup-mst.mdnew file+20

@@ -0,0 +1,20 @@

1++++

2+title = "Urbit Meetup - Utah MST"

3+starts = "2023-05-28T17:00:00"

4+ends = "2023-05-28T19:00:00"

5+timezone = "America/Phoenix"

6+location = "LION'S PARK – 950 W 1280 N ST, PROVO, UTAH"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-utah.png"

8+registration_url = "https://urbitmst.org/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+

13+[[hosts]]

14+patp = "~sonmeg-tomdex"

15+

16++++

17+

18+Are you looking for more than the options presented to you?

19+

20+Come to our Urbit (MST) meetup. All are welcome. Bring a computer and we can onboard you with a planet and hosting for free on site. Whether you are new to Urbit or fluent in Hoon, come and meet others in Utah interested in Urbit.

content/events/2023-06-03-urbit-meetup-christchurch.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+title = "Urbit Meetup - Christchurch"

3+starts = "2023-06-03T10:30:00"

4+ends = "2023-06-03T12:00:00"

5+timezone = "Pacific/Auckland"

6+location = "363 St Asaph Street, Christchurch"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-christchurch.jpg"

8+registration_url = "https://www.meetup.com/urbit-christchurch/events/293265373"

9+description = ""

10+dark = true

11+darken_image = "true"

12+

13+[[hosts]]

14+patp = "~dinnul-namrud"

15+

16++++

17+

18+The next meetup in Christchurch is at The Lotus Heart on the 3rd June at 10:30am. Stick around afterwards for a drink and bite to eat if you desire.

19+

20+Please [RSVP](https://www.meetup.com/urbit-christchurch/events/293265373) to the Meetup. Friends are most welcome!

21+

22+

23+

24+

content/events/2023-06-08_urbit-meetup-berlin.mdnew file+25

@@ -0,0 +1,25 @@

1++++

2+title = "Urbit Meetup - Berlin"

3+starts = "2023-06-08T20:00:00"

4+ends = "2023-06-08T22:00:00"

5+timezone = "Europe/Amsterdam"

6+location = "MUTED HORN – Flughafenstraße 49, 12053 Berlin"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/DSCF1208_09_10.jpg"

8+registration_url = "https://www.meetup.com/urbit-berlin/events/293860274/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~bithex-topnym"

16+

17++++

18+

19+If you are new to Urbit, this is a great time and place to learn more.

20+

21+Topic: App building

22+

23+We are at Muted Horn, one of the best craft beer pubs in Northern Europe with a cozy vibe. It is also possible to order food from nearby restaurants and eat there. If the weather is great we will be sitting outside.

24+

25+Please RSVP to the Meetup.

content/events/2023-06-08_urbit-meetup-prague.mdnew file+39

@@ -0,0 +1,39 @@

1++++

2+title = "Urbit Meetup Prague"

3+starts = "2023-06-08T14:00:00"

4+ends = "2023-06-08T18:00:00"

5+timezone = "Europe/Amsterdam"

6+location = "loftbubny – U Papírny, 170 00 Praha 7-Holešovice, Czechia"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/59f4fabd-ac53-4c0d-b578-04d2fe6d4b09.webp"

8+registration_url = "https://lu.ma/urbitprague"

9+description = "Urbit Meetup during Prague Blockchain Week at L2Loft"

10+dark = true

11+darken_image = "true"

12+

13+[[hosts]]

14+name = "Owen Barnes"

15+patp = "~locruc-fonmec"

16+

17++++

18+Urbit - A clean-slate OS and network for the 21st century.

19+

20+The meetup takes place as part of the [L2Loft](https://lu.ma/l2loft) initiative.

21+

22+Date: Thursday 8 June, 2023

23+Expected time: 14:00 - 16:00 (it may change!)

24+

25+**Schedule:**

26+

27+[Owen Barnes ](https://twitter.com/temporalwave) (~locruc-fonmec) - The Future of Apps

28+

29+*More TBA*

30+

31+Register for the event and stay tuned for more information! You can also join the L2Loft [Telegram group](https://t.me/l2loft) or follow [@L2Loft on Twitter](https://twitter.com/L2Loft).

32+

33+---

34+

35+Urbit is a new kind of computer that you can own completely in ways that matter: networking, identity, & data.

36+

37+We realized that in order to fix the internet, we had to build a new computer from scratch. Good thing we started over a decade ago.

38+

39+Today, Urbit is a real system with thousands of users that are building all kinds of communities, software, DAOs, and more. And it’s getting better every day.

content/events/2023-06-12-developer-week.mdnew file+95

@@ -0,0 +1,95 @@

1++++

2+title = "Urbit Developer Week"

3+starts = "2023-06-12T09:00:00"

4+ends = "2023-06-16T17:00:00"

5+timezone = "America/Los_Angeles"

6+location = "Online Event"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/dev-week-gif.gif"

8+registration_url = "https://www.meetup.com/urbit-sf/"

9+description = "2nd Dev-Week – full of talks, blogs and announcements"

10+dark = true

11+

12++++

13+

14+After the success of our last developer week, we’re hosting another one this year from June 12th to June 16th. This will be a week of online only conversations, build parties, AMAs, blog posts, and other content.

15+

16+There will be watch parties for all streams in the Hacker House on gather.town. Instructions for joining can be found in the [Urbit Foundation group](/groups/~halbex-palheb/uf-public).

17+

18+## Schedule

19+### Kicking Off Developer Week

20+*Time:* Monday June 12th – 9am Pacifc | 6pm CEST

21+

22+We will kick off Urbit developer week with an introduction by ~wolref-podlex, ~lagrev-nocfep & ~dalweb-donfun. They will give you a sneak peek into what's awaiting you at Assembly this year, give you an update about the Foundation and tell you all about how to get involved with Urbit right now. Some very exciting announcements are waiting for you here.

23+

24+[Meetup](https://www.meetup.com/urbit-sf/events/293888554/) | [Youtube](https://www.youtube.com/watch?v=38K2RfaScL8)

25+

26+### %Lick by ~mopfel-winrux

27+*Time:* Monday June 12th – noon Pacifc | 9pm CEST

28+

29+~mopfel-winrux, lead developer at [Native Planet](/organizations/nativeplanet), has taken it upon himself to build a hardware vane that lets your Urbit directly communicate with the machine it's running on. This opens up an array of new possibilities. In this talk ~lagrev-nocfep will interview ~mopfel-winrux about his progress, and we might even see a demo.

30+

31+[Meetup](https://www.meetup.com/urbit-sf/events/294013274/) | [Youtube](https://www.youtube.com/watch?v=TDROdmVW7_0)

32+

33+### Core Roadmap

34+*Time:* Tuesday June 13th – 9am Pacifc | 6pm CEST

35+

36+In this talk our CTO ~rovnys-ricfer, together with ~master-morzod & ~wolref-podlex, will give an update on the Roadmap and talk about other news concerning Urbit’s core development. There are some exciting announcements coming up.

37+

38+[Meetup](https://www.meetup.com/urbit-sf/events/293893446/) | [Youtube](https://www.youtube.com/watch?v=vmqn36RtnBk)

39+

40+### Core Developers AMA

41+*Time:* Tuesday June 13th – 10am Pacifc | 7pm CEST

42+

43+Always wanted to ask the core developers something? In this AMA they will be available to answer any questions you have. Join ~rovnys-ricfer, ~wicdev-wisryt, ~palfun-foslup & ~master-morzod on Tuesday right after the Roadmap presentation.

44+

45+[Meetup](https://www.meetup.com/urbit-sf/events/293893486/) | [Youtube](https://www.youtube.com/watch?v=BolurhVR6N4)

46+

47+### Portal

48+*Time:* Tuesday June 13th – noon Pacifc | 9pm CEST

49+

50+In this talk ~foddur-hodler and ~dilryd-mopreg from [Portal](/applications/~worpet-bildet/portal) will update you on their latest developments. They are excited to share their experiences using solid state subscriptions, to present their ideas on what they're calling *the everything graph*, and to explain why they're "composability-maxxing."

51+

52+[Meetup](https://www.meetup.com/urbit-sf/events/294013283/) | [Youtube](https://www.youtube.com/watch?v=6J8-jlqz2r4)

53+

54+### Core School Preview: Jetting

55+*Time:* Wednesday June 14th – 9am Pacifc | 6pm CEST

56+

57+Core School approacheth. To whet your appetite for the inner mysteries of the kernel, we will discuss how jet-accelerated code works and how to write jets for arms. Join ~lagrev-nocfep & ~rovnys-ricfer at a preview of Core School content. And make sure to check out our [CSL page](https://developers.urbit.org/courses/csl) for more details.

58+

59+[Meetup](https://www.meetup.com/urbit-sf/events/294013289/) | [Youtube](https://www.youtube.com/watch?v=i1GRoY3QDdU)

60+

61+### %Eyre by ~palfun-foslup

62+*Time:* Wednesday June 14th – noon Pacifc | 9pm CEST

63+

64+Urbit solves a lot of problems with digital identity. But its HTTP server, Eyre, hasn't gotten the memo yet. Two new Eyre features will make identifying incoming HTTP requests much nicer, letting developers deliver richer experiences, even on publicly accessible web pages. Join ~palfun-foslup at this session about %Eyre.

65+

66+[Meetup](https://www.meetup.com/urbit-sf/events/294013295/) | [Youtube](https://www.youtube.com/watch?v=eN_oh_orCcg)

67+

68+### Native UI

69+*Time:* Thursday June 15th – 9am Pacifc | 6pm CEST

70+

71+Using JavaScript on Urbit has always felt a bit off. ~hastuc-dibtux is going to change this with his Urbit Native UI project. Rendering Hoon as a frontend? Piece of cake.

72+In this talk ~palfun-foslup will interview ~hastuc-dibtux about his project. Don’t miss the future of UIs.

73+

74+[Meetup](https://www.meetup.com/urbit-sf/events/293893568/) | [Youtube](https://www.youtube.com/watch?v=1l9dnppQO1U)

75+

76+### Integrating Uqbar Transactions

77+*Time:* Thursday June 15th – noon Pacifc | 9pm CEST

78+

79+Want to know how to integrate Uqbar smart contracts with your app? In this presentation Uqbar's lead developer ~hodzod-walrus will walk you through what it takes to integrate your app with Uqbar's smart contracts. It's easier than you think.

80+

81+[Meetup](https://www.meetup.com/urbit-sf/events/294013302/) | [Youtube](https://www.youtube.com/watch?v=Q-aZZabT6_M)

82+

83+### Vaporware

84+*Time:* Friday June 16th – 9am Pacifc | 6pm CEST

85+

86+In this talk ~harden-hardys will prove that [Vaporware](https://vaporware.network) is not actually vaporware. Get to know what he and his team are up to and you might even see a glimpse or more of their first public project, *Tharsis*.

87+

88+[Meetup](https://www.meetup.com/urbit-sf/events/294013311/) | [Youtube](https://www.youtube.com/watch?v=bh5U5q9Qp_k)

89+

90+### What to Build on Urbit and Why

91+*Time:* Friday June 16th – noon Pacifc | 9pm CEST

92+

93+AJ or ~larryx-woldyr recently launched a suite of Urbit-hosted front-ends for [Osmosis](/applications/~larryx-woldyr/osmosis), [Uniswap](/applications/~larryx-woldyr/uniswap) and [Safe](/applications/~larryx-woldyr/safe). In this talk he'll dive into why he thinks you should build on Urbit and what you should build on it. Tune in to his closing talk of Developer Week on Friday.

94+

95+[Meetup](https://www.meetup.com/urbit-sf/events/294013323/) | [Youtube](https://www.youtube.com/watch?v=AARwK5cGavw)

content/events/2023-06-15_urbit-denver-meetup.mdnew file+19

@@ -0,0 +1,19 @@

1++++

2+title = "Urbit Meetup - Denver"

3+starts = "2023-06-15T18:30:00"

4+ends = "2023-06-15T20:30:00"

5+timezone = "US/Mountain"

6+location = "Federal Bar & Grill - 2544 Federal Blvd, Denver, CO"

7+image = "https://urbits3bucket.fra1.digitaloceanspaces.com/UrbMeet7.jpg"

8+registration_url = "https://www.meetup.com/mile-high-mars-denver-urbit-group/events/293937089/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+youtube = ""

13+

14+[[hosts]]

15+patp = "~nospex-larsut"

16+

17++++

18+Will have a table reseerved to accommodate number of RSVPs; just ask for Adam.

19+Please RSVP to the Meetup.

content/events/2023-06-24-urbit-meetup-christchurch.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+title = "Urbit Meetup - Christchurch"

3+starts = "2023-06-24T10:30:00"

4+ends = "2023-06-24T12:00:00"

5+timezone = "Pacific/Auckland"

6+location = "363 St Asaph Street, Christchurch"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-christchurch.jpg"

8+registration_url = "https://www.meetup.com/urbit-christchurch/events/294172584/"

9+description = ""

10+dark = true

11+darken_image = "true"

12+

13+[[hosts]]

14+patp = "~dinnul-namrud"

15+

16++++

17+

18+The next meetup in Christchurch is at The Lotus Heart on the 24th June at 10:30am. Stick around afterwards for a drink and bite to eat if you desire.

19+

20+Please [RSVP](https://www.meetup.com/urbit-christchurch/events/294172584/) to the Meetup. Friends are most welcome!

21+

22+

23+

24+

content/events/2023-06-29-Urbit-Paris-Meetup-1.mdnew file+30

@@ -0,0 +1,30 @@

1++++

2+title = "Urbit Meetup in Paris"

3+starts = "2023-06-29T18:30:00"

4+ends = "2023-06-29T21:30:00"

5+timezone = "Europe/Amsterdam"

6+location = "La Fièvre, 108 Rue Oberkampf, 75011 Paris"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/urbitParis-meetup-1.png"

8+registration_url = "https://www.meetup.com/urbit-paris/events/293962806/"

9+description = "Urbit Paris - Meetup #1"

10+dark = true

11+darken_image = "true"

12+

13+[[hosts]]

14+name = ""

15+patp = "~solsup-soplyd"

16+

17++++

18+Curious what the future of the Internet looks like?

19+

20+Join us on June 29th in Paris!

21+

22+Whether you're a tech enthusiast, an established Urbit aficionado, or a newcomer to the scene, our community is meant to welcome and engage everyone.

23+

24+If you're confused about what Urbit is, no worries, most people are at first. Drop by and we'll give you our best explanations of what Urbit is and how it's going to change the internet as we know it.

25+

26+We'll introduce Urbit, help you boot your own ship and make sure you go back home all set!

27+

28+In the meantime, you can join us on [Twitter](https://wwww.twitter.com/urbitparis)!

29+

30+See you there!

content/events/2023-07-01_urbit-meetup-mst.mdnew file+23

@@ -0,0 +1,23 @@

1++++

2+title = "Urbit Meetup - Utah MST"

3+starts = "2023-07-01T10:00:00"

4+ends = "2023-07-01T11:00:00"

5+timezone = "America/Phoenix"

6+location = "Maeser Park – 451 E 600 S, Provo, UT 84606"

7+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/communities/urbit-utah.png"

8+registration_url = "https://urbitmst.org/"

9+description = "Our third meetup in Utah"

10+dark = true

11+darken_image = "true"

12+

13+[[hosts]]

14+name = "Lyman"

15+patp = "~sonmeg-tomdex"

16+

17++++

18+

19+Are you looking for more than the options presented to you?

20+

21+Come to our Urbit (MST) meetup. All are welcome. Bring a computer and we can onboard you with a planet and hosting for free on site. Whether you are new to Urbit or fluent in Hoon, come and meet others in Utah interested in Urbit.

22+

23+This will be our first morning meetup, we will have donuts. Bring your friends. You are invited.

content/events/2023-07-20-Urbit-Paris-Meetup-ethcc.mdnew file+53

@@ -0,0 +1,53 @@

1++++

2+title = "𝓣𝓱𝓮 𝓢𝓾𝓶𝓶𝓮𝓻 𝓢𝓸𝓲𝓻𝓮𝓮 - Paris ETHCC"

3+starts = "2023-07-20T19:00:00"

4+ends = "2023-07-21T1:00:00"

5+timezone = "Europe/Amsterdam"

6+location = "Le Comptoir Général"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/parisian-tweet-v2.gif"

8+registration_url = "https://lu.ma/parissoiree"

9+description = "Urbit Summer Soiree Paris @ETHCC"

10+dark = true

11+darken_image = "false"

12+

13+[[hosts]]

14+name = "Thomas"

15+patp = "~dalweb-donfun"

16+

17+[[hosts]]

18+name = "Ted"

19+patp = "~rovnys-ricfer"

20+

21+[[hosts]]

22+name = "Sam"

23+patp = "~tidren-nosryg"

24+

25+[[hosts]]

26+name = "Shad (giga)"

27+

28+[[guests]]

29+name = "Illia (co-founder Near)"

30+

31++++

32+Presented by Urbit | giga | NEAR

33+An evening of salacious chatter and good friends under the night sky and the peering eye of the tower.

34+

35+Join us on July 20th with other like minds as we manifest the reality around us, drinking and eating till we can no more.

36+

37+At 19:30 we will record a live episode of the [ZeroK podcast](https://www.youtube.com/@zero-k-podcast/videos) between [Ted Blackman](https://twitter.com/rovnys) (CTO Urbit Foundation) & [Illia Polosukhin](https://twitter.com/ilblackdragon) (CEO Near).

38+

39+RSVP necessary.

40+

41+*NB. Due to high demand, please [signup](https://lu.ma/parissoiree) early and consider coming before 19:45 to avoid any disappointment.*

42+

43+![Foto](https://storage.googleapis.com/media.urbit.org/site/events/luma-parisian-event.jpg)

44+

45+“In the parties which she gave, since I could not imagine the guests as having any bodies, any moustaches, any boots, as making any utterances that were commonplace, or even original in a human and rational way, this whirlpool of names, introducing less material substance than would a phantom banquet or a spectral ball, round that statuette in Dresden china which was Madame de Guermantes, kept for her palace of glass the transparence of a showcase.

46+

47+Then, after Saint-Loup had told me various anecdotes about his cousin’s chaplain, her gardener, and the rest, the Hôtel de Guermantes had become—as the Louvre might have been in days gone by—a kind of castle, surrounded, in the very heart of Paris, by its own domains, acquired by inheritance, by virtue of an ancient right that had quaintly survived, over which she still enjoyed feudal privileges.”

48+

49+[Urbit](https://urbit.org/) is a new kind of computer that you can own completely in ways that matter: networking, identity, & data. It's a clean-slate operating system, p2p network and persistent identity.

50+

51+[giga](https://gigaver.se/) is a hardcore marketing and ecosystem firm bringing projects and networks to the spotlight. Email us today to learn how we take projects from the deep dark depths and put them on a pedestal.

52+

53+[NEAR](https://near.org/) allows you to effortlessly create and distribute innovative decentralized apps across any blockchain, while helping build a more open web, with the NEAR Blockchain Operating System (BOS).

content/events/2023-08-16_reassembly.mdnew file+22

@@ -0,0 +1,22 @@

1++++

2+title = "Reassembly 2023"

3+starts = "2023-08-16T09:00:00"

4+ends = "2023-08-18T19:00:00"

5+timezone = "America/Phoenix"

6+location = "The Colony Building 211 West 19th Street Cheyenne, WY 82001 United States"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/https___cdn.evbuc.com_images_517157329_547708747059_1_original.jpeg"

8+registration_url = "https://www.eventbrite.com/e/reassembly-2023-tickets-637686015037"

9+description = "Reassembly 2023, hosted by Tacen, features focused discussions on clean-slate OS, next-generation networks, and the future of computing."

10+dark = true

11+darken_image = "true"

12+

13++++

14+Tacen is proud to host Reassembly 2023 in Cheyenne, WY! Join us August 16-18 for focused discussions and exciting presentations on clean-slate OS, next-generation networks, and the future of modern computing.

15+

16+We will be bringing world-class experts to present their big ideas and new breakthroughs regarding all things related to the Urbit universe. Don’t miss this one-of-a-kind chance to see everyone gathered all in one place.

17+

18+Breakfast, lunch and refreshments provided for attendees. Details on accommodations group rates, schedules, and online viewership to follow.

19+

20+Confirmed speakers: [~hodzod-walrus](https://urbit.org/ids/~hodzod-walrus), [~harden-hardys](https://urbit.org/ids/~harden-hardys), [~littel-wolfur](https://urbit.org/ids/~littel-wolfur), [~dachus-tiprel](https://urbit.org/ids/~dachus-tiprel), [~nomryg-nilref](https://urbit.org/ids/~nomryg-nilref) and more to come!

21+

22+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/events/FwSOS1vXsAIgmZc.jpeg)

content/events/2023-10-28_urbit-assembly-lisboa.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+title = "Urbit Assembly Lisboa 2023"

3+starts = "2023-10-28T10:00:00"

4+ends = "2023-10-29T20:00:00"

5+timezone = "Europe/Lisbon"

6+location = "Lisbon – Portugal"

7+image = "https://storage.googleapis.com/media.urbit.org/site/events/urb01_assembly23_std_1-1.png"

8+registration_url = ""

9+description = "The third Urbit Assembly & first one outside of the US"

10+dark = true

11+darken_image = "true"

12+

13++++

14+![Screenshot](https://storage.googleapis.com/media.urbit.org/site/events/urb01_assembly23_std_16-9.png)

15+

16+Urbit is coming to Europe! Save the date for Urbit Assembly 2023 & Urbit Week in Lisbon this year.

17+

18+Early-bird tickets are going live by the end of may in the [UF Public Group](/groups/~halbex-palheb/uf-public).

19+

20+We’re changing up the format this year: the first two days will be more “conference-like” with launches, presentations and panels from the Urbit ecosystem.

21+

22+Afterwards we’ll have a week of side events hosted by the community throughout Lisbon.

23+

24+Don't miss it.

content/getting-started/_index.md+19−16

@@ -1,25 +1,28 @@

1+++

2−title = "Overview"

2+title = "Introduction"

3weight = 0

4description = ""

5+++

6

7−### Introduction

7+The goal of Urbit is to make peer-to-peer software easy for developers to write

8+and for users to run on their own. The code is [completely open

9+source](https://github.com/urbit), [actively

10+maintained](https://github.com/urbit/urbit/graphs/code-frequency), supported by

11+a [growing ecosystem](https://urbit.org/ecosystem), and [used daily by

12+thousands](https://network.urbit.org).

8

13

9−Nothing about building a new OS from scratch has been easy. Or creating an identity system that adequately replaces the IP address.

14+Urbit consists of two high-level components: an operating

15+system (Urbit OS) and an identity system (Urbit ID). Urbit OS enables its user to communicate directly with others using Urbit OS via their Urbit ID's. You can think of these like phone numbers — meaningless

16+but memorizable, and likely to identify the same person reliably through time.

10

17

11−Getting on Urbit isn't always easy, either. The onboarding process hasn't been optimized by product managers in search of maximal profit. There's no checkbox for your interests—you have to discover them yourself.

18+Using Urbit requires having access to a running **ship**: an Urbit OS running

19+with a supplied Urbit ID. You can run Urbit yourself if you're comfortable at a

20+command-line or willing to learn. Otherwise you should probably use a hosting

21+provider — that is, someone that provides you with an Urbit as a service.

12

22

13−But we like to think this hard work is exactly what makes Urbit special. **Consider yourself warned.**

23+## Next steps

14

24

15−### Why Urbit?

25+- [Run Urbit yourself](/getting-started/self-host) or select a [hosting provider](/getting-started/hosted)

16−

26+- Meet friendly people by [joining groups](/getting-started/joining-groups)

17−**As a user**, you can explore the people, community, and sheer novelty of the Urbit ecosystem while owning your entire experience. Your data, your messages, your apps.

27+- [Install apps](/getting-started/installing-applications) to experiment with

18−

28+- Explore [interfaces](/getting-started/interfaces) for Urbit

19−**As a developer**, you can now build apps, a protocol for a whole suite of apps, or an entire online subculture, and distribute your work directly to your users' operating systems. No middlemen, no MEGACORPs, and no lock-in.

20−

21−Someone once said, "All the smart people I know disappear into Urbit." If you're smart, you will too — not just installing and running Urbit, but taking the first step toward deploying your Final Computer.

22−

23−### Launch into Urbit

24−

25−Choose how you want to disappear into Urbit.

content/getting-started/cli.md+112−71

@@ -1,86 +1,77 @@

1+++

2−title = "Command line app"

2+title = "Command-line install"

3−weight = 2

3+weight = 3

4−description = "Installation instructions for power users."

4+description = "Installation instructions for technical users"

5+tag = "selfhost"

5+++

6+++

6

7

7−If you're a power user, you can run the Urbit virtual machine directly using the

8+This guide covers running the Urbit runtime (Vere) using the command line. This

8−command line. This can be run on your local machine or a server in the cloud, we

9+can be run on your local machine or a server in the cloud, we just cover the

9−just cover the general case here.

10+local case here. The runtime is what interprets the Urbit kernel code (Arvo)

11+into commands your specific machine (macOS or Linux) understands.

10

12

11Note there is a much more comprehensive [cloud hosting

13Note there is a much more comprehensive [cloud hosting

12−guide](https://operators.urbit.org/manual/running/hosting) which walks through

14+guide](/getting-started/cloud-hosting) which walks through setting up Urbit on a

13−setting up Urbit on a [Digital Ocean](https://www.digitalocean.com/) VPS.

15+[Digital Ocean](https://www.digitalocean.com/) VPS.

14

16

17+### 1. System Requirements {% #about-swap-space %}

18+

19+- **Processor**: 1 core

20+- **Memory**: 2GB

21+- **Storage**: At least a few GB, 40-50GB preferable

22+- **Network**: Any

23+

24+**A note on memory**: By default, the Urbit runtime needs 2GB of free memory,

25+and will fail to boot without it. Urbit usually only uses a portion of this, so

26+it's possible to use a swap file to makeup for a shortfall without degrading

27+performance. For instructions on how to configure a swap file on Linux, see

28+[this linuxize.com guide](https://linuxize.com/post/create-a-linux-swap-file/).

29+

30+**A note on storage**: Urbit saves every event it processes to its [Event

31+Log](https://developers.urbit.org/reference/glossary/eventlog). This means its

32+disk usage slowly grows over time. Until event log truncation is implemented,

33+it's advisable to have 40 or 50GB of disk space available, so you don't have to

34+worry about running out for a long time. If you don't have that much, your ship

35+will still run fine, but you may run out of space some months down the line.

36+

15−### 1. Install Urbit

37+### 2. Install Urbit

16

38

17Choose your operating system and run the given command in your terminal to

39Choose your operating system and run the given command in your terminal to

18−download the Urbit runtime:

40+download the Urbit runtime, this command downloads the latest build, unpacks

41+it, and runs the binary with no arguments to show you the help output:

19

42

20{% tabs %}

43{% tabs %}

21

44

22−{% tab label="MacOS" %}

45+{% tab label="Linux x86_64" %}

23

46

24−```bash

47+```shell

25−curl -L https://urbit.org/install/mac/latest | tar xzk --strip=1 && ./urbit

48+curl -L https://urbit.org/install/linux-x86_64/latest | tar xzk --transform='s/.*/urbit/g' && ./urbit

26```

49```

27

50

28−> Note our Mac build is only compatible with Apple Silicon (M1/M2) via Rosetta.

29−> If you have such a machine you may need to run the following command:

30−>

31−> ```

32−> /usr/sbin/softwareupdate --install-rosetta --agree-to-license

33−> ```

34−

35{% /tab %}

51{% /tab %}

36

52

37−{% tab label="Linux" %}

53+{% tab label="Linux AArch64" %}

38

54

39```shell

55```shell

40−curl -L https://urbit.org/install/linux64/latest | tar xzk --strip=1 && ./urbit

56+curl -L https://urbit.org/install/linux-aarch64/latest | tar xzk --transform='s/.*/urbit/g' && ./urbit

41```

57```

42

58

43−> Linux users may need to run this command in another terminal window to access

44−> your urbit on port 80:

45−>

46−> ```shell

47−> sudo apt-get install libcap2-bin

48−> sudo setcap 'cap_net_bind_service=+ep' ./urbit

49−> ```

50−

51{% /tab %}

59{% /tab %}

52

60

53−{% tab label="Linux ARM64" %}

61+{% tab label="macOS x86_64" %}

54

62

55−Note this is for the AArch64 architecture.

63+```bash

56−

57−```shell

58−curl -L https://urbit.org/install/linux-aarch64/latest | tar xzk --strip=1 && ./urbit

64+curl -L https://urbit.org/install/macos-x86_64/latest | tar xzk -s '/.*/urbit/' && ./urbit

59```

65```

60

66

61−> Linux users may need to run this command in another terminal window to access

62−> your urbit on port 80:

63−>

64−> ```shell

65−> sudo apt-get install libcap2-bin

66−> sudo setcap 'cap_net_bind_service=+ep' ./urbit

67−> ```

68−

69{% /tab %}

67{% /tab %}

70

68

71−{% tab label="Windows" %}

69+{% tab label="macOS AArch64" %}

72

70

73−```winbatch

71+```bash

74−curl -L https://urbit.org/install/windows/latest | tar -xzkf - --strip-components=1 && urbit

72+curl -L https://urbit.org/install/macos-aarch64/latest | tar xzk -s '/.*/urbit/' && ./urbit

75```

73```

76

74

77−> Windows 10 build 17063 and later includes the familiar `curl` and `tar`

78−> command-line tools. If you're running an older version of Windows, you may need

79−> to visit

80−> [https://github.com/urbit/urbit/releases/latest](https://github.com/urbit/urbit/releases/latest)

81−> in the browser, download the `windows.zip` file, extract it and execute the

82−> contained `urbit.exe` file in the command prompt.

83−

84{% /tab %}

75{% /tab %}

85

76

86{% /tabs %}

77{% /tabs %}

@@ -91,7 +82,7 @@ If successful, you will see a block of output beginning with the line:

91Urbit: a personal server operating function

82Urbit: a personal server operating function

92```

83```

93

84

94−### 2. Boot Urbit

85+### 3. Boot Urbit

95

86

96An Urbit instance is intrinsically tied to a unique identity called an **Urbit

87An Urbit instance is intrinsically tied to a unique identity called an **Urbit

97ID**. There are five classes of Urbit ID, but we will consider two here: comets

88ID**. There are five classes of Urbit ID, but we will consider two here: comets

@@ -108,8 +99,8 @@ and planets.

108 unlimited number of comets, planets are more scarce (preventing spamming,

99 unlimited number of comets, planets are more scarce (preventing spamming,

109 among other things). This scarcity means they usually aren't free (though

100 among other things). This scarcity means they usually aren't free (though

110 sometimes nice people give them away). This guide will assume you've already

101 sometimes nice people give them away). This guide will assume you've already

111− acquired a planet. If you haven't, you can refer to the ["Get a planet"

102+ acquired a planet. If you haven't, you can refer to the ["Get an Urbit ID"

112− guide](https://urbit.org/getting-started/get-planet) before continuing.

103+ guide](/getting-started/get-id) before continuing.

113

104

114Follow the instructions for your case:

105Follow the instructions for your case:

115

106

@@ -124,8 +115,8 @@ comet can be booted with the `-c` option:

124./urbit -c mycomet

115./urbit -c mycomet

125```

116```

126

117

127−> `mycomet` will be the name given to the data folder it will create. You can

118+> `mycomet` will be the name given to the folder it will create.

128−> choose any name you like.

119+> You can choose any name you like.

129

120

130It may take a while to initialize the comet (usually only a couple of minutes,

121It may take a while to initialize the comet (usually only a couple of minutes,

131but it could take longer). When it's done, it'll take you to the dojo prompt

122but it could take longer). When it's done, it'll take you to the dojo prompt

@@ -145,6 +136,14 @@ folder, so you can start it up again by doing:

145```bash

136```bash

146./mycomet/.run

137./mycomet/.run

147```

138```

139+> Linux users need to run this command in another terminal window to access

140+> your urbit on port 80 every time you upgrade your runtime (otherwise it'll

141+> default to port 8080):

142+>

143+> ```shell

144+> sudo apt-get install libcap2-bin

145+> sudo setcap 'cap_net_bind_service=+ep' <pier>/.run

146+> ```

148

147

149Since comets are often used temporarily and then discarded, kernel updates are

148Since comets are often used temporarily and then discarded, kernel updates are

150not enabled by default. If you plan to use your comet for a while, it's a good

149not enabled by default. If you plan to use your comet for a while, it's a good

@@ -154,9 +153,9 @@ idea to enable updates with the following command in the dojo:

154|ota (sein:title our now our)

153|ota (sein:title our now our)

155```

154```

156

155

157−Lastly, while the dojo is quite powerful, most people use their urbit via

156+Lastly most people use their urbit via Landscape, the browser-based UI. In order

158−Landscape, the browser-based UI. In order to access Landscape, you need your web

157+to access Landscape, you need your web login code. You can get this by running

159−login code. You can get this by running the following command in the dojo:

158+the following command in the dojo:

160

159

161```

160```

162+code

161+code

@@ -185,7 +184,7 @@ keyfile):

185./urbit -w sampel-palnet -k sampel-palnet-1.key

184./urbit -w sampel-palnet -k sampel-palnet-1.key

186```

185```

187

186

188−This will create a data folder with the name of your planet and begin booting.

187+This will create a folder with the name of your planet and begin booting.

189It may take a while to initialize the planet (usually only a couple of minutes,

188It may take a while to initialize the planet (usually only a couple of minutes,

190but it could take longer). When it's done, it'll take you to the dojo prompt

189but it could take longer). When it's done, it'll take you to the dojo prompt

191(the dojo is Urbit's shell):

190(the dojo is Urbit's shell):

@@ -204,9 +203,17 @@ folder, so you can start it up again by doing:

204```bash

203```bash

205./sampel-palnet/.run

204./sampel-palnet/.run

206```

205```

206+> Linux users need to run this command in another terminal window to access

207+> your urbit on port 80 every time you upgrade your runtime (otherwise it'll

208+> default to port 8080):

209+>

210+> ```shell

211+> sudo apt-get install libcap2-bin

212+> sudo setcap 'cap_net_bind_service=+ep' <pier>/.run

213+> ```

207

214

208−While the dojo is quite powerful, most people use their urbit via Landscape, the

215+Most people use their urbit via Landscape, the browser-based UI.

209−browser-based UI. In order to access Landscape, you need your web login code.

216+In order to access Landscape, you need your web login code.

210You can get this by running the following command in the dojo:

217You can get this by running the following command in the dojo:

211

218

212```

219```

@@ -218,14 +225,14 @@ It'll spit out a code that'll look something like `lidlut-tabwed-pillex-ridrup`

218to the clipboard.

225to the clipboard.

219

226

220One last thing: The `sampel-palnet-1.key` keyfile is only needed once, when you

227One last thing: The `sampel-palnet-1.key` keyfile is only needed once, when you

221−first boot your planet. Now that it's booted, it's good security practice to

228+first boot your planet. **Now that it's booted, it's good security practice to

222−delete that keyfile.

229+delete that keyfile.**

223

230

224{% /tab %}

231{% /tab %}

225

232

226{% /tabs %}

233{% /tabs %}

227

234

228−### 3. Login

235+### 4. Login

229

236

230While your urbit is running, the web interface called *Landscape* can be

237While your urbit is running, the web interface called *Landscape* can be

231accessed in the browser. Its URL will usually be either `localhost` or

238accessed in the browser. Its URL will usually be either `localhost` or

@@ -240,10 +247,44 @@ Whichever address and port it says there is the one to open in the browser.

240

247

241Once open, you'll be presented with the login screen. Paste in the web login

248Once open, you'll be presented with the login screen. Paste in the web login

242code you copied from the dojo in the previous step and hit "continue". You'll

249code you copied from the dojo in the previous step and hit "continue". You'll

243−now be taken to your homescreen, with tiles for the default apps such as Groups

250+now be taken to your homescreen, with tiles for the default apps such as Groups,

244−and Terminal.

251+Talk, and Terminal.

252+

253+### 5. Runtime Upgrades

254+

255+When new versions of the Urbit runtime (Vere) are available, you'll have to

256+shutdown your urbit and then run the `next` command in order to upgrade.

257+```

258+:dojo> |exit

259+<pier>/.run next

260+```

261+Note that `<pier>` in this case is the folder that was created when you first booted

262+your urbit. When you run this command your urbit will download the latest binary

263+and place it inside the `.bin` directory inside your pier folder. You can then

264+start your ship with the following and you'll be on the latest runtime version:

265+```

266+<pier>/.run

267+```

268+> Linux users need to run this command in another terminal window to access

269+> your urbit on port 80 every time you upgrade your runtime (otherwise it'll

270+> default to port 8080):

271+>

272+> ```shell

273+> sudo apt-get install libcap2-bin

274+> sudo setcap 'cap_net_bind_service=+ep' <pier>/.run

275+> ```

276+

277+If you've been running Urbit for a while (from before runtime version 1.9)

278+and these `.run` commands don't work for you, it probably means you need to

279+[dock](https://operators.urbit.org/manual/running/vere#dock) your pier.

280+You can do this with the following command:

281+```

282+./urbit dock <pier>

283+```

284+Then `.run` should work as expected and future runtime upgrades can be done via

285+`next`.

245

286

246−### Next steps

287+## Next steps

247

288

248Learn how to [get around your

289Learn how to [get around your

249−urbit](https://urbit.org/getting-started/getting-around).

290+urbit](/getting-started/getting-around).

content/getting-started/cloud-hosting.mdnew file+468

@@ -0,0 +1,468 @@

1++++

2+title = "Cloud hosting"

3+weight = 4

4+description = "How to host your ship in the cloud so you can access it from any device"

5+tag = "selfhost"

6++++

7+

8+The goal of this guide is to have clear and easy to follow best practices for

9+deploying an Urbit node to a server you control in the cloud. Deploying in the

10+cloud allows you to access your Urbit from any device.

11+

12+Most Urbit users start out running their ship locally on one machine in order to

13+play with it, but this means when your machine is offline your Urbit node is

14+offline too (and can't get updates). You can also only access your Urbit from

15+that one machine.

16+

17+This guide uses Digital Ocean as the cloud provider, but others can be used. If

18+using another provider, the setup script provided and other server configuration

19+instructions may need to be modified or done manually.

20+

21+## 1. Create a Droplet

22+

23+Create an account on [Digital Ocean](https://digitalocean.com). Once you make an

24+account, choose "Deploy a virtual machine".

25+

26+You should see the page below where you can create your Droplet, aka Virtual Machine:

27+

28+![do screenshot](https://media.urbit.org/operators/manual/running/hosting/do-screenshot.png)

29+

30+Fill out the options like so:

31+

32+#### Image

33+

34+Ubuntu 22.04 x64

35+

36+#### Plan

37+

38+- Shared CPU: Basic

39+- CPU options: Regular with SSD

40+- 2GB / 1 CPU ($12/mo)

41+

42+You can choose a more powerful option if you'd like but the $12 option should be

43+sufficient. Note Urbit needs 2GB of memory; it's possible to choose a cheaper

44+option and run it with less memory by using swap but it will impact performance.

45+

46+#### Add block storage

47+

48+The $12 plan includes 50GB which should be sufficient for quite some time, so

49+you can skip this.

50+

51+#### Datacenter region

52+

53+Choose the region closest to you.

54+

55+#### VPC Network

56+

57+Leave this as default.

58+

59+#### Authentication

60+

61+In the "Authentication" field, select "SSH keys" and hit "New SSH Key". Run the

62+following command in the terminal on your local machine, replacing

63+`riclen-tinlyr` with the name of your ship (sans the leading `~`):

64+

65+```bash {% copy=true %}

66+SHIP="riclen-tinlyr" bash -c 'ssh-keygen -q -N "" -C $SHIP -f ~/.ssh/$SHIP && cat ~/.ssh/$SHIP.pub'

67+```

68+

69+It should spit out a long string of letters and numbers beginning with `ssh-rsa`

70+and ending with your ship name. Copy the whole thing and paste it into the "SSH

71+key content" field on Digital Ocean. In the "Name" field, enter your ship name.

72+

73+#### Additional options

74+

75+Click "+Advanced Options" check the box for "Add Initialization scripts (free)" and paste the script below into the field provided. This

76+will automatically configure the server and install necessary software.

77+

78+```bash {% copy=true %}

79+#!/bin/bash

80+

81+# configure swap

82+fallocate -l 2G /swapfile

83+chmod 600 /swapfile

84+mkswap /swapfile

85+swapon /swapfile

86+echo "/swapfile swap swap defaults 0 0" >> /etc/fstab

87+

88+# setup firewall

89+ufw allow OpenSSH

90+ufw allow www

91+ufw allow https

92+ufw allow 34543/udp

93+ufw enable

94+

95+# create and configure user

96+useradd -s /bin/bash -d /home/urbit -m -G sudo urbit

97+passwd -d urbit

98+echo "urbit ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers

99+

100+# configure ssh keys for user

101+mkdir -p /home/urbit/.ssh

102+chmod 700 /home/urbit/.ssh

103+cp /root/.ssh/authorized_keys /home/urbit/.ssh/authorized_keys

104+chmod 600 /home/urbit/.ssh/authorized_keys

105+chown -R urbit:urbit /home/urbit/.ssh

106+

107+# configure sshd

108+mkdir -p /etc/ssh/sshd_config.d

109+cat > /etc/ssh/sshd_config.d/override.conf <<EOF

110+PermitRootLogin no

111+PubkeyAuthentication yes

112+PasswordAuthentication no

113+EOF

114+

115+# fetch and extract urbit binary

116+curl -L https://urbit.org/install/linux-x86_64/latest | tar xzk --transform='s/.*/urbit/g' -C /home/urbit/

117+chown urbit:urbit /home/urbit/urbit

118+

119+# install tmux

120+apt -y update

121+apt install -y tmux

122+

123+# reboot

124+systemctl reboot

125+```

126+

127+#### How many Droplets?

128+

129+1

130+

131+#### Choose a hostname

132+

133+This will be the name the server calls itself locally, you can put in whatever

134+you want. Your planet name is a good choice.

135+

136+#### Add tags

137+

138+Leave empty.

139+

140+#### Select project

141+

142+Leave as the default.

143+

144+#### Create Droplet

145+

146+Hit this button to create the droplet.

147+

148+## 2. Prepare for upload

149+

150+{% callout %}

151+

152+**Note**

153+

154+This step is necessary if you already have a ship running locally and want to

155+move it to the cloud. If you don't, you can skip this step.

156+

157+{% /callout %}

158+

159+In the Dojo, use either `"CTRL + D"` or `|exit` to shut down your ship.

160+

161+Archive your pier by running `tar cvzf riclen-tinlyr.tar.gz ~/path/to/your/pier`

162+(substitute your own ship name and pier location).

163+

164+## 3. Connect to the server

165+

166+To make connecting simple, you can add an alias to `~/.ssh/config` on your local

167+machine. Open `~/.ssh/config` in an editor (you may need to create it if the

168+file doesn't exist), and add the following to the bottom of the file (replacing

169+the ship name with your own and the IP address with that of your droplet):

170+

171+``` {% copy=true %}

172+Host riclen-tinlyr

173+ HostName 161.35.148.247

174+ User urbit

175+ IdentityFile ~/.ssh/riclen-tinlyr

176+ IdentitiesOnly yes

177+```

178+

179+{% tabs %}

180+

181+{% tab label="If you have an existing pier" %}

182+

183+

184+Copy the archived pier to the server with the following (substituting your ship

185+name and Host):

186+

187+```bash {% copy=true %}

188+scp riclen-tinlyr.tar.gz riclen-tinlyr:

189+```

190+

191+It may take a while to upload if your pier is large and/or your internet is

192+slow.

193+

194+{% /tab %}

195+

196+{% tab label="If you have a key file" %}

197+

198+If you have obtained a planet and want to boot it for the first time, you'll

199+need to upload its key file to the server. These instructions assume you've

200+received an invite. If you've got a planet by another method, you can also login

201+to [Bridge](https://bridge.urbit.org) and download the key file from there.

202+

203+If you've received a planet invite via email or a claim link like

204+`https://bridge.urbit.org/#labfur-batteg-dapnex-binsup-riclen-tinlyr`, open it

205+in a browser and you should see a page like the following:

206+

207+![claim planet screenshot](https://media.urbit.org/operators/manual/running/hosting/claim-planet.png)

208+

209+If you hit "Claim", it'll bring you here:

210+

211+![download passport

212+screenshot](https://media.urbit.org/operators/manual/running/hosting/download-passport.png)

213+

214+Hit "Download Backup (Passport)" and it'll have you download a file named like

215+`riclen-tinlyr-passport.zip`.

216+

217+Unzip the file with:

218+

219+```bash {% copy=true %}

220+unzip ~/path/to/download/folder/riclen-tinlyr-passport.zip

221+```

222+

223+It'll create a folder called `riclen-tinlyr-passport` which will contain three files:

224+

225+- `riclen-tinlyr-1.key`

226+- `riclen-tinlyr-Management Proxy.png`

227+- `riclen-tinlyr-Master Ticket.png`

228+

229+You can physically print out the two `.png` files and store them in a safe and

230+secure location. Importantly, you should ensure the *master ticket* (which will

231+look something like `~tarnes-pilryd-dassed-sogsul`) is securely and safely

232+stored. If anyone gains access to the master ticket they'll have ownership and

233+control of your Urbit ID, and if you lose it you'll irreversibly lose ownership

234+and control of your Urbit ID.

235+

236+The next screen on the claim page will ask you to re-enter the master ticket to

237+ensure you've recorded it accurately, and then the claim process is complete.

238+Once you've securely, physically backed up the master ticket and the `.png`

239+passports, it's a good idea to delete the `riclen-tinlyr-passport.zip` file and

240+the two `.png` files, so if someone gains access to your computer, your Urbit ID

241+will be safe.

242+

243+This will leave only the `riclen-tinlyr-1.key` file. The key file contains your

244+planet's private keys, which are necessary to boot it up for the first time.

245+You'll need to copy that file to the server with the following command (again,

246+replacing `riclen-tinlyr` with your own ship and Host):

247+

248+```bash {% copy=true %}

249+scp riclen-tinlyr-passport/riclen-tinlyr-1.key riclen-tinlyr:

250+```

251+

252+Note: you should keep the `riclen-tinlyr-1.key` until you've completed this

253+guide and your ship is booted to be sure it was copied successfully, but

254+afterwards you should also delete that file for security.

255+

256+{% /tab %}

257+

258+{% /tabs %}

259+

260+Once you've either uploaded your pier or uploaded your key file as the case may

261+be, you can connect to your server:

262+

263+```bash {% copy=true %}

264+ssh riclen-tinlyr

265+```

266+You'll be taken to the shell on your server.

267+

268+## 5. Boot your ship

269+

270+{% tabs %}

271+

272+{% tab label="If you have an existing pier" %}

273+

274+In the previous section you ssh'd into the server. In the same ssh session,

275+extract the pier archive you previously uploaded, then delete the archive:

276+

277+```bash {% copy=true %}

278+tar xvzf riclen-tinlyr.tar.gz && rm riclen-tinlyr.tar.gz

279+```

280+

281+You'll now have a folder called `riclen-tinlyr`, which is your pier. Urbit is

282+best run in a tmux or screen session so it's easy to keep it running when

283+you disconnect. In this case we'll use tmux, which has already been installed

284+by the setup script.

285+

286+Run tmux:

287+

288+```bash {% copy=true %}

289+tmux

290+```

291+

292+You should now be in tmux. First, dock your ship:

293+

294+```bash {% copy=true %}

295+./urbit dock riclen-tinlyr

296+```

297+

298+That will copy the `urbit` runtime inside the pier, so you can now delete the

299+separate binary:

300+

301+```bash {% copy=true %}

302+rm urbit

303+```

304+

305+{% /tab %}

306+

307+{% tab label="If you have a key file" %}

308+

309+In the previous section you ssh'd into the server. In the same ssh session,

310+start tmux:

311+

312+```bash {% copy=true}

313+tmux

314+```

315+

316+You should now be in tmux. Boot a new ship with the following command,

317+specifying the ship name and key file, as well as the Ames port that was

318+previously opened in the firewall by the setup script:

319+

320+```bash {% copy=true %}

321+./urbit -w riclen-tinlyr -k riclen-tinlyr-1.key -p 34543

322+```

323+

324+It may take several minutes to boot the new ship. Eventually, it'll take you to

325+the Dojo (Urbit's shell) and show a prompt like `~riclen-tinlyr:dojo>`. Once

326+booted, shut the ship down again by typing `|exit` in the Dojo. After it quits,

327+it should print something like "docked successfully", which means the binary has

328+been copied inside the pier. This means you can delete the separate binary:

329+

330+```bash {% copy=true %}

331+rm urbit

332+```

333+

334+The key file is only needed when you first boot the ship, so it's good practice

335+to delete it after first boot:

336+

337+```bash {% copy=true %}

338+rm riclen-tinlyr-1.key

339+```

340+

341+{% /tab %}

342+

343+{% /tabs %}

344+

345+Run the following to allow the runtime to bind ports 80 and 443:

346+

347+```bash {% copy=true %}

348+sudo setcap 'cap_net_bind_service=+ep' riclen-tinlyr/.run

349+```

350+

351+Now you can start your ship up with the following:

352+

353+```bash {% copy=true %}

354+./riclen-tinlyr/.run -p 34543

355+```

356+

357+After a few moments it'll show the Dojo prompt like `~riclen-tinlyr:dojo>`.

358+

359+## 6. Get a domain

360+

361+To make accessing the web interface convenient, you should request an

362+`arvo.network` domain name. To do so, run the following command in the Dojo,

363+replacing the IP address with your droplet's:

364+

365+``` {% copy=true %}

366+-dns-address [%if .161.35.148.247]

367+```

368+

369+This will request a subdomain of your ship like `riclen-tinlyr.arvo.network`.

370+

371+The domain should be registered almost instantly, but sometimes it takes a while

372+for it to propagate to other DNS servers. You might therefore see the following:

373+

374+```

375+> -dns-address [%if .161.35.148.247]

376+dns: request for DNS sent to ~deg

377+dns: awaiting response from ~deg

378+http: fail (13, 504): unknown node or service

379+http: fail (14, 504): unknown node or service

380+http: fail (15, 504): unknown node or service

381+http: fail (16, 504): unknown node or service

382+http: fail (17, 504): unknown node or service

383+dns: unable to access via riclen-tinlyr.arvo.network

384+XX confirm port 80

385+XX check via nslookup

386+0

387+```

388+

389+If that happens, wait five or ten minutes and then try again. You should

390+eventually see:

391+

392+```

393+> -dns-address [%if .161.35.148.247]

394+dns: request for DNS sent to ~deg

395+dns: awaiting response from ~deg

396+[%key iter=0 width=2.047]

397+[%key iter=1 width=2.047]

398+[%key iter=2 width=2.047]

399+[%key iter=3 width=2.047]

400+acme: requesting an https certificate for riclen-tinlyr.arvo.network

401+dns: confirmed access via riclen-tinlyr.arvo.network

402+0

403+acme: received https certificate for riclen-tinlyr.arvo.network

404+http: restarting servers to apply configuration

405+http: web interface live on https://localhost:443

406+http: web interface live on http://localhost:80

407+http: loopback live on http://localhost:12321

408+```

409+

410+That means the domain has been registered and an SSL certificate has been

411+installed, so you can access the web interface securely with HTTPS.

412+

413+## 7. Log in to Landscape

414+

415+In order to login to the web interface, you need to get the web login code. Run

416+the following in the Dojo:

417+

418+``` {% copy=true %}

419++code

420+```

421+

422+It'll spit out something like `ropnys-batwyd-nossyt-mapwet`. That's your web

423+login code, you can copy that and save it in a password manager or similar. Note

424+that the web login code is separate from the master ticket.

425+

426+The server configuration should now be complete, and you can access Landscape in

427+the browser. Navigate to the domain you configured previously, in this case

428+`riclen-tinlyr.arvo.network`. You should see the Landscape login screen:

429+

430+![landscape login screen](https://media.urbit.org/operators/manual/running/hosting/landscape-login.png)

431+

432+Enter the web login code and you'll be taken to your ship's homescreen. Your

433+ship is now running in the cloud, and you can access it from any device by

434+visiting its URL.

435+

436+## 8. Disconnect

437+

438+You can now disconnect from the tmux session by hitting `CTRL+b d` (that is, you

439+hit `CTRL+b`, release it, and then hit `d`). You'll be taken back to the

440+ordinary shell, but the ship will still be running in the background. If you

441+want to get back to the Dojo again, you can reattach the tmux session with:

442+

443+```bash {% copy=true %}

444+tmux a

445+```

446+

447+Finally, you can disconnect from the ssh session completely by hitting `CTRL+d`.

448+

449+## 9. Cleanup

450+

451+If you booted a new ship by uploading a key file, it's a good idea to now delete

452+the key file on your local machine.

453+

454+If you uploaded an existing pier, you should delete the old copy of both the

455+pier directory and the `.tar.gz` archive on your local machine. You might be

456+tempted to keep one of these as a backup, but note that **you must never again

457+boot the old copy on the live network**. Doing so will create unfixable

458+networking problems and require you to perform a factory reset through Bridge,

459+wiping your ship's data. We therefore don't recommend you keep duplicates of

460+your pier lying around.

461+

462+

463+## Next steps

464+

465+- Kep your Urbit runtime up-to-date to take advantage of the latest Landscape and Application over-the-air updates. See [Step #5 in the CLI guide](/getting-started/cli#5-runtime-upgrades) to update your runtime.

466+

467+- Learn how to [get around your

468+urbit](/getting-started/getting-around).

content/getting-started/desktop.md+5−82

@@ -1,88 +1,11 @@

1+++

2title = "Desktop app"

3−description = "Run Urbit locally as a desktop application"

3+weight = 4

4−weight = 3

4+description = ""

5+++

6

7+In the past we recommended [Port](https://github.com/urbit/port/releases), a desktop Urbit client.

7

8

9+We now recommend that users that are not comfortable with the [CLI interface](/getting-started/cli) run Urbit with a [hosting service](/getting-started/hosted) or an Urbit-native computer like [Native Planet](https://www.nativeplanet.io/).

8

10

9−### 1. Get Port

11+Whichever way you run your urbit, you can also now use it with a desktop interface such as [Scene](https://tirrel.io/scene/index.html), or the soon-to-be released [Realm](https://www.holium.com/) application.

10−

11−Port is a desktop GUI application that allows you to spin up, access, and manage your Urbit ships without any knowledge of the command line or Urbit binary.

12−

13−{% tabs %}

14−

15−{% tab label="MacOS" %}

16−

17−To install **Port** on MacOS, simply download and open the `.dmg` file.

18−

19−{% button label="Download Port" link="https://github.com/urbit/port/releases/latest/download/Port.dmg" color="bg-green-400 text-white" %}

20−{% /button %}

21−

22−{% /tab %}

23−

24−{% tab label="Linux" %}

25−

26−We use `snap` so that **Port** can stay updated automatically. If you already have `snap` installed, simply run:

27−

28−```sh

29−sudo snap install port

30−```

31−

32−Or to install `snap` for your distribution, snapcraft provides [installation instructions](https://snapcraft.io/docs/installing-snapd).

33−

34−{% /tab %}

35−

36−{% tab label="Windows" %}

37−

38−{% callout className="bg-yellow-200" %}

39−

40−#### Notice

41−

42−Support for Windows is experimental.

43−

44−For the best immediate Urbit experience we recommend [setting up a VPS](/getting-started/cli) or using a [hosting service](/getting-started/hosted).

45−

46−{% /callout %}

47−

48−

49−

50−To install **Port** on Windows, simply download and open the `.exe` file.

51−

52−{% button label="Download Port" link="https://github.com/urbit/port/releases/latest/download/PortSetup.exe" color="bg-green-400 text-white" %}

53−{% /button %}

54−

55−{% /tab %}

56−

57−{% /tabs %}

58−

59−### 2. Boot a comet

60−

61−A comet serves as a temporary identity for the network. It works just fine for checking out the network, but to download applications and get the full functionality of Urbit ID you’ll need a to get a planet.

62−

63−Start Port and hit the **Start without an ID** button. It'll take a few minutes to spin up the new comet.

64−

65−![](https://media.urbit.org/site/getting-started/Desktop-app-1.jpg)

66−

67−### 3. Launch your ship

68−

69−Once that's finished, click **Launch Ship into Urbit** and you'll be on the network.

70−

71−![](https://media.urbit.org/site/getting-started/Desktop-app-2.jpg)

72−

73−{% callout %}

74−

75−**Want to combine the simplicity of Port with a permanent Urbit ID?**

76−

77−If you already have a planet, first get your keyfile.

78−Start Port, click the **Boot a fresh ID** option. Give your ship a name, and in the **Shipname** field, enter your planet name, like `~sampel-palnet`. For the **Key File** field, browse to the keyfile, select it, and hit **Continue**.

79−

80−Port will boot your Urbit in a few minutes!

81−

82−For more information on getting a planet, see our [Getting an Urbit ID](/guides/getting-an-urbit-id) guide.

83−

84−{% /callout %}

85−

86−### Next steps

87−

88−Learn how to [get around your urbit](/getting-started/getting-around).

content/getting-started/get-planet.md → content/getting-started/get-id.mdrenamed+29−40

@@ -1,46 +1,45 @@

1+++

2−title = "Get a planet"

2+title = "Get an Urbit ID"

3−weight = 1

3+weight = 2

4−description = "How to acquire a planet, or an Urbit ID"

4+description = "How to acquire an Urbit ID"

5−tag = "additional"

5+tag = "selfhost"

6+++

7

8−### What's a planet?

8+### Types of ID

9

10−Planets are a type of [Urbit ID](/understanding-urbit/urbit-id) that is useful for providing individuals long-term access to the Urbit network.

10+There are [five different

11+types](https://operators.urbit.org/guides/which-id-should-i-buy) of Urbit ID, but here we'll just be discussing two types called comets and planets.

11

12

12−### Where to get a planet

13+**Comets** are free, temporary identities that you can issue yourself and are best-suited for

14+short-term usage. **Planets** are permanent identities that are suitable for long-term use.

13

15

14−There are a few ways to get your own planet:

16+![](https://storage.googleapis.com/media.urbit.org/site/getting-started/comet-planet.png)

15

17

16−- Getting an invitation from a friend (or stranger)

18+Planets have a unique, four syllable phonetic name and a [sigil](https://urbit.org/blog/creating-sigils), a visual representation of the name.

17−- Purchasing a planet, including hosting, from a hosting provider

18−- Manually setting up and hosting a planet purchased from a third party marketplace

19

20−### Hosting Providers {% #hosting-providers %}

21

20

22−Hosting providers will often sell you a planet and run it for you. This option is very simple but will probably cost a regular fee.

23

21

24−Urbit is designed to be portable. This means that if you sign up for hosting now but later want to leave your hosting provider and run your Urbit yourself, you should be able to work with them to obtain all of your data and boot your planet back up without losing anything.

22+### Where to get a planet

25

23

26−Using hosting does mean that you're trusting your provider with your data, but so long as you have your planet, you'll always own your identity.

24+There are a few ways to get your own planet:

27

25

28−Current hosting providers are:

26+- Receiving one from a friend

27+- Asking on Twitter (if you're lucky)

28+- Booting a comet and being friendly in [Urbit Community](https://urbit.org/groups/~bitbet-bolbel/urbit-community)

29+- Purchasing one from a marketplace

29

30

30−- [UrbitHost](https://urbithost.com)

31+This guide will cover the last case and what to do after receiving one.

31−- [escape pod store](https://www.escapepod.store/)

32−- [Third Earth](https://third.earth/)

33−- [Tlon Corporation](https://tlon.io)

34

32

35### Buying a planet

33### Buying a planet

36

34

37−There are many places to buy a planet using either cryptocurrency or fiat.

35+There are many places to buy a planet using either crypto or fiat currency.

38

36

39−Layer 1 planets are the most available through marketplaces, however they can be expensive due to Ethereum gas fees. You will need an Ethereum wallet such as Metamask to purchase these planets, and will later need to sign in to Bridge with your wallet to configure your planet.

37+Layer 1 planets are the most available through marketplaces, however they can be expensive due to Ethereum gas fees. You will need an Ethereum wallet such as Metamask to purchase planets, and will later need to sign in to Bridge with your wallet to configure your planet.

40

38

41−Layer 2 planets do not require any crypto wallet management, but are at present less readily available on marketplaces.

39+Layer 2 planets do not require any crypto wallet management, but are only available on specific marketplaces.

42

40

43−Don’t worry, both types work the same on the network.

41+There is no difference between Layer 1 or Layer 2 in the quality of experience

42+when using Urbit.

44

43

45Here are a few of the places where you can buy planets:

44Here are a few of the places where you can buy planets:

46{% table .w-full .my-4 %}

45{% table .w-full .my-4 %}

@@ -64,7 +63,7 @@ Here are a few of the places where you can buy planets:

64

63

65**Layer 2 for planets**

64**Layer 2 for planets**

66

65

67−Learn more about [layer 2 for planets](/using/id/layer-2-for-planets) in the User's Manual page on the topic.

66+Learn more about [layer 2 for planets](https://operators.urbit.org/manual/id/layer-2-for-planets) in the User's Manual page on the topic.

68

67

69{% /callout %}

68{% /callout %}

70

69

@@ -75,7 +74,7 @@ An invitation to claim your planet comes in one of two forms.

75

74

76The first is an email invitation with an Urbit ID and a Master Ticket.

75The first is an email invitation with an Urbit ID and a Master Ticket.

77

76

78−The second, only recently made available through our [L2 solution](/using/id/layer-2-for-planets), is an activation code or a link to activate on [Bridge](https://bridge.urbit.org), which can be thought of as an Urbit account management tool.

77+The second, made available through our [L2 solution](https://operators.urbit.org/manual/id/layer-2-for-planets), is an activation code or a link to activate on [Bridge](https://bridge.urbit.org), the Urbit ID management tool.

79

78

80![](https://media.urbit.org/site/getting-started/Server-setup-1.jpg)

79![](https://media.urbit.org/site/getting-started/Server-setup-1.jpg)

81

80

@@ -103,22 +102,12 @@ Now that you have your planet, you can create your keyfile (eg. `sample-palnet.k

103- **L1 Planet Purchasers**

102- **L1 Planet Purchasers**

104 Log in to Bridge with your Ethereum wallet using Metamask or the wallet of your choice with WalletConnect. Click the “OS” box on the bottom of the page to open the OS page, and then click the **Download Keyfile** button.

103 Log in to Bridge with your Ethereum wallet using Metamask or the wallet of your choice with WalletConnect. Click the “OS” box on the bottom of the page to open the OS page, and then click the **Download Keyfile** button.

105

104

106−

107### Next steps

105### Next steps

108

106

109−Got your planet?

107+Now that you have a keyfile let's move on to booting the Urbit OS.

110−

111−Get it up and running with one of these options:

112−

113−- Let a [hosting provider](/getting-started/hosted) do the hard work for you.

114−

115−- [Try Port](/getting-started/desktop), the user-friendly desktop app.

116

108

117−- For power users, check out the [command line install

109+- [CLI instructions](/getting-started/cli) – Set up Vere, the Urbit runtime, using the command line.

118− guide](/getting-started/cli) and run your urbit from the terminal.

119

110

120−- If you have a bit of Linux server experience, the [cloud hosting

111+- [Install on the cloud](/getting-started/cloud-hosting) – A step-by-step guide to setting up Urbit on a VPS.

121− guide](https://operators.urbit.org/manual/running/hosting) will help you set

122− up Urbit on a Digital Ocean VPS, so you can access it from anywhere.

123

112

124−Remember, your planet is yours and you can always change how you run your urbit in the future.

113+- [Set up a home server](/getting-started/home-servers) – Explore options for running your own dedicated physical Urbit computer.

content/getting-started/getting-around.md+24−48

@@ -1,79 +1,55 @@

1+++

2+title = "Overview"

2−title = "Getting around"

3+description = "Getting around your urbit"

3−description = "Get around your urbit"

4+tag = "around"

4−weight = 4

5+weight = 0

5+++

6+++

6

7

7### 1. Get oriented

8### 1. Get oriented

8

9

9−After you've logged into your Urbit for the first time, you're officially an Urbiter! You've unlocked the entire Urbit network with your newly-minted ID — the key to your new digital life.

10+After you've logged into your Urbit for the first time, you'll have an interface called Landscape – a way interact with the network and applications. You'll also see a few pre-installed applications: Terminal, Groups, and Talk. More on them in a moment.

10

11

11−![](https://media.urbit.org/site/getting-started/Getting-around-1.jpg)

12+![](https://storage.googleapis.com/media.urbit.org/site/getting-started/get-oriented.png)

12

13

13−You'll see your Home and a few pre-installed applications: Terminal, Groups, and Bitcoin. More on them in a moment.

14+Above those are buttons to view System Preferences and check out notifications for messages and application activity. The search bar helps you surface applications you already have installed, or discover developers and applications across the Urbit network.

14

15

15−Above those are buttons to view System Preferences and Help and Support and check out notifications for newly-installed or recently-updated applications, respectively. The search bar helps you surface applications you already have installed, or discover developers and applications across the Urbit network.

16+![](https://storage.googleapis.com/media.urbit.org/site/getting-started/about-system.png)

16

17

17−You'll likely want to focus on finding and joining new communities, which you can do with the **Groups** app. Click on the box to open the application.

18+You'll likely want to focus on finding and joining new communities, which you can do with the **Groups** app.

18

19

19−### 2. Join a few groups with fellow Urbiters

20+### 2. Join a few groups

20

21

21−No two people will ever have the same experience on Urbit. That depends entirely on who you find and where they invite you to join them. But we can set you down a good path.

22+Joining public groups is simple – just search for the group host's Urbit ID, and click join. Check out a walk-through of this process in the [Joining groups](/getting-started/joining-groups) guide.

22

23

23−With Groups open, you'll see three boxes for **My Channels**, your local weather, and a stylized clock. You can dig into those later, but let's focus on joining new communities, which is likely one of the reasons you wanted to try out Urbit in the first place.

24+### 3. Install some applications

24−

25−Click on Join Group, and in that modal, enter [~bitbet-bolbel/urbit-community](/groups/~bitbet-bolbel/urbit-community) — the official Urbit community. You can either automatically join all channels by clicking the Join all channels checkbox, or leave it blank and hit Join Group right away. Your Urbit will connect to the P2P network and download information about the group, like a list of all its participants. When that's finished, click **View Group**.

26−

27−You're now looking at a single group and all of its channels. If you didn't choose to join all channels right away, click on an individual channel and then **Join Channel**, which immediately opens the feed of latest messages.

28−

29−Here are a few more useful groups to join:

30−

31−- [`~rondev/group-discovery`](/groups/~rondev/group-discovery): A group for finding other groups.

32−- [`~middev/the-forge`](/groups/~middev/the-forge): A group for sharing, discussing, and discovering new Urbit applications.

33−- [`~hocwyn-tipwex/uqbar-event-horizon`](/groups/~hocwyn-tipwex/uqbar-event-horizon): A community around [Uqbar](https://uqbar.network), a company creating applications and experiences on top of Urbit — notably EScape, which is an alternative to the default Groups application for joining communities and messaging with other Urbiters.

34−

35−### 3. Get more Urbit apps

36

25

37Groups are great, but Urbit goes way deeper with apps that are developed specifically for Urbit and use P2P networking for everything.

26Groups are great, but Urbit goes way deeper with apps that are developed specifically for Urbit and use P2P networking for everything.

38

27

39−We'll use [Canvas](/applications/~dister-norsyr-torryn/canvas) — a collaborative app for creating pixel art with others — as an example to show the process.

28+Check out the [Installing apps](/getting-started/installing-applications) guide for a walk-through on the process of installing Urbit applications.

40−

41−Head back to your Urbit's home — the URL you used to log in and view your preinstalled apps. From there, click on the search bar and enter `~dister-norsyr-torryn/canvas`. Click on the first result, which shows you details about the developer, the license, a website for more information, and when the app was last updated.

42−

43−Click **Get App**, then **Get "Canvas"** to continue. Your Urbit gets to work, and once installation is finished, click Open App to see it in action.

44

29

45−Some popular apps to get things moving:

46

30

47−- [EScape](/applications/~dister-fabnev-hinmur/escape): An alternative UI to the core groups, communities, and messaging capabilities in Urbit.

31+### 4. Explore interfaces

48−- [Studio](/applications/~tirrel/studio): Tools for making money on the Urbit network.

49−- [Wrdu](/applications/~magped-magped-rabsef-bicrym/wrdu): A Wordle clone.

50

32

51−### 4. Get help

33+The default Urbit experience is using Landscape in the browser, but Urbit is also available on native mobile and desktop applications through alternative interfaces. [Learn more about Urbit interfaces](/getting-started/interfaces).

52

34

53−If you need help getting around Urbit, the best place to go is the official Urbit community: [`~bitbet-bolbel/urbit-community`](/groups/~bitbet-bolbel/urbit-community). Those in the Help channel are willing to troubleshoot or provide links to resources to help you get out of a jam.

54

35

55−That community isn't for every support request, however. If your question involves an app, you're better served reaching out to the developer — for example, if you have an issue with EScape's notifications feature, reach out to Uqbar in [`~hocwyn-tipwex/uqbar-event-horizon`](/groups/~hocwyn-tipwex/uqbar-event-horizon).

36+### 5. Getting help

56

37

57−If you're having trouble with your planet or the hosting provider that's running your ship, try their support, as they'll have more context and resources to help solve your issue.

38+If you need help getting around Urbit, the best place to go is the official Urbit community: [`~bitbet-bolbel/urbit-community`](/groups/~bitbet-bolbel/urbit-community). Those in the Help channel are willing to troubleshoot or provide links to resources to help you get out of a jam. Note that Urbit Community can take a long time to join due to its size.

58

39

59−And if you can't get through this guide and launch into Urbit, you may have luck with the [Urbit Live community](https://t.me/UrbitLiveGroup) on Telegram.

40+If your question involves an app, you're better served reaching out to the developer. Many [developers](/ecosystem?type=organizations) have dedicated groups on the network explicitly for this purpose.

60

41

61−### 5. What's next?

42+If you're having trouble with your planet or the hosting provider that's running your ship, try their support, as they'll have more context and resources to help solve your issue. And you can always email support@urbit.org if you're having trouble getting onto the network.

62

43

63−You made it! You did the work and now have your Final Computer.

64

44

65−What you do with it is up to you. Where you go from here is up to you. No two experiences on Urbit will be the same, so we encourage you to follow your own. Explore. Discover! Get lost and find the people who make you feel like you're not lost any more.

66

45

67−Still need some bumpers to guide you along the way?

46+### 6. Next steps

68

47

69−**Learn more about using Urbit**: Check out the [User's Manual](/using/).

70

48

71−**Get updates about Urbit**: [Subscribe](https://urbit.us11.list-manage.com/subscribe/post?u=972a03db9e0c6c25bb58de8c8&id=be143888d2) to the Urbit Newsletter for new blog posts and events from one of the primary organizations responsible for Urbit development.

49+**Learn more**: Check out the [Operators Site](https://operators.urbit.org/) to learn more about running your own Urbit and how the network functions.

72

50

73−**Join an event or meetup**: Many of the organizations and people behind Urbit host virtual and in-person events on a regular basis — check out the latest on our [Events feed](/events/).

51+**Stay updated**: [Subscribe](https://urbit.us11.list-manage.com/subscribe/post?u=972a03db9e0c6c25bb58de8c8&id=be143888d2) to the Urbit Newsletter for news, blog posts, and upcoming events.

74

52

75−**Learn how to build on Urbit**: If you're the kind of person who wants to build applications directly for discerning communities with built-in identity and networking primitives, or even jump into the Urbit kernel's core, we have the most phenomenally-comprehensive information to get you started.

53+**Meet up**: Many of the organizations and people behind Urbit host virtual and in-person events on a regular basis — check out the latest on our [Events feed](/events/), or a local [Meetup group](/ecosystem?type=communities).

76

54

77−- Read the [Development Docs](/docs/).

55+**Build**: If you're the kind of person who wants to build applications directly for discerning communities with built-in identity and networking primitives, or even jump into the Urbit kernel's core, visit [Urbit Developers](https://developers.urbit.org/) to learn more.

78−- Check out the development-driven [Getting Started guide](/docs/development/develop).

79−- Join [Hoon School Live (HSL)](https://hooniversity.org), the cohort-driven course that teaches you Hoon, with the goal of getting you comfortable writing generators, working with core concepts, using the standard library, and distributing code using desks.

content/getting-started/home-servers.mdnew file+27

@@ -0,0 +1,27 @@

1++++

2+title = "Home servers"

3+weight = 5

4+description = "Options for hosting with a home server"

5+tag = "selfhost"

6++++

7+

8+There are a variety of tools that make running Urbit at home straightforward on dedicated hardware. If your enjoy hardware ownership and full embracing the spirit of decentralization, then these tools are for you.

9+

10+

11+## Native Planet

12+

13+[![Native Planet Tellurian](https://storage.googleapis.com/media.urbit.org/site/getting-started/native-planet.jpg)](https://www.nativeplanet.io/hardware)

14+

15+Purchase a [computer designed to run Urbit](https://www.nativeplanet.io/hardware), out of the box.

16+

17+## Groundseg & Startram

18+

19+[![Groundseg UI](https://storage.googleapis.com/media.urbit.org/site/getting-started/groundseg.png)](https://www.nativeplanet.io/software)

20+

21+Install these [Native Planet software packages](https://www.nativeplanet.io/software) to turn a Linux computer into an urbit that's accessible from anywhere in the world.

22+

23+## Umbrel

24+

25+[![Umbrel Screenshot](https://storage.googleapis.com/media.urbit.org/site/getting-started/umbrel.png)](https://umbrel.com/)

26+

27+Install the [Urbit application](https://subject.network/posts/urbit-apps-umbrel/) on a Raspberry Pi running [Umbrel](https://umbrel.com/).

content/getting-started/hosted.md+19−12

@@ -1,23 +1,30 @@

1+++

2−title = "Hosted urbit"

2+title = "Overview"

3+weight = 0

3−description = "Run Urbit on a managed service"

4+description = "Running Urbit with a hosting provider"

4−weight = 1

5+tag = "hostprov"

5+++

6+++

6

7

7−### 1. Select a hosting provider

8+Hosting providers are companies that offer "Urbit as a Service". They do the work of setting up your urbit in the cloud and making sure it's up to date and you don't have perform any technical steps or maintenance.

8

9

9−Hosting providers can sell you a planet and manage the hosting for you for a regular fee. We recommend [ThirdEarth](https://third.earth/) for quickly acquiring a planet and the hosting required to make your Urbit experience accessible from anywhere.

10+![Hosting Providers](https://storage.googleapis.com/media.urbit.org/site/getting-started/hosting-providers.png)

10

11

11−Two important points about hosting providers:

12+Generally, you'll get an Urbit ID by signing up with a hosting provider, but some allow you to bring your own Urbit ID, or even your pier (all your urbit data.)

12

13

13−- Because the provider has access to the resources that run your Urbit experience, you must trust them with your data.

14+While hosting providers offer convenience and customer support, hosting does

15+mean trusting your provider with your data, just as you would any internet

16+service company. Unlike typical internet services however, Urbit makes it

17+possible to leave a hosting provider with your Urbit ID, which you can then use

18+to switch hosting provider or self-host.

14

19

15−- Urbit has portable data, so you should be able to work with a hosting provider to download all your data and boot up elsewhere if you choose to migrate or start self-hosting.

20+The two important points one should remember about hosting providers:

16

21

17−### 2. Log in

22+- Because the provider has access to the resources that run your Urbit

23+ experience, you must trust them with your data.

24+- Urbit is designed to be portable, so your hosting provider will allow you to

25+ export all your data and boot up elsewhere if you choose.

18

26

19−The exact steps for logging into your Urbit will depend on your hosting provider's infrastructure and the flow they've developed. If you have questions about logging into your hosted Urbit ship, contact their support.

20

27

21−### Next steps

28+## Next steps

22

29

23−Learn how to [get around your urbit](/getting-started/getting-around).

30+[Explore Hosting Providers ->](/getting-started/hosting-providers)

content/getting-started/hosting-providers.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+title = "Hosting Providers"

3+weight = 2

4+description = "Companies that provide Urbit hosting as a service"

5+tag = "hostprov"

6++++

7+

8+

9+## Tlon

10+[Tlon](https://tlon.io) is the company responsible for creating Urbit, Landscape, Groups and Talk. [Tlon](https://tlon.io) offers Urbit hosting for free, which includes a planet of your choice.

11+

12+[![Tlon](https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/tlon-hosting-provider.png)](https://tlon.io/)

13+

14+## Planet One

15+

16+[Planet One](https://planet.one), a [Tirrel](https://urbit.org/organizations/tirrel) service, offers Urbit hosting for $15/month. You can also obtain hosting through their native Desktop application, [Scene](https://planet.one/scene).

17+

18+[![Planet One Hosting](https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/planetone-hosting.png)](https://planet.one/)

19+

20+## Third Earth

21+

22+[ThirdEarth](https://third.earth) offers hosting for $11.99/month. Third Earth is the only hosting provider that allows you to join with an existing Urbit ID and pier, i.e. a planet that you have already booted elsewhere. If you don't have a planet yet, they can also provide you with one.

23+

24+[![Third Earth Hosting](https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/thirdearth-hosting.png)](https://third.earth/)

content/getting-started/installing-applications.md+17−19

@@ -1,41 +1,39 @@

1+++

2title = "Installing apps"

3−tag = "additional"

3+tag = "around"

4weight = 3

5+++

6

7−### 1. Get on the network

7+Installing Urbit applications is simple. Search for the developer and download the application directly from them. We'll walk you through it.

8

9−First, you’ll need to get on Urbit. You can quickly check out the network by [downloading the Port application](https://github.com/urbit/port) and booting up a comet–a temporary Urbit ID.

9+### 1. Finding applications

10

11−For long-term use, you’ll want to get a permanent Urbit ID and consider a running your urbit in the cloud or on a hosted service.

11+To install an application, you'll need to know the ship it is distributed from, which is often its developer's Urbit ID, *e.g.* `~paldev` or `~dister-fabnev-hinmur`. If you know the application, you can enter the full shortcode, e.g. `~paldev/pals`.

12

13−Read our [Getting Started guide](https://urbit.org/install) for details.

13+You can find a [public directory of applications](/ecosystem?type=applications) in the Ecosystem section of urbit.org.

14

15−### 2. Finding applications

15+Not all applications are listed on urbit.org, so you’ll discover more by actively using Urbit and meeting people.

16

17−Urbit is still in its early stages, so you’ll need to join groups and browse around the network to discover new applications as they are being brought up.

17+However, we can get started by using a simple app from Urbit developer [`~paldev`](/ids/~paldev).

18

19−However, we can get started a simple app from Urbit developer [`~paldev`](/ids/~paldev).

19+### 2. Search for a Developer

20

21−### 3. Search for a Developer

22−

23−Once you’re on the network, you’ll see and large tiled interface with a few applications installed and a search bar on the top of the page.

21+Once you’re on the network, you’ll see a large tiled interface with a few applications and a search bar on the top of the page.

24

22

25Click and the search bar and search for the software provider’s Urbit ID.

23Click and the search bar and search for the software provider’s Urbit ID.

26

24

27−For example, to install the picture application, search for `~paldev` and then click on the result for `~paldev` to show his applications.

25+For example, to install the pals application, search for `~paldev` and then click on the result for `~paldev` to show the applications.

28

26

29−![](https://media.urbit.org/site/additional-guides/Installing-apps-1.jpg)

27+![](https://media.urbit.org/site/getting-started/install-apps-1.png)

30

28

31−![](https://media.urbit.org/site/additional-guides/Installing-apps-2.jpg)

29+![](https://media.urbit.org/site/getting-started/install-apps-2.png)

32

30

33−### 4. Get the Application

31+### 3. Get the Application

34

32

35−After selecting the “picture” app, a pane will open that shows some information about the application. Go ahead and click the “Get App” button, and confirm the following modal window to begin the installation process.

33+Select the pals app, and a modal window will open that shows some information about the application. Go ahead and click the “Get App” button, and confirm the following modal window to begin the installation process.

36

34

37−Soon you’ll have a new application tile on your home screen that will let you upload and display a picture to your home screen.

35+![](https://media.urbit.org/site/getting-started/install-apps-3.png)

38

36

39−![](https://media.urbit.org/site/additional-guides/Installing-apps-3.jpg)

37+Soon you’ll have a new application tile on your home screen. Now you can add people you know on the network as your pals just by entering their Urbit ID.

40

38

41−![](https://media.urbit.org/site/additional-guides/Installing-apps-4.jpg)

39+![](https://media.urbit.org/site/getting-started/install-apps-4.png)

content/getting-started/interfaces.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Interfaces"

3+weight = 4

4+description = "Ways to interact with Urbit"

5+tag = "around"

6++++

7+

8+Urbit ships by default with Landscape by [Tlon](https://tlon.io), a web-based interface for managing your ship and the software installed on it, and launching other web-based applications. However, there are many ways to interact with your Urbit.

9+

10+There's [EScape](https://urbit.org/applications/~fabnev-hinmur/escape), a fork of Groups that also has an accompanying mobile application. [Scene](https://tirrel.io/scene/index.html) and the (soon to be released) [Realm](https://www.holium.com/) offer native desktop window managers for your urbit. Lastly, there's the [Dojo](https://developers.urbit.org/overview/dojo) CLI interface for developers

content/getting-started/joining-groups.md+24−28

@@ -1,58 +1,54 @@

1+++

2title = "Joining groups"

3−tag = "additional"

3+tag = "around"

4weight = 2

5+++

6

7−### 1. Get on the network

7+Joining public groups is straightforward: search for the group host's Urbit ID, and join. Some groups are private, so you'll need approval to join.

8

9−First, you’ll need to get on Urbit. You can quickly check out the network by [downloading the Port application](https://urbit.org/getting-started/desktop) and booting up a comet–a temporary Urbit ID.

9+And still other groups are secret! Which means you can't find them, and you'll need to be invited to join.

10

11−For long-term use, you’ll want to get a permanent Urbit ID and consider a running your urbit in the cloud or on a hosted service.

11+Let's walk through the process of finding and joining a public group.

12

13−Read our [Getting Started guide](https://urbit.org/install) for details.

14

13

15−### 2. Open the Groups app

14+### 1. Open the Groups app

16

15

17−Once you’re on the network, you’ll see and large tiled interface with a few applications installed: Terminal, Groups, and Bitcoin. Click on Groups.

16+Once you’re on the network, you’ll see Landscape, which is filled with large applications tiles: Talk, Terminal, and Groups. Click on Groups.

18

17

19−![](https://media.urbit.org/site/additional-guides/Joining-groups-1.jpg)

18+![](https://storage.googleapis.com/media.urbit.org/site/getting-started/get-oriented.png)

20

19

21−### 3. Enter the group shortcode

20+### 2. Enter the group shortcode

22

21

23−We’ll start by joining Urbit Community, a friendly introductory Urbit group.

22+To join a group, you'll need to know its host Urbit ID (e.g. `~bitbet-bolbel`) or its full Urbit address, also called a shortcode (e.g. `~bitbet-bolbel/urbit-community`) .

24

23

25−In the Groups app, click the “Join Group” button and enter `~bitbet-bolbel/urbit-community`.

24+Check out some public groups in the [urbit.org groups directory](/ecosystem?type=groups)

26

25

27−Then confirm by clicking with the second “Join Group” button.

26+As an example, we’ll start by joining [UF Public](/groups/~halbex-palheb/uf-public), the Urbit Foundation's official group.

28

27

29−![](https://media.urbit.org/site/additional-guides/Joining-groups-2.jpg)

28+In the Groups app, click on "Find Groups" in the left column and enter `~halbex-palheb/uf-public`

30−![](https://media.urbit.org/site/additional-guides/Joining-groups-3.jpg)

31

29

32−### 4. Confirm join

30+Then click on the "Join" button once the group appears.

33

31

34−You should see a window that provides a description and group information. If not, check the spelling of the group name and address and try again.

32+![](https://media.urbit.org/site/additional-guides/groups-2.png)

35

33

36−Alternatively, the ship that is hosting the group may be offline.

37

34

38−Click "Join Urbit Community".

35+### 3. Join channels

39

36

40−![](https://media.urbit.org/site/additional-guides/Joining-groups-4.jpg)

37+After a few moments the default channels will load. For groups with a large backlog, such as Urbit Community (~bitbet-bolbel/urbit-community), this may take a few minutes.

41

38

42−### 5. Join channels

39+![](https://media.urbit.org/site/additional-guides/groups-3.png)

43

40

44−Congratulations, if you’re seeing a window like the one that appears below then you’ve joined the group!

45

41

46−There two types of channels in the left column: Chats, and Notebooks. The former is self-explanatory, while the latter is like a blog with optional comments.

42+We can join more channels in the group by clicking on the "All Channels" link in the left column.

47

43

48−To join a channel within the group, select a channel name from the left column, and click the Join Channel button.

44+![](https://media.urbit.org/site/additional-guides/groups-5.png)

49

45

50−![](https://media.urbit.org/site/additional-guides/Joining-groups-4.jpg)

51

46

52−![](https://media.urbit.org/site/additional-guides/Joining-groups-6.jpg)

53

47

54−### 6. Chat and post on the network

48+### 4. Chat and post on the network

55

49

56−Congratulations you’re now a part of a peer-to-peer Urbit group. Be friendly, be curious, and have fun.

50+In addition to posting text, you can now react, start threads, and reference messages by hovering over chat messages. And you can leave comments in notebooks if they are enabled.

57

51

52+Remember to be nice, and have fun.

53+

58−![](https://media.urbit.org/site/additional-guides/Joining-groups-7.jpg)

54+![](https://media.urbit.org/site/additional-guides/groups-4.png)

content/getting-started/self-host.mdnew file+33

@@ -0,0 +1,33 @@

1++++

2+title = "Overview"

3+weight = 1

4+description = "Running your own urbit"

5+tag = "selfhost"

6++++

7+

8+

9+To run Urbit on your own you need to be comfortable using a command line

10+interface (CLI), and should have a basic understanding of how to interact with

11+the Ethereum blockchain.

12+

13+Urbit OS is comprised of a virtual operating system (Arvo) and a runtime called

14+(Vere). The runtime has official versions targeting Linux and macOS, although

15+workarounds exist for Windows.

16+

17+Running Urbit locally is good for experimentation, but in the long term you'll

18+want to run it as a server — always on and accessible from anywhere. The nice

19+thing about Urbit is that's easy to start local, and later move to cloud hosting

20+or a home server. Or you can start with the latter options.

21+

22+**Remember, never run your Urbit in more than one place!** Doing so will necessitate

23+a [factory reset](https://operators.urbit.org/manual/id/guide-to-resets).

24+

25+## Next Steps

26+

27+- [Get an Urbit ID](/getting-started/get-id) – Get a planet, a permanent Urbit ID, for the best networked experience.

28+

29+- [CLI instructions](/getting-started/cli) – Set up Vere, the Urbit runtime, using the command line.

30+

31+- [Install on the cloud](/getting-started/cloud-hosting) – A step-by-step guide to setting up Urbit on a VPS.

32+

33+- [Set up a home server](/getting-started/home-servers) – Explore options for running your own dedicated physical Urbit computer.

content/grants/2019/bitcoin-node-json-rpc-api-part-1.md+2−1

@@ -13,7 +13,8 @@ reward = "1 star"

13assignee = ["yosoyubik"]

14id = "649469235"

15completed = true

16−link = ""

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

18+++

18

19

19#### Background

20#### Background

content/grants/2019/bitcoin-node-json-rpc-api-part-2.md+2−1

@@ -13,7 +13,8 @@ reward = "1 star"

13assignee = ["pkova"]

14id = "1577544668"

15completed = true

16−link = ""

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

18+++

18

19

19#### Background

20#### Background

content/grants/2019/bitcoin-node-json-rpc-api-part-3.md+2−1

@@ -13,7 +13,8 @@ reward = "1 star"

13assignee = ["yosoyubik"]

14id = "312452925"

15completed = true

16−link = ""

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

18+++

18

19

19#### Background

20#### Background

content/grants/2019/bitcoin-node-json-rpc-api-part-4.md+2−1

@@ -13,7 +13,8 @@ reward = "2 stars"

13assignee = ["yosoyubik"]

14id = "87854308"

15completed = true

16−link = ""

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

18+++

18

19

19#### Background

20#### Background

content/grants/2019/bitcoin-wallet-on-bridge.md+2−1

@@ -14,7 +14,8 @@ assignee = ["yosoyubik"]

14id = "273059635"

15completed = false

16canceled = true

17−link = ""

17+link = "~pindet-timmut/urbitcoiners"

18+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

18+++

19+++

19

20

20### Background

21### Background

content/grants/2020/bitcoin-full-node-provider-and-wallet.md+2−1

@@ -13,7 +13,8 @@ reward = "6 stars"

13assignee = ["~timluc-miptev"]

14id = "2056919898"

15completed = true

16−link = ""

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

18+++

18

19

19## Introduction

20## Introduction

content/grants/2020/bitcoin-key-derivation.md+2−1

@@ -13,7 +13,8 @@ reward = "2 stars"

13assignee = ["pkova"]

14id = "794126751"

15completed = true

16−link = ""

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

18+++

18

19

19## Overview

20## Overview

content/grants/2021/bitcoin-wallet-maintenance.md+2

@@ -13,6 +13,8 @@ reward = "3 stars"

13mentor = ["~timluc-miptev"]

14assignee = ["~finned-palmer"]

15completed = true

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

16work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0032&prefill_Grant+Name=Bitcoin%20Wallet%20Maintenance"

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0032&prefill_Grant+Name=Bitcoin%20Wallet%20Maintenance"

17+++

19+++

18

20

content/grants/2021/clojure-urbit-client.md+1−1

@@ -12,7 +12,7 @@ champion = ["~littel-wolfur"]

12assignee = ["~sorted-falnyd"]

13grant_id = "P0072"

14completed = false

15−canceled = false

15+canceled = true

16link = ""

17+++

18

content/grants/2021/ra-debugging-tools.md+3−3

@@ -9,9 +9,9 @@ image = ""

9description = "Debugging Tools"

10reward = "2 stars"

11mentor = ["~master-morzod"]

12−assignee = ["~nosmes-sibwyx", "~topfet-parmed"]

12+assignee = ["~topfet-parmed"]

13−completed = false

13+completed = true

14−canceled = true

14+canceled = false

15work_request_link = ""

16+++

17

content/grants/2021/volt-lightning-on-urbit.md+2−1

@@ -13,7 +13,8 @@ reward = "7 stars"

13assignee = ["~dasrun-fadben"]

14completed = true

15canceled = false

16−link = ""

16+link = "~pindet-timmut/urbitcoiners"

17+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

18+++

18

19

19## Introduction

20## Introduction

content/grants/2022/abacus.md+1−1

@@ -13,7 +13,7 @@ reward = "1 star ($1k bonus if done by Assembly)"

13assignee = ["~sorpes-ranrep"]

14grant_id = "B0160"

15champion = ["Holium"]

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0160&prefill_Grant+Name=Abacus"

18+++

19

content/grants/2022/app-engram.md+1−1

@@ -13,7 +13,7 @@ reward = "7 stars"

13assignee = ["~nolteg-tobtyc", "~dalsyr-diglyn"]

14grant_id = "B0128"

15champion = ["Holium"]

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0155&prefill_Grant+Name=Engram"

18+++

19

content/grants/2022/app-store.md+9−7

@@ -128,16 +128,18 @@ ETA: November 4th 2022.

128

129- Building the front end in ReactJS according to our design from Milestone 2.

130- Connect the front end to the back end, so that all roles can do everything they did in Milestone 2, but through a UI

131−- Add a search bar on the front end. It will be able to search by app name, Developer ship ID, tags, and possibly also pattern match through app descriptions.

131+- Add a search bar on the front end. It will be able to search by app name, Developer ship ID, tags, and possibly also pattern match through app descriptions.

132−

132+

133−**Milestone 4** - Front end customization and publication.

133+**Milestone 4** - Groups discovery and mobile view optimization.

134−ETA: January 6st 2023.

134+

135−

135+- As a curator, I want to list groups in my collection for users to browse

136−- Enable Developers and Curators to customize their pages. They will probably have a CSS file to customize which will be funneled to the User and be served on the User’s front end.

136+- As a user, I want to browse through a list of groups that a curator recommends to me

137+- As a user, I want to see a group’s name, description, and host, and join the group easily from the app store

138+- As a user, I want a mobile-optimized experience the app store so I can easily use the app inside the EScape mobile app or in a mobile browser

137- App Store will be published and downloadable on urbit

139- App Store will be published and downloadable on urbit

138- There will be detailed documentation for App Store, describing how it works and how to use it

140- There will be detailed documentation for App Store, describing how it works and how to use it

139- A github pull request will be submitted to [https://urbit.org/applications/submit](https://urbit.org/applications/submit)

141- A github pull request will be submitted to [https://urbit.org/applications/submit](https://urbit.org/applications/submit)

140−

142+

141### About Us

143### About Us

142

144

143I was looking for stuff to do which might actually do some good for the world. So here I am. My name is Jurij Jukić, ~dilryd-mopreg. I have about a year of programming experience, mostly in Python. I recently quit my job to come work on Urbit full time. I just finished App School Live and I’m looking to build and learn.

145I was looking for stuff to do which might actually do some good for the world. So here I am. My name is Jurij Jukić, ~dilryd-mopreg. I have about a year of programming experience, mostly in Python. I recently quit my job to come work on Urbit full time. I just finished App School Live and I’m looking to build and learn.

content/grants/2022/apprenticeship-extending-bitcoin.md+2

@@ -14,6 +14,8 @@ mentor = ["~dasrun-fadben"]

14assignee = ["~sipned-nistug"]

15grant_id = "A0113"

16completed = true

17+link = "~pindet-timmut/urbitcoiners"

18+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0138&prefill_Grant+Name=Extending%20the%20Bitcoin%20Provider%20API"

19work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0138&prefill_Grant+Name=Extending%20the%20Bitcoin%20Provider%20API"

18+++

20+++

19

21

content/grants/2022/astrolabe.md+3−2

@@ -14,9 +14,10 @@ reward = "5 stars"

14assignee = ["~midlev-mindyr"]

15champion = ["~norsyr-torryn"]

16grant_id = "P0099"

17−completed = false

17+completed = true

18canceled = false

19−link = ""

19+link = "~poster-hoster-midlev-mindyr/astrolabe"

20+deliverable = "~midlev-mindyr/astrolabe"

20

21

21+++

22+++

22

23

content/grants/2022/books-development.md+2

@@ -14,6 +14,8 @@ assignee = ["~nismut-tamwep"]

14champion = ["~dinleb-rambep"]

15grant_id = "B0189"

16completed = false

17+link = ""

18+deliverable = "~doller-doller-dozzod-dalten/books"

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0189&prefill_Grant+Name=Books%20Feature%20Development"

19work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0189&prefill_Grant+Name=Books%20Feature%20Development"

18+++

20+++

19

21

content/grants/2022/books.md+2

@@ -14,6 +14,8 @@ assignee = ["Quartus"]

14champion = ["~wolref-podlex"]

15grant_id = "B0109"

16completed = true

17+link = ""

18+deliverable = "~doller-doller-dozzod-dalten/books"

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0134&prefill_Grant+Name=Books%3A%20address%20and%20transaction%20manager"

19work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0134&prefill_Grant+Name=Books%3A%20address%20and%20transaction%20manager"

18+++

20+++

19

21

content/grants/2022/calendar-holium.md+1

@@ -14,6 +14,7 @@ assignee = [""]

14champion = ["Holium"]

15grant_id = "B0190"

16completed = false

17+canceled = true

17work_request_link="https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0190&prefill_Grant+Name=Calendar%20Feature%20Completion"

18work_request_link="https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0190&prefill_Grant+Name=Calendar%20Feature%20Completion"

18+++

19+++

19

20

content/grants/2022/chess-bounty.md+5−1

@@ -14,11 +14,13 @@ assignee = ["~bonbud-macryg", "~nordus-mocwyl", "~rovmug-ticfyn"]

14grant_id = "B0175"

15champion = ["~finmep-lanteb"]

16completed = false

17+link = ""

18+deliverable = "~finmep-lanteb/chess"

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0175&prefill_Grant+Name=Chess%3A%20Improved%2C%20Timed%2C%20%26%20Rated"

19work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0175&prefill_Grant+Name=Chess%3A%20Improved%2C%20Timed%2C%20%26%20Rated"

18+++

20+++

19

21

20# Rationale

22# Rationale

21−~finmep-lanteb is sponsoring the improvement of the Chess app to create an Urbit Chess experience comparable to that of any modern Chess website. The current Chess app meets the basic requirements to play a game with a friend, but lacks various quality of life features: move notifications, undo requests, %pals integration, etc. In addition, only unrated, correspondence games are currently possible. These missing features & improvements offer a great opportunity for a team of 3 novice Urbit developers (preferably three Hoon School Live and App School Live graduates) to work together to complete this bounty, each earning a star in the process.

23+[Omitted long matching line]

22

24

23The goals of this bounty are to resolve the quality of life issues present in the Chess app, as well as enable timed and rated games.

25The goals of this bounty are to resolve the quality of life issues present in the Chess app, as well as enable timed and rated games.

24

26

@@ -47,4 +49,6 @@ Never say never, but there is a strong preference for 3 novice developers to wor

47# Milestones and Compensation

49# Milestones and Compensation

48Each of the three Deliverables above is a milestone. However, since the reward is 3 stars and designed to be completed by a 3-person team, it seems likely that the compensation schedule would be "1 star per person upon full completion". Specific details will be agreed upon with the contributor team prior to starting work.

50Each of the three Deliverables above is a milestone. However, since the reward is 3 stars and designed to be completed by a 3-person team, it seems likely that the compensation schedule would be "1 star per person upon full completion". Specific details will be agreed upon with the contributor team prior to starting work.

49

51

52+**Bonus** 3 additional stars will be paid to the contributors (1 each) if work is completed before October 2023

53+

50

54

content/grants/2022/chronicle.md+1−1

@@ -13,7 +13,7 @@ reward = "2 stars ($4k bonus if done by Assembly)"

13assignee = ["~hanfel-dovned"]

14grant_id = "B0161"

15champion = ["Holium"]

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0161&prefill_Grant+Name=Chronicle"

18+++

19

content/grants/2022/community-meetups.mddeleted−43

@@ -1,43 +0,0 @@

1−+++

2−title = "Community Meetup"

3−date = "2022-07-22"

4−

5−[taxonomies]

6−grant_type = [ "Bounty" ]

7−grant_category = [ "Community" ]

8−

9−[extra]

10−image = ""

11−description = "Earn stars by building culture through local, recurring, and in-person urbit events"

12−reward = "1 star"

13−assignee = [""]

14−grant_id = "B0165"

15−champion = ["~dalweb-donfun"]

16−completed = false

17−work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0165&prefill_Grant+Name=Meetup%20Bounty"

18−+++

19−

20−# Requirements

21−- Meetups should be geographically based; if you have distributed, interest-based communities of which you are a part, check out Urbit Embassies for a way to build digital communities on Mars.

22−- Meetups must be publicized and include a public web line with event details (time, date, location), and should be actively promoted via social media, in-person recruitment, flyers, a website, etc. If you need a signal boost, email support@urbit.org.

23−- You must host a total of six meetups, with a targeted cadence of once a month.

24−- Creation and admin of an Urbit group for your locality to which all meetup attendees will be invited or a fully public group. This group should be actively maintained with info about upcoming events, copies of past presentation materials, and any other related meetup content.

25−- Sharing of materials generated in service of your meetup; similarly, things like presentation materials, flyers, and FAQs from other meetups will be made available for utilization, forking, or inspiration. For more info, contact ~sarlev-sarsen or ask for help in ~siddef/uf-meetups

26−- Completion of a pull request to the urbit.org github repo to add your meetup's information to the urbit.org/community/meetups page. If you have never submitted a pull request on github before, let us know and we will teach you how. You will need to provide the following:

27− - Location (City, State, GEO)

28− - `@p` of host(s)

29− - A link to your urbit group

30− - A link to your clearweb presence (i.e. Meetup.com)

31− - a short description of your meetup and typical events (<50 words)

32−- Regular and timely completion of the meetup report form, including:

33− - Number of attendees

34− - Email address for attendees who, in your judgement, have earned a planet

35− - Submission of presentation materials or notes on topics discussed, including presentation recordings if available.

36− - top 3-5 questions asked and the technical prowess of the questioner

37−# Encouraged Features

38−- Semi-regular presentations that introduce Urbit to newcomers, help members boot a comet, or introduce the more technical side of urbit are strongly suggested. Depending on the makeup of your meetup attendees, these presentations may be highly technical or they may be more philosophical--your call! Materials to get you started are available at ~wolref-podlex/foundation or by reaching out to ~sarlev-sarsen

39−- Having a collection of 'recommended groups' to which you can direct meetup attendees, such that they can begin to explore the Urbit network.

40−- As one of the main goals of meetups is to get people building on Urbit, once your meetup gains some traction, consider looking into proposal development for a grant on which members of your meetup can collaborate!

41−- While the specific requirements of the meetup bounty listed below can be summarized as "run a regular meetup", the overarching goal is to build a local community and onboard people to Urbit. Successful meetups will be judged by metrics like how many proposals have attendees submitted and completed and how many people have been onboarded who go on to positively contribute to the culture, technology, or creativity of the network. This does not mean that every meetup is expected to be full of developers or that a meetup that does not have a huge and ever-growing attendee list would be considered a failure. What it does mean is that community organizers and participants should become true champions for Urbit who can't help but share with everyone around them how Urbit can offer solutions to many of the pains of modern networked computing.

42−# Compensation

43−- Upon the completion of six meetup events and the associated meetup reports, one star will be paid out to the organizer.

content/grants/2022/cue.md+1−1

@@ -15,7 +15,7 @@ assignee = ["~mallus-fabres"]

15champion = ["~fabled-faster"]

16grant_id = "P0146"

17completed = false

18−canceled = false

18+canceled = true

19link = ""

20

21+++

content/grants/2022/desk-import-export.md+2−2

@@ -11,9 +11,9 @@ image = ""

11description = "Improve the application development experience through simplified importing and exporting of desks."

12reward = "2 stars"

13champion = ["~tinnus-napbus"]

14−assignee = [""]

14+assignee = ["~niblyx-malnus"]

15grant_id = "B0187"

16−completed = false

16+completed = true

17work_request_link="https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0187&prefill_Grant+Name=Desk%20jamfile%20import%2Fexport"

18+++

19

content/grants/2022/digital-storefront.md+2−2

@@ -63,9 +63,9 @@ Shop:

63 ==

64```

65## User Stories

66−- John Murphy is a social media influencer who wants to sell his jazz album on the web. He looked at selling it using Shopify, but was turned off at the idea that he'd be dependent on Shopify and wouldn't be able to export his data if he ever wanted to move to a different webstore provider. John wants an online store solution that allows him to run the webstore himself on the server at his house without having to fiddle with it. John decides to download Tirrel Studio, because he heard they just added online store functionality. He sets up his website, adds his product details, decides how much it should cost, and then requests to be a merchant through their payment processor. John feels good knowing that he owns all of his shop's data and software, and that his only external dependency is on a payment processor that he could switch out for a different one.

66+[Omitted long matching line]

67

68−- Timothy Gunn is an online conspiracy theorist who writes articles about the new world order. He has an avid online following, but sometimes his posts get too juicy for conventional platforms. He doesn't trust Substack and wants to host his newsletter himself but still get paid. His audience is a little too normie to use Bitcoin, and Bitcoin isn't that convenient for payments these days anyway. Timothy sets up his newsletter site via Studio, imports his mailing list from his old Mailchimp newsletter, requests to be a merchant, and then adds pay-walls in front of his best posts. Now he's ready to make money on his own terms.

68+[Omitted long matching line]

69

70- Jimmy Takeria is a big calisthenics guy who teaches other guys how to get jacked. He makes informational videos and posts them to YouTube as well as running a Discord community about calisthenics. Jimmy doesn't like YouTube and Discord's new misinformation policies because he has unconventional ideas about nutrition. Jimmy decides to move his community off of Discord and into Groups on Urbit, and sets up a Studio webstore where he sells access to his latest workout videos and cutting edge nutritional info on a subscription basis. He's satisfied that he can manage his entire online business using Urbit.

71

content/grants/2022/eth-wallet.md+1

@@ -13,6 +13,7 @@ reward = "3 stars + $15k USD"

13assignee = [""]

14grant_id = "B0158"

15completed = false

16+canceled = true

16work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0158&prefill_Grant+Name=Urbit%20Native%20Ethereum%20Wallet"

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0158&prefill_Grant+Name=Urbit%20Native%20Ethereum%20Wallet"

17+++

18+++

18# Overview

19# Overview

content/grants/2022/eyre-scry.md+1−1

@@ -13,7 +13,7 @@ reward = "5 stars"

13assignee = ["~watter-parter"]

14champion = ["~tirrel"]

15grant_id = "B0151"

16−completed = false

16+completed = true

17canceled = false

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefillGrant+ID=B0151&prefillGrant+Name=Eyre%20Request%20Cache"

19+++

content/grants/2022/filesharer.md+1

@@ -13,6 +13,7 @@ reward = "2 stars"

13assignee = ["~tinden-pontev"]

14grant_id = "P0102"

15completed = false

16+canceled = true

16link = ""

17link = ""

17+++

18+++

18

19

content/grants/2022/gather.md+1−1

@@ -14,7 +14,7 @@ reward = "4 stars"

14assignee = ["~polrel-witter", "~pontus-fadpun"]

15champion = ["~dolweb-donfun", "~dinleb-rambep"]

16grant_id = "P0166"

17−completed = false

17+completed = true

18canceled = false

19link = ""

20

content/grants/2022/gnosis-safe.md+1−1

@@ -14,7 +14,7 @@ reward = "2-3 stars"

14assignee = ["~witfyl-ravped"]

15champion = ["~dinleb-rambep"]

16grant_id = "P0154"

17−completed = false

17+completed = true

18canceled = false

19work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0154&prefill_Grant+Name=Gnosis%20Safe"

20

content/grants/2022/gora-apprentice.md+2

@@ -15,6 +15,8 @@ assignee = ["~soctun-ridsyr"]

15grant_id = "A0192"

16completed = false

17canceled = false

18+link = ""

19+deliverable = "~dalten/gora"

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0192&prefill_Grant+Name=Gora%20Apprenticeship"

20work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0192&prefill_Grant+Name=Gora%20Apprenticeship"

19+++

21+++

20

22

content/grants/2022/hoon-eval.md+1−1

@@ -12,7 +12,7 @@ description = "Build an eval command and a stateless REPL mode in vere"

12reward = "1 star"

13mentor = ["~master-morzod"]

14assignee = ["~mopfel-winrux"]

15−completed = false

15+completed = true

16canceled = false

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0161&prefill_Grant+Name=Hoon%20Eval%20and%20REPL"

18+++

content/grants/2022/http-server-driver.mdnew file+98

@@ -0,0 +1,98 @@

1++++

2+title = "HTTP Server IO Driver"

3+date = "2022-11-28"

4+

5+[taxonomies]

6+grant_type = [ "Bounty" ]

7+grant_category = [ "Core Dev", "Runtime" ]

8+

9+[extra]

10+image =""

11+description = "Rewrite the HTTP server driver in Rust"

12+reward = "2 stars"

13+mentor = ["~fanfun-mocbud"]

14+assignee = ["~soctun-ridsyr"]

15+grant_id = "B0208"

16+completed = false

17+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0208&prefill_Grant+Name=HTTP%20Server%20IO%20Driver"

18++++

19+

20+# HTTP Server IO Driver

21+

22+## Context

23+

24+All IO drivers in the Urbit runtime currently run in the same process, which is

25+called the "urth" or "king" process. As part of an effort to both increase

26+security and scalability in the runtime, we are splitting each IO driver into

27+its own process, which is capable of communicating over local (i.e. pipes) or

28+remote (i.e. TCP sockets) communication channels.

29+

30+## Description

31+

32+In the [IO drivers repo](https://github.com/urbit/io_drivers), we use the

33+following abstract model of a driver:

34+

35+```

36+ INPUT SOURCE

37+ |

38+ | serialized request (length-encoded, jammed noun)

39+ |

40++---------------+

41+| INPUT TASK |

42++---------------+

43+ |

44+ | deserialized request (noun)

45+ |

46++---------------+

47+| HANDLING TASK |

48++---------------+

49+ |

50+ | deserialized response (noun)

51+ |

52++---------------+

53+| OUTPUT TASK |

54++---------------+

55+ |

56+ | serialized response (length-encoded, jammed noun)

57+ |

58+ OUTPUT SINK

59+```

60+

61+For this bounty, you must rewrite the HTTP server IO driver in

62+[`pkg/urbit/vere/io/http.c`](https://github.com/urbit/urbit/blob/master/pkg/urbit/vere/io/http.c)

63+in the [Urbit repo](https://github.com/urbit/urbit) to fit the driver model

64+described above in a new module [`src/http/server.rs`] in the

65+[IO drivers repo](https://github.com/urbit/io_drivers) with `stdin` and `stdout`

66+as the input source and output sink, respectively. The [HTTP client

67+driver](https://github.com/urbit/io_drivers/blob/master/src/http/client.rs) and

68+[file system driver](https://github.com/urbit/io_drivers/blob/master/src/fs.rs)

69+will serve as useful references.

70+

71+## Requirements

72+

73+- Knowledge of C and Rust.

74+- Experience with asynchronous, task-based programming.

75+- Familiarity with HTTP.

76+

77+## Resources

78+

79+- [Scalable

80+ IO](https://gist.github.com/mcevoypeter/a682dcd2d7c037c3b96de7268a7c2617)

81+- [Scaling Urbit's

82+ Runtime](https://gist.github.com/mcevoypeter/fe0270c9a4a72a9350c0f8944612bbf6)

83+

84+

85+## Deliverables

86+

87+- A thoroughly-documented HTTP server driver implementation in

88+ `src/http/server.rs` using `stdin` and `stdout` as the input source and output

89+ sink, respectively.

90+- A complete suite of unit tests structured as a `tests` module in

91+ `src/http/server.rs` that exercises the conversions from request nouns into

92+ driver-specific data structures and from driver-specific data structures into

93+ response nouns.

94+- A complete suite of integration tests in `tests/http_server_tests.rs` that run

95+ the spawn the HTTP server driver in a separate process and feed it requests as

96+ jammed nouns.

97+

98+Upon completion of all deliverables, you will receive two (2) stars.

content/grants/2022/keep.mdnew file+119

@@ -0,0 +1,119 @@

1++++

2+title = "Keep"

3+date = "2022-11-25"

4+

5+[taxonomies]

6+grant_type = [ "Proposal" ]

7+grant_category = [ "App Dev"]

8+

9+[extra]

10+image = ""

11+description = "Keep: Arbitrary Agent State Restoration Agent + Wrapper"

12+reward = "6 star"

13+assignee = ["~wicrum-wicrun", "~sogrum-savluc"]

14+grant_id = "P0184"

15+champion = ["~rabsef-bicrym"]

16+completed = false

17++++

18+

19+## Purpose

20+Keep is Urbit’s first agent-state backup utility. Outside of the Flag Day script and other areologic phenomena, the breach has been an impenetrable barrier for Urbit pilots and their data. Agent state has been, as a result, considered ephemeral trans-breach.

21+

22+## Rationale - Keep

23+

24+Urbit will eventually be a perfect diamond protocol at the center of a computing dynasty. Until that time, however, people will experience issues with their urbits. Sometimes, people will breach.

25+

26+Unfortunately, to date, data continuity across breach has remained technically possible but practically impossible for users.

27+

28+![a recent question in urbit community about restoring groups across breaches](https://i.imgur.com/i1xMhH1.png)

29+

30+Enter Keep!

31+

32+### Keep

33+

34+As new and interesting software appears on network, users create an ever-expanding series of data-persistence expectations that Urbit must uphold, in order to gain their trust. Backing up agent state, therefore, needs to be a protocol that a user can **_arbitrarily apply to any agent they use, regardless of whether the original code afforded for such backups_**. Keep is that protocol. Utilizing a wrapper library, a user can add backup functionality to any agent. With the Keep agent, that library-wrapped agent's state can be held and hot-reloaded into an agent, should it be `nuke`d or otherwise lose its state.

35+

36+## User Stories

37+

38+* Import

39+ * [ ] Recover an Agent's `state` from a saved file - potentially transferrable between ships, or at least over rifts

40+* Export

41+ * [ ] Export an Agent's `state` to a file on underlying file system (e.g. Unix) - in the `/path/to/pier/.urb/put` directory

42+* Backup/Restore

43+ * [ ] Backup an Agent's `state` to a central agent, on the same ship or a moon of that ship, or many ships (distributed backup)

44+ * [ ] Once and/or on a recurring basis

45+ * [ ] Restore an Agent's `state` from a central agent, on the same ship or a moon of that ship

46+ * [ ] Request from a backup provider that, should I ever breach in the future, they will automatically send me a DM with instructions on how to restore the agents whose states they store for me

47+

48+### Export to Disk - Details

49+* [ ] User can see and select from available Agents that have been wrapped in Keep's library

50+* [ ] User can select an Agent to back up to disk

51+* [ ] User can click a button to begin the export

52+* [ ] User is told that the export will/has begun and is given an indicator as to where the file will go (this will always be the `/path/to/pier/.urb/put` directory, but we can also specify, a priori, the file name)

53+ * [ ] User's data is exported to an intelligibly named folder - if backups are recurring, some indication as to recency of the last backup is provided to the user.

54+

55+### Import from File - Details

56+* [ ] User can import a `jam` file of agent-state, if that jam file is saved on a mounted disk available to the ship in question.

57+* [ ] User can import a `jam` file of agent-state through a web-portal to avoid impacting clay and loom size more than necessary.

58+* [ ] User's `jam` file is applied as restoration-of-state to the agent to which it belongs.

59+* [ ] User is informed that the restoration is underway/has completed

60+

61+#### Network Restoration

62+* [ ] User is given instructions to wrap an agent

63+ * Currently, this requires a code modification, see implementation notes.

64+* [ ] User can see all "wrapped" agents

65+

66+##### Backup (User)

67+* [ ] User can choose to backup an Agent's `state`:

68+ * `once` - an instant time

69+ * `many` - on a recurring basis, every `x-time`

70+* [ ] User is informted that a backup is underway/has completed successfully

71+* [ ] Users can see any backups they have currently stored, per Agent

72+

73+##### Restore (User)

74+* [ ] Users can choose to restore an Agent's `state`

75+* [ ] User is informed that a restoration is underway/has completed successfully

76+

77+##### Backup (Server)

78+* [ ] Admin can manually (de/)whitelist ships that can send them backups

79+* [ ] Admin can automatically (de/)whitelist ships using `gora` or the bitcoin wallet

80+* [ ] Visualize which pairs of ships and their agents are stored in backup, accompanied by their size

81+

82+##### Restore (Server)

83+* [ ] Admin can toggle between automatically sending (or not sending) instructions via DM to any breached ships (by reading azimuth state) for which Admin holds backups

84+

85+## Milestones

86+

87+* **Milestone 1:**

88+ Delivery: November 20, 2022

89+

90+ Reward: 5 stars

91+

92+ Tasks:

93+

94+ * [ ] Keep is available for installation from a distribution moon.

95+ * [ ] Keep distributes with its wrapper library and full documentation on `%docs` that walks a user through adding the wrapper library to a software of the user's choice

96+ * [ ] Keep's "server" system is implemented to install locally, however instructions for prospective providers are included in the `%docs`.

97+

98+* **Milestone 2:**

99+ Delivery: Pending on Solid State Subscription

100+

101+ Reward: 1 Star

102+

103+ Tasks:

104+

105+ * [ ] Keep is implemented with Glue + Bank - Glue is an upcoming middleware aggregator system that will make appending and prepending agent transformers to an agent easier. Bank is a system whereby use of an agent can be payrolled. With these two component parts, Keep will be a viable service model for providers - they could charge to back up and maintain state for their clients and gate restoration functions behind the same paywall.

106+

107+* **Milestone 3**

108+

109+ Delivery: After Milestone 2, Community Outreach Required

110+

111+ No Additional Compensation

112+

113+ Tasks:

114+

115+ * [ ] Keep is in use by some hosting provider to provide backup and restoration utilities to their Urbit clients.

116+ * [ ] Provider speaks to this fact.

117+ * [ ] Agents are being shipped pre-wrapped in Keep for convenience.

118+ * [ ] Developers speak to this fact.

119+ **No Additonal Compensation**

content/grants/2022/lexicon.md+1−1

@@ -13,7 +13,7 @@ reward = "1 star ($3k bonus if done by Assembly)"

13assignee = ["~bitful-pannul"]

14grant_id = "B0162"

15champion = ["Holium"]

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0162&prefill_Grant+Name=Lexicon"

18+++

19

content/grants/2022/lightning-development.md+2

@@ -14,6 +14,8 @@ assignee = ["~tondes-sitrym"]

14grant_id = "P0183"

15champion = ["~hastuc-dibtux"]

16completed = false

17+link = "~pindet-timmut/urbitcoiners"

18+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

17+++

19+++

18

20

19# Introduction

21# Introduction

content/grants/2022/loom-pointer-compression.md+1−1

@@ -13,7 +13,7 @@ reward = "1 star"

13mentor = ["~fanfun-mocbud"]

14assignee = ["~barter-simsum"]

15grant_id = "A0173"

16−completed = false

16+completed = true

17canceled = false

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0173&prefill_Grant+Name=Loom%20Pointer%20Compression"

19+++

content/grants/2022/membrane.md+3−2

@@ -13,7 +13,8 @@ champion = ["~sarlev-sarsen"]

13grant_id = "P0138"

14completed = false

15canceled = false

16−link = ""

16+link = "~tiller-tolbus/membrane"

17+deliverable = "~tiller-tolbus/membrane"

17+++

18+++

18

19

19# Intro

20# Intro

@@ -53,7 +54,7 @@ Payment: 2 stars

53

54

54## Milestone 2

55## Milestone 2

55

56

56−Expected Completion: November 2022

57+Expected Completion: May 2023

57

58

58Payment: 3 stars

59Payment: 3 stars

59

60

content/grants/2022/middleware-apprentice.md+1−1

@@ -13,7 +13,7 @@ reward = "1 star"

13mentor = ["~wicrum-wicrun"]

14assignee = ["~litlep-nibbyt"]

15grant_id = "A0193"

16−completed = false

16+completed = true

17canceled = false

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0193&prefill_Grant+Name=Middleware%20Apprenticeship"

19+++

content/grants/2022/minesweeper.md+1−1

@@ -13,7 +13,7 @@ reward = "1 star ($2k if done by Assembly)"

13assignee = ["~hanfel-dovned"]

14grant_id = "B0163"

15champion = ["Holium"]

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0163&prefill_Grant+Name=Minesweeper"

18+++

19

content/grants/2022/nested-goals.md+3−2

@@ -11,9 +11,10 @@ reward = "6 stars"

11champion = ["~tacryt-socryp"]

12assignee = ["~niblyx-malnus"]

13grant_id = "P0143"

14−completed = false

14+completed = true

15canceled = false

16−link = ""

16+link = "~dister-dozzod-niblyx-malnus/proposal-nested-goals"

17+deliverable = "~niblyx-malnus/gol-cli"

17+++

18+++

18

19

19# Project Description

20# Project Description

content/grants/2022/notifications-protocol.md+1−1

@@ -14,7 +14,7 @@ mentor = ["~rovnys-ricfer"]

14assignee = ["~novned-tidsyl", "~boldur-dashes"]

15grant_id = "A0136"

16completed = false

17−canceled = false

17+canceled = true

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0163&prefill_Grant+Name=Notifications%20Protocol"

19

20+++

content/grants/2022/peat.md+2−1

@@ -16,7 +16,8 @@ champion = ["~sarlev-sarsen"]

16grant_id = "P0174"

17completed = false

18canceled = false

19−link = ""

19+link = "~magped-magped-rabsef-bicrym/peat"

20+deliverable = "~magped-magped-rabsef-bicrym/peat"

20

21

21+++

22+++

22

23

content/grants/2022/pony-bounty.md+1−1

@@ -13,7 +13,7 @@ reward = "4 stars"

13assignee = ["~hanfel-dovned"]

14champion = ["~sarlev-sarsen"]

15grant_id = "B0191"

16−completed = false

16+completed = true

17work_request_link="https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0191&prefill_Grant+Name=Pony"

18+++

19

content/grants/2022/port-to-hosting.md+1

@@ -14,6 +14,7 @@ champion = ["~latter-bolden"]

14assignee = [""]

15grant_id = "B0194"

16completed = false

17+canceled = true

17work_request_link="https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0194&prefill_Grant+Name=Port%20to%20Hosting%20Onboarding%20Protocol"

18work_request_link="https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0194&prefill_Grant+Name=Port%20to%20Hosting%20Onboarding%20Protocol"

18+++

19+++

19

20

content/grants/2022/profiling.md+1−1

@@ -13,7 +13,7 @@ reward = "1 star"

13mentor = ["~fanfun-mocbud"]

14assignee = ["~pontus-fadpun"]

15grant_id = "A0180"

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0180&prefill_Grant+Name=Vere%20Profiling"

18+++

19

content/grants/2022/qr-login.md+2−1

@@ -16,7 +16,8 @@ champion = ["~fabnev-hinmur"]

16grant_id = "P0186"

17completed = true

18canceled = false

19−link = ""

19+link = "~hoster-dozzod-sortug/qr-login"

20+deliverable = "~sortug/gate"

20

21

21+++

22+++

22

23

content/grants/2022/quorum.md+1−1

@@ -13,7 +13,7 @@ reward = "3 stars"

13assignee = ["~tamlut-modnys", "~litlep-nibbyt", "~sidnym-ladrut"]

14grant_id = "B0167"

15champion = ["~lagrev-nocfep"]

16−completed = false

16+completed = true

17+++

18

19## Purpose

content/grants/2022/regex-library.md+1−1

@@ -13,7 +13,7 @@ reward = "3 stars"

13mentor = ["~lagrev-nocfep"]

14assignee = ["~macrep-racdec"]

15grant_id = "B0149"

16−completed = false

16+completed = true

17canceled = false

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0177&prefill_Grant+Name=Regular%20Expressions%20Library"

19+++

content/grants/2022/seguro-phase-2.md+1−1

@@ -14,7 +14,7 @@ reward = "5 stars"

14assignee = ["~mastyr-bottec"]

15champion = ["~master-morzod"]

16grant_id = "P0168"

17−completed = false

17+completed = true

18canceled = false

19link = ""

20

content/grants/2022/serving-the-people.mdnew file+101

@@ -0,0 +1,101 @@

1++++

2+title = "Hari + Rama (The Urbit Cyclopaedia)"

3+date = "2022-03-25"

4+

5+[taxonomies]

6+grant_type = [ "Bounty" ]

7+grant_category = [ "App Dev" ]

8+

9+[extra]

10+image = ""

11+description = "Facilitating 'A literal but delinquent reprint of the Encyclopedia Schizophrenica on Urbit'."

12+reward = "6 stars"

13+assignee = ["~rabsef-bicrym", "~sogrum-savluc"]

14+grant_id = "B0211"

15+champion = ["~sarlev-sarsen"]

16+completed = false

17+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0211&prefill_Grant+Name=STP%20Cyclopaedia"

18++++

19+

20+# Hari + Rama (The Urbit Cyclopaedia)

21+

22+## Rationale

23+

24+Serving the People DAO would like to move some of their content onto the Urbit network. In order to do that, they need additional controls and facilities on top of the New Groups (and Diary) product Tlon will soon be releasing. Hari and Rama are a server and client agent for generating, maintaining, and connecting to "Foundations", groups that create Encyclopedias. Hari and Rama maintain additional metadata regarding the Encyclopedia, including folders, tags, permissioned authors and editors, opt-in view-count-per-post and unique-view tracking for the server.

25+

26+## Overview

27+* `hari:` An Encyclopedia Schizophrenica Server, on Urbit. Generates "Foundations" and allows `rama` clients to connect to them to receive metadata.

28+* `rama:` A client for injesting additional metadata about groups, from `hari`. Note that it is not necessary for a user to use `rama` to read the contents of a Foundation's Encyclopedia (though they won't have the full experience).

29+

30+## User Stories

31+

32+### Hari

33+1. I can create a Foundation (meaning a Public Group, with a section called "<my input>-paedia", that contains a Diary that only I can write to, but who's posts anyone can comment on.

34+

35+2. On creating such a Foundation, I associate with it some versionable set of metadata, which I can modify using a series of commands (initially, as below):

36+> Note: Hari contains both the state that rama normally carries plus some additional information that is not shared to clients.

37+

38+> Note: Hari's command set relating to metadata allows the host to set the folders and tags that are allowed on their Foundation. If authors (almoners) or janitors tag/retag some document with a tag not in the allowed list (`tags.public`), those tags will be stripped but stored in `proposed-tags.secret` whereupon the admin can approve those tags for later use.

39+```

40+++ states

41+ |%

42+ +$ rama

43+ $: folders=(jug term @ud)

44+ authors=(jug @p @ud)

45+ views=(map @ud @ud)

46+ tags=(jug term @ud)

47+ ==

48+ +$ hari

49+ $: public=rama

50+ $= secret

51+ $: proposed-tags=(set term)

52+ unique-views=(jug @ud @p)

53+ ==

54+ ==

55+ --

56+```

57+

58+3. For each Foundation that I create, I can permission a set of Almoners (writers) and Janitors (editors) for my Foundation.

59+ * Almoners can submit new articles and edit their own articles.

60+ * Janitors can retag/folder articles, edit articles, delete comments.

61+

62+4. I can also close my Foundations at will, and cause the relevant Groups cleanup activities.

63+

64+5. All metadata that I collect will be parsed into Hari. The public facing portions of this (de-identified) will be shared back to Rama users.

65+

66+6. Though I am technically the only writer to the Foundation, I will preserve metadata about authors when they send me articles they write.

67+

68+### Rama

69+

70+1. I can watch any number of providers, whereupon I will learn of the Foundations they host.

71+

72+2. I can join any Foundation or leave any Foundation from any host I watch, and Rama will track for me which I am in (despite being able to see this in Groups).

73+

74+3. I can allow or disallow the capture of my viewing information for metrics to my Foundation provider.

75+

76+4. I can save/delete articles into a list of my own (later editions might allow you to set up a Foundation from these materials).

77+

78+5. I can receive metadata updates from the host including new articles being added to folders, tags, new view counts, etc.

79+

80+6. I can view Foundations through standard Groups or through an interface that enriches that experience with the metadata captured by Hari and Rama.

81+

82+## Architecture

83+

84+The Foundation system will piggyback off of the New Groups system for content delivery. All Foundations will be legible and interactable through Groups, though they will lack some of the convenience of the metadata system that Hari and Rama afford.

85+

86+## Milestones

87+

88+### Milestone 1 - 3 stars

89+

90+* Initial product provided to STP for Front End Development

91+* Product includes all features described in user stories above

92+* Product documentation includes step-by-step instructions for interacting through a JavaScript Front End.

93+

94+### Milestone 2 - 2 stars

95+

96+* Front End Development is in progress and STP identifies that all required components are in place for the completion of Front End Development, inclusive of any additions, changes, deletions, modifications to the interaction pattern required to complete the desired activities (see user stories).

97+

98+### Milestone 3 - 1 star

99+

100+* Product is deployed and available for installation on Urbit.

101+* All user stories are satisfied, an application listing is available at urbit.org/ecosystem and documentation is available via `%docs`.

content/grants/2022/slam.md+2−1

@@ -12,7 +12,8 @@ assignee = ["~hanfel-dovned"]

12champion = ["~rabsef-bicrym"]

13grant_id = "P0101"

14completed = true

15−link = ""

15+link = "~hanfel-dovned/arcadia"

16+deliverable = "~hanfel-dovned/slam"

16+++

17+++

17

18

18## Overview

19## Overview

content/grants/2022/slaw-scot-jets.md+2−2

@@ -10,8 +10,8 @@ grant_category = [ "Core Dev" ]

10image = ""

11description = "Tune slaw/scot jets for better perfomance."

12reward = "1 star"

13−mentor = ["~master-morzod"]

13+mentor = ["~lagrev-nocfep"]

14−assignee = [""]

14+assignee = ["~ponmep-litsem"]

15grant_id = "B0137"

16completed = false

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0164&prefill_Grant+Name=Tune%20slaw%2Fscot%20Jets"

content/grants/2022/smart-lightbulb-controller.md+1−1

@@ -14,7 +14,7 @@ reward = "4 stars"

14assignee = ["~pilwyc-fastec", "~larryx-woldyr"]

15champion = ["~simfur-ritwed"]

16grant_id = "P0199"

17−completed = false

17+completed = true

18canceled = false

19link = ""

20

content/grants/2022/symmetric-routing.md+1−1

@@ -14,7 +14,7 @@ mentor = ["~rovnys-ricfer"]

14assignee = ["~novned-tidsyl", "~boldur-dashes"]

15grant_id = "A0135"

16completed = false

17−canceled = false

17+canceled = true

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0162&prefill_Grant+Name=Symmetric%20Routing"

19+++

20

content/grants/2022/trill-ufa.md+1

@@ -17,6 +17,7 @@ grant_id = "P0127"

17completed = true

18canceled = false

19link = ""

20+deliverable = "~sortug/trill"

20

21

21+++

22+++

22# Purpose

23# Purpose

content/grants/2022/trove.md+1−1

@@ -13,7 +13,7 @@ reward = "4 stars ($8k bonus if done by December 12, 2022)"

13assignee = ["Quartus"]

14grant_id = "B0164"

15champion = ["Holium"]

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0164&prefill_Grant+Name=Trove"

18+++

19

content/grants/2022/urbit-forms.md+1

@@ -17,6 +17,7 @@ grant_id = "P0110"

17completed = true

18canceled = false

19link = ""

20+deliverable = "~donpub-datdux/forms"

20

21

21+++

22+++

22

23

content/grants/2022/urbit-interface-framework.md+69−60

@@ -17,63 +17,72 @@ completed = false

17canceled = false

18+++

19

20−# Rationale

20+Proposal to develop web application creation tooling and framework in hoon following [thick stateful server single-page application architecture](https://en.wikipedia.org/wiki/Single-page_application#Thick_stateful_server_architecture).

21−

21+

22−I'm proposing to write code for what could become an alternative urbit web browser interface alongside Landscape, Escape, Holium and maybe others I've yet to see.

22+The framework is abstracted into a library that is used by a gall agent. The gall agent defines the application's data model and state controller. View model is defined separately from the agent. This ensures that agent api remains as is and, if needed, agent could implement multiple different view/UI models, e.g some other UI framework that is targeting different kind of device instead of web browser. It also means existing agents can plug in the view model defined with this framework without making changes to agent data and controller model.

23−This interface basically functions like website builder [Wix](https://www.wix.com/) but puts more emphasis on

23+

24−1. Enabling creation of custom components as easy as using pre-fabricated ones - Wix has an option to create custom components with javascript but it's limited and impractical.

24+Being a SPA, in-app links and navigation is intercepted: DOM patching and history api is used instead. In-app navigation is handled by a router in which URL paths are mapped to UI states, either strucutred as separate pages but could also be more granular (i.e. some UI state might only change part of current document not the whole document).

25−2. Implementing collaborative composing as an integral feature rather than an "add-on".

25+

26−

26+The view model should be defined using sail components. Sail components abstract view model into splitted subviews, which store their own internal state and controller. Component's controller is conceptually similar to agent's controller (on-poke arm), it receives [mark vase] and produces list of card:agent:gall and the component with possible internal state modification. `+on-init` in called when component is going to be mounted to DOM. At this arm, a card needs to be sent that declares which browser events this component expects to receive.

27−The interface would be composed together from components in similar way Wix does. The components are draggable around the screen and it will be possible to align a component into a grid with automatic alignment. In practice this enables composing (live) "dashboards" for reasoning about various data.

27+

28−The interface will be accessed from browser and mobile browser. Future work includes a native iOS app and a desktop Electron app. Though it's the same codebase for web browser interface, the mobile browser interface components will be auto-aligned for mobile screen. iOS app will have support for native notifications and widgets.

28+```

29−The components will be written in Sail, an Urbit markup language. A trivial example of a component could be `;smiley` which renders on the screen as `:-)`.

29+++ sail-component

30−The `;smiley` definition might look something like `;span: ":-)"`. It must be in valid HTML namespace, but can be written in Sail syntax or alternatively, defined in pure HTML itself.

30+ $_ ^|

31−If you try to add this `;smiley` component to your screen but it doesn't exist on your urbit yet, a prompt appears telling to either define this component or download component with this name from other urbit. By default, downloads happen from your parent star but can be configured to download from other indexers as well.

31+ |_ [props children bowl:sail]

32−Alternatively, if you know that this `;smiley` component exists on some particular urbit, you can also download directly by just appending the name of urbit, e.g. if ~nortex-ramnyd has this component, you could `;smiley~nortex-ramnyd` and after that, this component is available on your ship as well (so next time you want to use this component, you can just `;smiley` without asking it from ~nortex-ramnyd).

32+ ++ on-poke |~([mark vase] *(quip card:agent:gall _^|(..on-poke)))

33−For this project, I will implement an additional CSS abstraction layer into Sail. This makes styling components a little bit easier. So instead of `;smiley(style "color:blue")`, it would be `;smiley(color "blue")`. Or to make custom fonts easier `;p(font "custom-font"): Hello` or `;p(font "https://url-of/custom-font.woff2"): Hello`. To bypass CORS restrictions, I'll host a CORS relay (or can be configured to use a different host).

33+ ++ on-init *(quip card:agent:gall _^|(..on-poke))

34−"Pages" of composed components are linked together like web pages and can be either pages composed by only you (only available on your urbit), e.g. your "home screen"/"dashboard", or group pages - pages that are composed together by group members.

34+ ++ manx *^manx

35−Both types can have specified view and edit permissions.

35+ --

36−The first time when the interface is installed (an Electron app), the "welcome" screen appears and this is also the "home screen" that appears when later reopening the application. The welcome screen walks through the functionality of the interface and subsequently prepares the user to start composing their home screen.

36+```

37−Some code I have already written, the repository is stored on github: https://github.com/h5gq3/wix.com

37+

38−# Milestones and Compenstation

38+Component's on-poke arm receives from browser user interaction events (DOM events) and handles these accordingly, by emitting cards and/or modifying state.

39−## Milestone 1: finish core features and polish UI

39+

40−### 2 stars

40+In case agent's state or component's internal state gets modified at on-poke call, a view patch is sent to browser. The view patch is an html string representing the component(s) whose state (and thus their sail template at `+manx` which interpolates state) got modified.

41−The first milestone is to get the current functionality polished and usable with minimal bugs. It should be clear to the user how to edit and add blocks as well as how to switch back to rendering. The user should be able to install the freeform editor as an app and see the basic demo where state is only seen through the app itself.

41+

42−- Implement basic fixed freeform positioning

42+The patch is then applied in the application's javascript context with diffHTML.

43−- Implement component resizing logic

43+

44−- Implement page routing

44+The view model declares component tree in sail syntax:

45−- Add some UI for showing editing vs rendered state

45+

46−- Add UI helpers for rendering editor

46+```

47−- Add docket file and editor html + js so that it can be rendered as an app for ease of showing off

47+:: component1, component2 are imported from some path ::

48−## Milestone 2: usability and component enhancements

48+:: foo, boo are passed in from agent

49−### 1 star

49+;div#root

50−In this milestone we're mostly just improving the usability of the editor and adding nice-to-have features like being able to make and use components.

50+ ;component1(prop1 (p foo));

51−- Implement component creation logic using React 18

51+ ;component2

52−- Download components from other ships

52+ =prop1 (p foo)

53−- Install and use React components straight from markup

53+ =prop2 (p boo)

54−- CSS abstraction

54+ ==

55−- Some "convenience" functions library in style of jQuery

55+==

56−## Milestone 3: collaborative editing

56+```

57−### 1 star

57+

58−In this milestone we implement push and pull hooks similar to how groups works to allow for syncing of state between multiple editors and implement custom permissioning logic.

58+gate `+p` produces jammed atom that is encoded to tape since manx properites must be tapes. decoding is handled by the library and components receive nouns that they have to normalize to their own needed structures (using `;;(mold noun)`)

59−## Milestone 4: proof of concept custom component/app - DeepSpace meditation app

59+

60−### 1 star

60+---

61−In this milestone we create an application on top of the interface builder. The design considerations for this application are as follows:

61+

62−### Design - The DeepSpaceApp

62+**milestones**

63−- three slightly different 2-3 min guided basic meditation where the user sees written text + hears audio with some simple animation like a dot that is going bigger when you breathe in and smaller when you breathe out

63+

64− - one where the user focuses on breathing

64+_sail component abstraction layer and framework base logic_

65− - one where the user focuses on counting

65+

66− - one where the user focuses on “feeling”

66+2 stars

67−- built-in timer to set up a time of how long users that already knows techniques of meditation want to meditate with a bell sound at the start and end of the session

67+

68−- a small journal that the user can write a few words after each meditation to store the ideas, and feelings that emerge during the session, it is also good practice to write short journals for a benefit of daily focus and mental health, by storing it all on Urbit user will have a feeling that he really own it personally and no one have access to it

68+the base of the framework is written in scope of this milestone. this is the base functionality of writing sail components and attaching the resulting UI logic to agent.

69−- quote of some zen master, budda, Krishna, or from Hermetic books to inspire users after each meditation, all taken from some pre-created database

69+

70−- way to evaluate each user’s meditation session, emotional/mental state of each day with "triangle" "circle" "square" (not “:)” , “:|” , “:(“ -> like in every other meditation app)

70+_routing and navigation layer_

71−- **MOST IMPORTANT**: Group sessions so like there will be pre-define and pre-announced three hours daily in UTC when users will know that if they want to meditate with other people they can join and see how many people meditate with them at the same time (they don't need to hear each other or anything, just a visible number of people, maybe Urbit names, some levitations dots representing users, that now are currently login and potentially meditate at the same time). This builds a strong connection between people and lets them feel “not alone” in the process or even in the whole world/space/time.

71+

72−# Future Work

72+1 star

73−Future work involves expanding the functionality and writing custom components, aka "apps".

73+

74−Potential expansions:

74+- implementing url mapping to view states.

75−- Dragging various media onto the page and automatically storing it in your data store (possibly IPFS or S3)

75+

76−- Sail and udon improvement - try improving syntax for more ergonomic use

76+- implementing history api.

77−- "Convenience" functions library expansion

77+

78−- Codemirror integrations like indentation, syntax highlighting, and json previewing

78+_hot reloading_

79−- Component discovery from other ships

79+

80+1 star

81+

82+implementing transition logic when components source code changes

83+

84+_documentation and example agent_

85+

86+1 star

87+

88+documentation about using this framework and example usage in form of a todo app

content/grants/2022/urbitswap.md+2−1

@@ -13,8 +13,9 @@ reward = "1 star"

13assignee = ["~togtyr-roplux"]

14champion = ["~dinleb-rambep"]

15grant_id = "B0155"

16−completed = false

16+completed = true

17work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0186&prefill_Grant+Name=Uniswap"

18+deliverable = "~maptyl-lapsyl/uniswap"

18+++

19+++

19

20

20# Overview

21# Overview

content/grants/2022/volt-ui.md+2

@@ -15,6 +15,8 @@ assignee = ["~mipsun-diflex"]

15grant_id = "A0152"

16completed = false

17cancelled = false

18+link = "~pindet-timmut/urbitcoiners"

19+deliverable = "~mister-dister-dozzod-dozzod/bitcoin"

18work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0152&prefill_Grant+Name=Lightning%20Wallet%20User%20Interface"

20work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0152&prefill_Grant+Name=Lightning%20Wallet%20User%20Interface"

19+++

21+++

20

22

content/grants/2022/whom.md+3−5

@@ -14,7 +14,7 @@ reward = "3 stars"

14assignee = ["~rivmud-fabwen"]

15champion = ["~palfun-foslup"]

16grant_id = "P0171"

17−completed = false

17+completed = true

18canceled = false

19link = ""

20

@@ -42,9 +42,8 @@ If a contact is another Urbit user with `%whom` installed, the contact will also

426. As a user, when one of my non-Urbit contacts gets a planet, I want to be able to convert them to an Urbit contact.

437. As a user with `%pals`, I want my pals to be added to my contacts list automatically.

448. As a user with `%pals`, I want to be able to add my contact as a %pal with a button click.

45−9. As a user with `%pals`, I can filter my contacts by tags.

46−10. As a user with `%pals`, I want some info on my profile to be public, but I only want to share more personal info with users I trust (pals).

45+9. As a user with `%pals`, I want some info on my profile to be public, but I only want to share more personal info with users I trust (pals).

47−11. As a developer of another app, I want to be able to programmatically access specific fields from contacts.

46+10. As a developer of another app, I want to be able to programmatically access specific fields from contacts.

48# My background

47# My background

49I'm a professional fullstack software engineer and I've been active on Urbit since 2019. I operate the star ~holnes and have onboarded a few of my friends. I graduated Hoon School in 2020, attended Assembly and a few local meetups, and completed the Studio email apprenticeship with Tirrel earlier this year. I've had a great experience working with Hoon and Gall so far, and am eager to build more apps.

48I'm a professional fullstack software engineer and I've been active on Urbit since 2019. I operate the star ~holnes and have onboarded a few of my friends. I graduated Hoon School in 2020, attended Assembly and a few local meetups, and completed the Studio email apprenticeship with Tirrel earlier this year. I've had a great experience working with Hoon and Gall so far, and am eager to build more apps.

50# Milestones / Estimates / Compensation

49# Milestones / Estimates / Compensation

@@ -67,6 +66,5 @@ Completed by: Sep. 1

67- Goals:

66- Goals:

68 - Pals are automatically added as contacts

67 - Pals are automatically added as contacts

69 - The frontend shows which contacts are pals

68 - The frontend shows which contacts are pals

70− - Contacts can be filtered by %pals tags

71 - Users can click a button to send a contact a pal request

69 - Users can click a button to send a contact a pal request

72 - Users can restrict visibility on their profile, so only pals can see certain fields

70 - Users can restrict visibility on their profile, so only pals can see certain fields

content/grants/2023/aera.mdnew file+50

@@ -0,0 +1,50 @@

1++++

2+

3+title = "Aera"

4+date = "2023-06-08"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "A decentralized, subjective reputation graph protocol."

13+reward = "8 Stars + Bonus"

14+assignee = ["~talwet"]

15+champion = ["~dalten"]

16+grant_id = "P0276"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# A new Aera of reputation

23+

24+Aera is an essential missing piece of Urbit infrastructure which will bring self-sovereign trust to the platform. This will enable application developers to manage, filter, curate, and otherwise manage context dependent trust parameters within their products. Additionally, the fully formed version of Aera will include an interface for users to view and understand the shape of their trust graph. Aera makes it possible to build applications that can’t be built using the current web stack. For a more detailed view of the Aera value prop and future product updates, please visit https://quartus.co/aera

25+

26+# Team

27+Aera is a project consisting of many Urbit community members. It is the brainchild of ~rabsef-bicrym, but will also include the following key contributors:

28+- ~litlep-nibbyt, working on hoon agents

29+- ~normul-postem, writing frontend interfaces

30+- ~litneb-maltyp, designing graphical user interface & visual content

31+

32+Additionally, the project has a variety of other advisors and participants, including ~sarlev-sarsen, ~sicdev-pilnup, ~sogrum-savluc, and ~datnut-pollen. For anyone interested in participating, download the %aera desk to learn more: /1/desk/~dister-dozzod-dalten/aera

33+

34+# Milestones & Compensation

35+This proposal is going to be partially funded by the Urbit Foundation, both by a $10,000 direct commitment, as well as a grant of 8 stars to be released along the below milestones. Additionally, Aera will also grow to include a crowdfunding campaign using %fund to support ongoing development efforts from the Urbit community. Contributors will recieve early reputation scores within the resulting reputatation graph, as well as early access to developer resources and integration support. Funds will be held in escrow by the ~dalten collective, to be paid out to contributors upon milestone completion as determined by the members of the collective.

36+

37+## Milestone 1: Initial Research and Mathematical Modelling - $10,000

38+Quartus will conduct initial research efforts to understand implementation hurdles and ideal mathematical models for the shape of the aera agents and ‘trust-reduction algorithm’. This work will be released on an ongoing basis to the Aera group, hosted by ~dalten. Bi-weekly meetings will also be held and made accessible to campaign funders.

39+

40+## Milestone 2: Agent and Library Concept Creation - 2 stars

41+Quartus will begin development of the %aera agents and library and will release them to donors for feedback. Participants will receive a chance to provide feedback on agent architecture and use case requirements.

42+

43+## Milestone 3: Release Candidate Available to Developers for Feedback - 2 stars

44+Whitelisting of select developers, including all donors, for downloading of the %aera desk, including fully functioning agents and a working library. Participants will receive a chance to provide feedback on specific implementation details.

45+

46+## Milestone 4: Final Library and General Availability to Urbit Network - 2 stars

47+Developer feedback integrated into Milestone 3 release candidate and final library released to developers along with documentation. Quartus will work with donors through onboarding sessions that will guide developers through the integration of Aera with an urbit application. Additionally, the application will be made available to the network such that end users will be able to experience the product functionality via an example integration in %fund.

48+

49+## Milestone 5: Full Release to the network with End User GUI - 2 stars

50+Quartus will develop a frontend experience for users to explore their own view of the Aera graph. This GUI will include views of the users own ship, as well as their understanding of the nodes to which they are connected.

content/grants/2023/app-metrics.mdnew file+74

@@ -0,0 +1,74 @@

1++++

2+

3+title = "Success Metrics for Urbit Apps"

4+date = "2023-02-09"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Success Metrics for Urbit Apps"

13+reward = "5 Stars"

14+assignee = ["~bacwyl-samweg"]

15+champion = [""]

16+grant_id = "P0235"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Description

23+

24+The current absence of success metrics for Urbit apps makes it challenging for developers to determine the reach and impact of their software. Without a central app store, it is difficult to obtain information on the number of downloads or daily active users for a given application. This proposal aims to address this problem by providing developers with low-level access to the number of downloads and higher-level tools to facilitate the privacy-compliant collection of daily active user metrics. This will provide valuable insights for developers and support informed decision making for urbit app development.

25+

26+# Milestones and Compensation

27+

28+## Milestone 1 - Surface App Downloads Data

29+

30+Create access to the total set of users who are synced to a local desk. This currently represents the total userbase of an app, since almost all apps on urbit are distributed from a single source. It could also be useful for other purposes, such as the ability to anticipate congestion when shipping an OTA.

31+

32+There is already [an open PR](https://github.com/urbit/urbit/pull/6136) for this milestone.

33+

34+Reward: 1 Star

35+

36+## Milestone 2 - Collect App Downloads/Time

37+

38+Create an agent that periodically records the data from milestone 1 for locally published apps. This represents growth data, or how many ships-per-day are downloading an app. It’s helpful to visualize this as a multiple line graph. For example, a developer can see the point in time when App A surpasses App B in downloads.

39+

40+The state of the agent would be something like `(map app-desk=term [users=(set ship) growth-data=(map time number-of-users=@ud)])`

41+

42+The agent should expose a local scry endpoint for this data that is available as CSV so that developers can easily export and analyze.

43+

44+Reward: 1 Star

45+

46+## Milestone 3

47+

48+### Package and Distribute

49+

50+When milestone 2 is completed, it can immediately be published as an urbit app that developers can |install to their distributor ships. Further milestones can be incremental improvements to this app. The app must be stable for initial release and available for at least the following few months. The codebase will be open sourced with sufficient documentation for developers to install manually. The app will be fully workable from the dojo, and will not depend on a javascript frontend.

51+

52+### Collect Daily Active Users

53+

54+This milestone can be considered complete when app developers can optionally collect ‘daily active users’ without having to intrude on privacy, and without having to reimplement code specifically for this purpose. For this milestone to be complete, some solution to this problem has to be made available to app developers. This code will also need to be open sourced and sufficiently documented. The exact nature of this solution has not yet been determined, but it will most likely conform to the following architecture.

55+

56+### Architecture

57+

58+A central, developer-hosted poke endpoint where logs can be sent from user agents.

59+

60+1. Bob installs :app-metrics on ~dister

61+

62+2. He can use this agent to access milestone 1, 2 data for his apps

63+

64+3. He can optionally add a wrapper agent to his apps to send some logs to ~dister:app-metrics

65+

66+ a. This requires some self-poke to be added to the inner-agent which will be ignored by the inner-agent but caught by the wrapper agent. The wrapper will then send a poke to the central :app-metrics agent, indicating user activity. This poke should be added in a place that indicates real user interaction, such as opening a frontend subscription or sending a DM.

67+

68+ b. To avoid creating too much network activity, the wrapper agent will send a maximum of one poke per day, just to indicate that the user used the agent that day.

69+

70+4. Users can opt-out by setting a boolean in the wrapper agent.

71+

72+5. Daily-active-users data can now be scry’d as a csv file from the central agent.

73+

74+Reward: 3 Stars

content/grants/2023/blog-updates.mdnew file+64

@@ -0,0 +1,64 @@

1++++

2+title = "%blog Quality of Life Improvements"

3+date = "2023-03-17"

4+

5+[taxonomies]

6+grant_type = [ "Apprenticeship" ]

7+grant_category = [ "App Dev" ]

8+

9+[extra]

10+image = ""

11+description = "%blog Quality of Life Improvements"

12+reward = "1 star"

13+mentor = ["~dachus-tiprel"]

14+assignee = ["~foddur-hodler"]

15+completed = false

16+canceled = false

17+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=A0250&prefill_Grant+Name=%25blog%20Quality%20of%20Life%20Improvements"

18++++

19+

20+## Blog QOL Upgrades

21+

22+%blog Apprenticeship is a userspace application apprenticeship focused on experiential learning in publishing on Urbit. The three main quality of life upgrades `~dachus-tiprel` would like are:

23+- Subscribe to someone’s ship to see when they have published a new post

24+- Password protected posts

25+- Export-Files / Import-from-Backup pokes

26+

27+

28+## Apprentice Expectations

29+

30+Apprentice is familiar with %blog, has gone through hoon school, has a worked with a gall app before (both frontend and backend).

31+

32+

33+## Team

34+

35+The apprentice will work with `~dachus-tiprel` directly. They will participate in an initial "kick-off" call to talk through the user stories and the expected implementation, and will proceed with weekly or biweekly (at the apprentice's preference or need) meetings with `~dachus-tiprel` thereafter.

36+

37+

38+## Deliverable

39+

40+3 separate production-ready pull requests to the %blog hoon repo and %blog-ui repo each of the requested features.

41+

42+

43+## User Stories

44+

45+As someone integrating with %blog I want to

46+- Subscribe to a %blogger and be notified whenever they publish a new post

47+As a %blogger I want to

48+- Password protect my posts to limit access

49+As a %blogger about to breach I want to

50+- Export all my my blogs into a file

51+- Breach my ship

52+- Reload all of my blogs/themes/drafts exactly as they were

53+

54+

55+## Implementation Notes

56+

57+`~dachus-tiprel` is amenable to suggestions of strategies from his apprentice as to the nature of the implementation of this feature, particularly in the Front-End presentation. We have a suggestion for the general implementation details on the backend, but are nonetheless open to input:

58+- Subscriptions should be done using the new sss.hoon library

59+- Password protection will likely be done using some sort of sail page that redirects to the post upon a correct POST to %blog

60+

61+

62+## Schedule and Compensation

63+

64+The %blog apprenticeship should take no longer than 3 months, but is likely executable within a month. The apprentice will recieve 1 star upon successful completion of the apprenticeship.

content/grants/2023/bridge-grab-bag.mdnew file+35

@@ -0,0 +1,35 @@

1++++

2+

3+title = "Bridge Issue Grab Bag"

4+date = "2023-04-17"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "Close three issues from the Bridge github repo."

13+reward = "2 stars"

14+assignee = ["~sicrep-docrem"]

15+champion = ["~poldec-tonteg"]

16+grant_id = "B0260"

17+completed = false

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0260&prefill_Grant+Name=Bridge%20Issue%20Grab%20Bag"

20+

21++++

22+

23+## Overview

24+

25+The Urbit Foundation monitors existing and new issues in the Bridge codebase to identify issues that can be addressed by community contributors. Issues are selected to require minimal organizational context so that contributors can jump right in.

26+

27+This bounty will be awarded to someone who closes any three of the issues labeled community contribution in the [Bridge](https://github.com/urbit/bridge/issues?q=is%3Aissue+is%3Aopen+label%3A%22community+contribution%22) github repo.

28+

29+The ideal contributor will have a command of JavaScript (specifically React) as well as experience with Web3/ETH front end development. The latter includes setting up a local ETH testnet and deploying test contracts. Familiarity with the Urbit stack, specfically the [Azimuth PKI](https://github.com/urbit/azimuth) and the [L2 roller system](https://developers.urbit.org/reference/azimuth/l2/layer2) will also come in handy.

30+

31+For clarification on any of the issues, please mention [@vvisigoth](https://github.com/vvisigoth) or the issue filer in the issue comments.

32+

33+## Compensation

34+

35+2 Stars

content/grants/2023/community-meetups.mdnew file+37

@@ -0,0 +1,37 @@

1++++

2+title = "Community Meetup"

3+date = "2023-04-06"

4+

5+[taxonomies]

6+grant_type = [ "Bounty" ]

7+grant_category = [ "Community" ]

8+

9+[extra]

10+image = ""

11+description = "Earn stars by building a local urbit community"

12+reward = "1 star"

13+assignee = [""]

14+grant_id = "B0165"

15+champion = ["~dalweb-donfun"]

16+completed = false

17+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0165&prefill_Grant+Name=Meetup%20Bounty"

18++++

19+

20+# Requirements

21+- Meetups should be geographically based.

22+- You must host a total of six meetups, with a targeted cadence of once a month.

23+- Meetups must be publicized and include a web presence like meetup.com, and should be actively promoted via social media, in-person recruitment, flyers, a website, etc. If you need a signal boost, email thomas@urbit.org.

24+- Create and admin an Urbit group for your community to which all meetup attendees will be invited. This group should be actively maintained with info about upcoming events, copies of past presentation materials, and any other related meetup content.

25+- Share all the materials you generate in service of your meetups like, presentations, flyers, FAQs or anything else in ~siddef/uf-meetups.

26+- Every meetup must be publicized on the [Events](https://urbit.org/events) section on urbit.org via a commit to the urbit.org [github repo](https://github.com/urbit/urbit.org).

27+- Your community should have a home on the [community section](https://urbit.org/ecosystem?type=communities) of our ecosystem page. You can add this to the website with a commit to the urbit.org [github repo](https://github.com/urbit/urbit.org). If you have never submitted a pull request on github before, let us know and we will teach you how.

28+- Write a short paragraph about every meetup including: pictures of the meetup, 50-200 words description of every meetup and the attendee statistics of the meetup. At the end of your grant you can send this as one report to thomas@urbit.org for completion of your grant.

29+# Encouraged Features

30+- Semi-regular presentations that introduce Urbit to newcomers, help members boot a planet, or introduce the more technical side of urbit are strongly suggested.

31+- Having a collection of recommended groups & apps to which you can direct meetup attendees, such that they can begin to explore the Urbit network.

32+- As one of the main goals of meetups is to get people building on Urbit, once your meetup gains some traction, consider looking into writing a proposal for a grant on which members of your meetup can collaborate.

33+- While the specific requirements of the meetup bounty can be summarized as "run a regular meetup", the overarching goal is to build a local community and onboard people to Urbit. You should become a true champion of your local urbit community who helps people find their own path on urbit, whether it is signing up for a course, a grant or even working for a company in the ecosystem. It's up to you to find the potential of the attendees.

34+# Application process

35+After applying to this bounty, set-up a call with ~dalweb-donfun who will assess the soundness of your strategy and run you through the requirements of this bounty. If everything checks-out you are good to go.

36+# Compensation

37+- Upon the completion of six meetup events and the associated meetup report, one star will be paid out to the organizer.

content/grants/2023/did-rfp.mdnew file+26

@@ -0,0 +1,26 @@

1++++

2+

3+title = "Build a DID Resolver for Urbit"

4+date = "2023-04-12"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Design and implement a DID resolver to let Urbit interoperate with protocols like AT/BlueSky"

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1001"

17+completed = false

18+canceled = false

19+

20++++

21+

22+The launch of [BlueSky](https://blueskyweb.xyz/) and the [AT protocol](https://atproto.com/guides/identity) has brought renewed attention to a W3C standard called [DIDs](https://www.w3.org/TR/did-core/#introduction) or Decentralized Identifiers

23+

24+Decentralized identifiers (DIDs) are a type of identifier that enables verifiable, decentralized digital identity. A DID refers to any subject as determined by the controller of the DID. In contrast to typical, federated identifiers, DIDs have been designed so that they may be decoupled from centralized registries, identity providers, and certificate authorities. Urbit ID is a good fit with this standard, since the Urbit namespace already conforms with many aspects of the specification.

25+

26+Included in the standard is a specification for a [resolver](https://www.w3.org/TR/did-core/#dfn-did-resolvers), a function that maps a READ from an identifier to its accompanying document. Build an application layer in Urbit that uses a ship to resolve a DID to a document either on the Urbit network or outside it.

content/grants/2023/elm.mdnew file+68

@@ -0,0 +1,68 @@

1++++

2+

3+title = "Elm"

4+date = "2023-06-08"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "Making Elm the frontend technology for Urbit"

13+reward = "5 Stars + Bonus"

14+assignee = ["~racfer-hattes"]

15+champion = ["~rovnys-ricfer"]

16+grant_id = "P0275"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Description

23+

24+I think Elm is a great language for developing frontends. The Elm architecture is conceptually very similar to how %gall agents are structured.

25+

26+Goals:

27+

28+1. Remove the need to convert to and from JSON to interact with Urbit from Elm

29+2. Make interacting with Urbit from Elm as painless as possible

30+

31+To eliminate the need to convert through JSON Elm needs to support serializing and deserializing jammed nouns.

32+

33+For potential portability reasons Elm libraries are not allowed to have JS FFI. This means that we need to implement as much as possible in pure Elm.

34+

35+# Milestones and Compensation

36+

37+## Milestone 1: Jam and Nouns

38+

39+Reward: 2 Stars

40+

41+Deliverables:

42+ - An Elm library that implements `++jam` and `++cue` in Elm.

43+ - An Elm library for manipulating Nock Nouns and converting Elm data structures and type to and from Nock Nouns.

44+

45+## Milestone 2: Noun Channels

46+

47+Reward: 1 Star

48+

49+Deliverables: An Elm airlock library that supports subscriptions and pokes encoded as jammed Nouns. The library should be designed to be as ergonomic as possible.

50+

51+## Milestone 3: Documentation and Project Template

52+

53+Reward: 1 Star

54+

55+Deliverables:

56+ - Good documentation for resulting the package + a set of tutorials that cover some tricky bits.

57+ - A git repo with all of the boilerplate required to communicate with Urbit. This repo is intended to be used by ASL students to bootstrap their project frontend.

58+

59+## Milestone 4: SSS

60+

61+Reward: 1 star

62+

63+Deliverables: An Elm airlock library that supports Solid-state subscriptions.

64+

65+## Bonus

66+

67+Upon successful completion of project, the contributor will also receive a 6K USDC bonus funded by Vaporware

68+

content/grants/2023/email-stella-fixa-rfp.mdnew file+29

@@ -0,0 +1,29 @@

1++++

2+title = "Build an Email Toolchain for Urbit"

3+date = "2023-05-11"

4+

5+[taxonomies]

6+grant_type = ["RFP"]

7+grant_category = ["App Dev"]

8+

9+[extra]

10+image = ""

11+description = "Produce an Urbit-side client for sending E2EE email"

12+reward = "TBD"

13+assignee = [""]

14+champion = [""]

15+grant_id = "P1001"

16+completed = false

17+canceled = false

18++++

19+

20+Email is the glue for much of the legacy web. While many of us share an aversion to the proliferation of email, the ability to tie email to Urbit identity will enable users to unify their control over their digital life more than is currently possible.

21+

22+There are a lot of ways such a project could shake out.

23+

24+- The gold standard would basically be run-your-own-ProtonMail from Urbit.

25+- One could also build a CLI email agent, like [Mutt](http://www.mutt.org/). This would be a good start.

26+- Implementing [JMAP](https://en.wikipedia.org/wiki/JSON_Meta_Application_Protocol) should be feasible as well, and simpler than IMAP/SMTP.

27+- The minimum viable product would be a front-end on Mars for a connected email server process on Earth, including a full user story on how to operate this without too much tetchy sysadmin work required.

28+

29+Anything in between would also be acceptable. There are some interesting crossovers possible as well, such as sending email to `@p` or via the `user@sampel-palnet.arvo.network`.

content/grants/2023/eyre-noun-channels.mdnew file+42

@@ -0,0 +1,42 @@

1++++

2+title = "Finishing Touches to Eyre Noun-Based Channels"

3+date = "2023-01-26"

4+

5+[taxonomies]

6+grant_type = ["Proposal"]

7+grant_category = ["Core Dev"]

8+

9+[extra]

10+image = ""

11+description = "Finishing Touches to Eyre Noun-Based Channels"

12+reward = "2 stars"

13+assignee = ["~polwex"]

14+grant_id = "P0229"

15+champion = ["~palfun-folsup"]

16+completed = true

17+canceled = false

18++++

19+

20+## Description

21+

22+Any Urbit developer who has coded a complex frontend will tell you that, by far, the most tedious part of making Urbit apps is JSON.

23+

24+Communication between Hoon backends and JavaScript frontends on Urbit is done currently only using JSON data, which has to be manually encoded and decoded at the backend using Hoon's JSON codec functions. Eyre communicating solely through JSON also causes performance costs which can be serious when the JSON data gets large.

25+

26+Thankfully there's a solution to this problem, and it's already more than half done. ~palfun-folsup pushed this draft PR a few months ago https://github.com/urbit/urbit/pull/5877.

27+

28+It just needs some polish. This grant proposal offers to procure it.

29+

30+As set up in the Github PR, in this grant we will:

31+

32+1. Remove the `jsbn` library dependency, and move all related logic in the `nockjs` files to JavaScript's new native BigInt type, or the `big-integer` library (which is mostly the same in practice).

33+

34+2. Add TypeScript typing to all the nockjs logic, wherever possible.

35+

36+3. Other fixes we find along the way to make sure the PR is mergeable and ready for use in Urbit apps.

37+

38+## Milestones & Compensation

39+

40+Expected completion: March 2023

41+

42+Reward: 2 stars

content/grants/2023/generator-doccords.mdnew file+46

@@ -0,0 +1,46 @@

1++++

2+title = "Doccord Compliant Comments in all Generators"

3+date = "2023-01-31"

4+

5+[taxonomies]

6+grant_type = ["Bounty"]

7+grant_category = ["Core Dev"]

8+

9+[extra]

10+image = ""

11+assignee = ["~napnyl-nortuc"]

12+description = "Adapt the comments in the default generators to take advantage of the new doccord features."

13+reward = "1 star"

14+grant_id = "B0231"

15+completed = false

16+canceled = false

17+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0231&prefill_Grant+Name=Doccord%20Compliant%20Comments%20for%20All%20Generators"

18++++

19+

20+## Overview

21+

22+The base desk comes with a variety of generators and threads that are useful for debugging and development. Documentation and usage guidance for these is scattered between inline comments (accessible via the `+help` generator) and [operators.urbit.org](https://operators.urbit.org/manual/os/dojo-tools) We propose to take advantage of the [newly released doccords](https://groups.google.com/a/urbit.org/g/dev/c/iqT0wgbFkPA) feature to consolidate the documentation and provide an introduction to the doccords utility for users.

23+

24+## Implementation

25+

26+For every "dojo tool" covered in [the docs](https://github.com/urbit/operators.urbit.org/blob/master/content/manual/os/dojo-tools.md), move the documentation into the source code in accordance with the doccord [style guide](https://github.com/urbit/urbit/blob/develop/pkg/arvo/lib/deco.hoon).

27+

28+Rewrite the `+help` generator to display the relevant doccords.

29+

30+Currently you need to do the following to see inline doccords.

31+

32+```

33+=file -build-file %/path/to/file/hoon

34+# file

35+```

36+

37+This should be improved to be:

38+

39+```

40++help %example-generator

41+> formatted comments

42+```

43+

44+## Payment

45+

46+1 Star

content/grants/2023/gh-concierge.mdnew file+42

@@ -0,0 +1,42 @@

1++++

2+

3+title = "Github Support Concierge"

4+date = "2023-02-03"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "The Github concierge will triage Urbit support issues that come in through Github."

13+reward = "2 Stars"

14+assignee = ["~larryx-woldyr"]

15+champion = ["~poldec-tonteg"]

16+grant_id = "B0233"

17+completed = false

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0233&prefill_Grant+Name=Github%20Support%20Concierge"

20+

21++++

22+

23+## Overview

24+

25+The Github concierge will triage Urbit support issues that come in through github. Some of these issues are routine and can be handled in the thread, whereas occasionally complex issues arise that need to be escalated to the right people. Ideal candidates will also help synthesize support data to inform product feature work and documentation.

26+

27+## Responsibilities

28+

29+- Triage support issues in github

30+- Write a weekly digest of issues addressed

31+- Attend a recurring meeting with Foundation staff

32+

33+## Qualifications

34+

35+- Helpfulness

36+- Familiarity with running urbit in a variety of environments (cloud server, laptop)

37+- Ability/interest in synthesizing support data and recommending new features or documentation

38+- Dilligence

39+

40+## Compensation

41+

42+2 Stars for 3 months of work, at which time the agreement can be renewed.

content/grants/2023/git-on-clay.mdnew file+42

@@ -0,0 +1,42 @@

1++++

2+

3+title = "Implement a Git server on Urbit"

4+date = "2023-06-01"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Implement a Git server capable of hosting desks as repos"

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1001"

17+completed = false

18+canceled = false

19+

20++++

21+

22+A Git server backend would open up the use of Urbit ships to interface with remote developers and resources.

23+An Urbit implementation of Git would not have to implement all of the features that a Git server typically

24+expects, merely the ability to interface through clone, fetch, and merge operations and through the https and git

25+protocols. (Obviously sufficient internal representations of Git objects, diffs, and so forth are necessary as well.)

26+

27+Having an Urbit-native Git server-side representation has the potential to revolutionize the Urbit developer

28+experience. Not only would it become possible to synchronize Clay and host OS files through `git`, but Urbit would

29+also have direct access to the wealth of Git-based resources on the broader web. More than this, **Urbit would

30+immediately become capable of being a fully decentralized Git repository system.**

31+

32+A solution could be built directly in userspace or on top of Clay. If Clay is used, then there would need to be a

33+way for an unvalidated desk (no mark validation) to store data prior to use in Urbit, e.g. fed up to a functioning

34+regular desk or read out (via remote scry or otherwise) to the Git-based world. In this case, Git operations would

35+be done at a Unix command line regularly and Urbit would serve as a central repo or distribution point. (This could

36+ease development through the appropriate use of scripts, CI and testing, and hooks.)

37+

38+A fully userspace solution would be viable, as long as it was able to export a Git-compatible representation via the

39+API, and as long as it spoke `https` and `git` at a minimum.

40+

41+(Note particularly that this is not an implementation of `git` on Urbit, but an implementation of a Git repository

42+server. The `git` CLI would encompass a complementary set of concerns and operations.)

content/grants/2023/goals-2.mdnew file+64

@@ -0,0 +1,64 @@

1++++

2+title = "Goals 2"

3+date = "2023-03-20"

4+

5+[taxonomies]

6+grant_type = ["Proposal"]

7+grant_category = ["App Dev"]

8+

9+[extra]

10+image = ""

11+description = "Goals 2"

12+reward = "5 stars"

13+assignee = ["~niblyx-malnus", "~sidlup-havwen"]

14+grant_id = "P0227"

15+champion = ["~datder-sonnet"]

16+completed = false

17+canceled = false

18++++

19+

20+# Main Objectives

21+

22+## Groups Integration (Reward: 2 Stars)

23+- Full association of a pool with a group.

24+ - The pool is public or private in correspondence with the group.

25+ - The pool has the same set of banned/allowed ships as the group.

26+ - All group admins are automatically admins on the pool.

27+ - Members who leave or are kicked from the group are automatically removed from the pool.

28+ - Members who join the group are automatically added to the pool.

29+- Each pool and goal will have an associated note. A note is a piece of markdown used to flesh out the pool or goal in greater detail.

30+- Each pool and goal will have an associated comment section where pool members can comment on the specific details of the goal.

31+- Both notes and comments will be able to link to existing nodes in Groups which will render appropriately. This includes chats, notes, channels, comments, entire groups, and applications.

32+- Both notes and comments will be able to link to existing pools and goals which will render similarly to Groups nodes.

33+- Significant events trigger notifications to be sent via %hark. These include:

34+ - Being assigned to be chief of a goal.

35+ - Being assigned to be in the spawn set of a goal.

36+ - New goals spawned under goals you own.

37+ - Non-actionable goals with no subgoals being left childless for an extended period of time.

38+ - Other events as they emerge and are deemed appropriate.

39+

40+

41+## Sorting/Filtering and Tags/Fields (Reward: 2 Stars)

42+

43+- Tags

44+ - Each goal within a pool can be tagged.

45+ - Everyone can maintain private tags associated with a goal which only they can view.

46+ - Harvested goals can be sorted by tags.

47+ - Tags can be viewed so that all goals associated with them can be seen and explored.

48+- Sorting/Context-based Ordering

49+ - Goals can be sorted by the date of their deadline or kickoff.

50+ - Goals can be re-ordered in the context of their subgoals with a simple dragging mechanism.

51+

52+

53+## Improved UX (Reward: 1 Star)

54+

55+- Shortcuts and quick actions using ctrl

56+- Improved mobile experience

57+- Working poke relays on the frontend

58+- Ability to re-order subgoals with a drag and drop action

59+- Dark mode

60+

61+

62+# Compensation

63+

64+Reward: 5 stars

content/grants/2023/hoon-linter.mdnew file+30

@@ -0,0 +1,30 @@

1++++

2+

3+title = "Hoon Linter"

4+date = "2023-03-21"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = ""

13+reward = "2 Stars"

14+assignee = ["~watter-parter"]

15+champion = ["~rovnys-ricfer"]

16+grant_id = "P0224"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Description #

23+

24+Most languages have some form of "linter" available that reports potentially-problematic code. Typically, such code will successfully compile, but will fail at runtime or produce otherwise undesirable results. Because the code is technically valid, it cannot be rejected by the compiler (at least, not without changing the language spec, which risks breaking existing programs), but we can still warn the programmer that what they are doing is likely to cause problems.

25+

26+I have started work on a "Hoon linter" that serves this purpose. The linter is integrated with %language-server, and can thus report warnings directly in any editor that supports the Language Server Protocol. The linter can also be invoked as a standalone generator. Currently, the linter only checks for duplicate union tags. I would like to add more checks to the linter, such as detecting when a noun is pinned to the subject but never used. There are also a few warts that I would like to eliminate, with guidance from someone more experienced.

27+

28+# Compensation #

29+

30+Reward: 2 Stars

content/grants/2023/hoon-replit.mdnew file+45

@@ -0,0 +1,45 @@

1++++

2+

3+title = "Hoon Grammar and Language Mode for Replit"

4+date = "2023-02-15"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Hoon CodeMirror grammar and language mode for Replit"

13+reward = "1 stars"

14+assignee = ["~ransud-wannus-malbex-lacnyr"]

15+champion = ["Replit"]

16+grant_id = "B0238"

17+completed = true

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0238&prefill_Grant+Name=Hoon%20CodeMirror%20grammar%20and%20language%20mode%20for%20Replit"

20+

21++++

22+

23+# Hoon CodeMirror grammar and language mode for Replit

24+

25+_Note: This is a mirror of [a bounty](https://replit.com/bounties/@masfrost/hoon-codemirror-gram) on the Replit site. Acceptance by the Replit team qualifies you for a bonus Star, to be claimed from the Urbit Foundation._

26+

27+## Project Description

28+

29+Hoon is a programming language used in the Urbit operating system. You can find the grammar specification for Hoon in the official Hoon documentation. You can use the Hoon mode for Emacs and the Vim package for reference: hoon-mode.el and hoon.vim.

30+

31+Replit uses CodeMirror as the editor and we want to add first-class support for Hoon, including syntax highlighting. We have a language mode template available on Replit (please read the README for guidance).

32+

33+We'll publish it as an open source package and credit you.

34+

35+## Acceptance Criteria

36+

37+- Syntax highlighting should match the modes for Hoon in the Emacs and Vim packages

38+- Folding ranges should be added to improve code folding

39+- Should use lezer instead of custom tokenization

40+

41+## Compensation

42+

43+- $162.00 from Replit

44+- 1 Star

45+

content/grants/2023/issue-grab-bag.mdnew file+36

@@ -0,0 +1,36 @@

1++++

2+

3+title = "Urbit Issue Grab Bag"

4+date = "2023-02-15"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Close three issues from the Urbit github repo."

13+reward = "2 stars"

14+assignee = [""]

15+champion = [""]

16+grant_id = "B0239"

17+completed = false

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0239&prefill_Grant+Name=Urbit%20Issue%20Grab%20Bag"

20+

21++++

22+

23+## Overview

24+

25+

26+The Urbit Foundation monitors existing and new issues in the codebase to identify issues that can be addressed by community contributors.

27+

28+This bounty will be awarded to someone who closes any three of the issues labeled community contribution in the [urbit](https://github.com/urbit/urbit/labels/community%20contribution) or [vere](https://github.com/urbit/vere/labels/community%20contribution) github repo.

29+

30+The ideal contributor will have a decent command of hoon and an understanding of the Urbit stack. Some, but not all, issues will require experience with the [Vere runtime](https://github.com/urbit/vere). Issues are selected to require minimal organizational context, making them amenable to open source contributors.

31+

32+For clarification on any of the issues, please mention [@vvisigoth](https://github.com/vvisigoth) or the issue filer in the issue comments.

33+

34+## Compensation

35+

36+2 Stars

content/grants/2023/json-parser-suite.mdnew file+170

@@ -0,0 +1,170 @@

1++++

2+

3+title = "JSON re/parser building suite"

4+date = "2023-02-23"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "JSON re/parser building suite"

13+reward = "2 Stars"

14+assignee = ["~litlep-nibbyt"]

15+champion = ["~lagrev-nocfep"]

16+grant_id = "P0245"

17+completed = true

18+canceled = false

19+

20++++

21+

22+# Overview

23+

24+A set of three generators which will automate a majority of the work involved in writing parsers to and from JSON. One generator will convert a noun directly to its JSON representation, one generator will produce an example hoon parser given an example input JSON, and one generator that will produce an example hoon parser given a JSON schema.

25+

26+

27+

28+# Motivation

29+

30+JSON is the most widely used format for HTTP payloads. Urbit apps which talk to existing web services must send and receive requests formatted in JSON. Additionally, apps with Javascript frontends use the Urbit HTTP API to facilitate communication between the frontend and Urbit.

31+

32+

33+

34+A set of generators which can automate a majority of the work involved in writing parsers to and from JSON would accelerate the pace of app development.

35+

36+

37+

38+# Implementation

39+

40+For the noun to JSON direction, the conversion would be direct: given any input noun, the generator would produce the corresponding JSON. `~rovnys-ricfer` has completed most of a noun to json encoder. The code can be found [here](https://gist.github.com/belisarius222/d22b39ac0fece6e0680db5d60c6595c6). When complete, it will be able to take a noun and its AST and convert it to a json representation. We have identified missing encodings inside of en-dime for the following auras: `%s, %rq, %rh, %rd, %rs, %ub, %uc, %ux, %uv, %uw`. Part of this bounty will involve implementing the json encoding for the missing auras.

41+

42+

43+

44+For the JSON to noun direction, we will implement two generators, one which accepts an example JSON and another which accepts a JSON schema. Both generators will output a cord containing an example hoon parser for the input JSON. The expectation is that the user will use this parser as a starting point for their own. The generators will produce a structurally correct parser for the target JSON. The user may have to modify the parsing rules inside each entry to get their desired result, but the structure of the parser must be correct.

45+

46+

47+

48+To illustrate how we expect these generators to be used, we provide an example below:

49+

50+

51+

52+Given an example json:

53+

54+```

55+

56+[ ~[ %o

57+

58+ p

59+

60+ { [p='id' q=[%s p='1234']]

61+

62+ [p='name' q=[%s p='James']]

63+

64+ [p='contact_number' q=[%n p='4132549899']]

65+

66+ }

67+

68+ ]

69+

70+]

71+

72+```

73+

74+

75+

76+Or a schema:

77+

78+

79+

80+```

81+

82+{

83+

84+ "$schema":"http://json-schema.org/draft-04/schema#",

85+

86+ "title":"User",

87+

88+ "description":"A user request json",

89+

90+ "type":"object",

91+

92+ "properties":{

93+

94+ "id":{

95+

96+ "description":"The unique identifier for a user",

97+

98+ "type":"integer"

99+

100+ },

101+

102+ "name":{

103+

104+ "description":"Name of the user",

105+

106+ "type":"string"

107+

108+ },

109+

110+ "contact_number":{

111+

112+ "type":"number"

113+

114+ }

115+

116+ },

117+

118+ "required":[

119+

120+ "id",

121+

122+ "name",

123+

124+ "contact_number"

125+

126+ ]

127+

128+}

129+

130+```

131+

132+

133+

134+The generator will produce this piece of hoon code as a cord:

135+

136+

137+

138+```

139+

140+++ req-parser-ot

141+

142+%- ot:dejs-soft:format

143+

144+:~ [%id so:dejs:format]

145+

146+[%name so:dejs:format]

147+

148+[%contact_number no:dejs:format]

149+

150+==

151+

152+```

153+

154+

155+

156+

157+

158+# Deliverable(s)

159+

160+1 Generator which can directly convert from noun to JSON.

161+

162+1 Generator that can produce an example hoon parser given an example input JSON.

163+

164+1 Generator that can produce an example hoon parser given a JSON schema.

165+

166+

167+

168+# Compensation

169+

170+2 Stars upon completion of the grant.

content/grants/2023/kNock-property-testing.mdnew file+71

@@ -0,0 +1,71 @@

1++++

2+

3+title = "kNock and Property Tests"

4+date = "2023-04-11"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Executable Semantics of Nock in the K Framework, universal testing and verification"

13+reward = "7 Stars"

14+assignee = ["Runtime Verification, Inc."]

15+champion = ["~rovnys-ricfer"]

16+grant_id = "P0255"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Property Testing for Hoon

23+

24+Hoon currently supports pure unit tests. The tests have no entropy and no inputs. This is of course useful. But functional languages have a history of using QuickCheck and similar frameworks for even more powerful tests. Property testing allows testing across a large input space. It relies on writing more general tests, where the programmer specifies properties of their program which should always hold, regardless of input. A typical example is, after writing a sort function, that the resulting list has the same length as the input list, that it is in fact sorted, and that sorting it again causes no changes. This should hold for any input list, and a QuickCheck-like framework will feed many, many different types of lists to the test to find ways it could break.

25+

26+Apart from a test runner, QuickCheck-like frameworks also require an intelligent and modular input builder. For simple and common inputs – atoms, lists of atoms, and other simple data structures – the input builder should a) be able to generate inputs without any programmer effort, b) try progressively more interesting inputs, such as [], [0], [0 0], [1 0], [0 0 1] etc: starting small and going higher, and c) be able to shrink inputs from a failure: if the list [0 2 2 4 3] fails to sort correctly due to the algorithm picking the middle element as pivot in odd length list and discarding elements identical to the pivot, the shrinking should be able to try progressively smaller inputs until it finds something like [2 2 2] as an example.

27+

28+## Future uses

29+

30+The combination of kNock (https://github.com/runtimeverification/knock) and a property testing library means it's possible to move directly from testing to formal verification. This concept is even mentioned in the original QuickCheck paper (https://www.cs.tufts.edu/~nr/cs257/archive/john-hughes/quick.pdf) (Section 5.2). Runtime Verification has also developed a similar tool for Ethereum smart contracts, using the combination of an existing property testing library and a formal verification framework.

31+

32+In 2022, Runtime Verification developed KEVM-Foundry. Foundry is a testing framework for Solidity: property tests are written in Solidity, compiled to EVM and executed in a fast implementation of the EVM written in Rust. This setup, with property tests written in the same language as the program being tested, allows us to leverage our K semantics (https://kframework.org/) of that language for proving. Property tests – which take randomized inputs and assert properties of programs using those inputs – can be seen as formal program specifications with symbolic inputs. In the case of KEVM-Foundry, we can run the tests directly in K with symbolic inputs.

33+

34+Anecdotally, this has lead to higher quality code – formally specifying your code tends to have that effect – while also making formal verification a more tractable proportion: the human verifier can write correct specifications faster – working in Solidity is easier than writing K specifications directly and being able to fuzz the specifications means trivial specification errors are caught much faster. The same framework can also be used to quickly create execution traces built with the summarizer: simply assert something impossible and set the prover off trying to prove it, exploring all possible branches.

35+

36+More info and demos: https://www.youtube.com/live/staXNgpBjEI?feature=share&t=10820

37+

38+# Deliverables

39+

40+We build, in Hoon, a property testing library. This could be added to the existing -test thread, by inspecting whether a test is a gate, and if so, generate a random sample for it; or the library could be added as a new thread. Reusing the existing thread and having the types of tests co-exist likely makes for the best user experience, compared to having different types of files for different types of tests. The suggested invocation (assuming it is baked into the -test thread) is:

41+

42+`> -test <path> <entropy> ~`

43+

44+For example:

45+

46+`> -test /=landscape=/tests eny ~`

47+

48+The explicit passing of entropy means a failing test is easy to replay with the exact same command (the printout of results will contain the entropy used). If no entropy is passed, 0 is used as entropy.

49+

50+A property test is nothing more than a regular test which is a gate. Running it means generating a sample to the gate. Optionally, a test can have a generator which is responsible for generating its sample: this is necessary, for example, in order to generate arbitrarily large data structures such as trees. It's also useful in order to generate random values more intelligently than the default generator, which can help exercise edge cases. For example, Mitgaard found a 20 year old bug in the data structure Patricia trees by tweaking QuickCheck inputs to hit on otherwise extremely unlikely edge cases (https://janmidtgaard.dk/papers/Midtgaard%3aTFP17.pdf). There are several possible designs for generating arbitrary data -- using arms in the test with names starting in "gen-", specifying them along with the gate for the tests, etc. Which implementation is both easy to use in the default case and powerful in the hands of a power user is something that will require some interaction and community discussion.

51+

52+## Deliverables for property testing in Hoon

53+

54+Implement basic property testing: the user should be able to write a test arm as a gate using the existing test primitives (such as expect-eq, expect-fail), and the test runner should create random samples and repeatedly slam the gate.

55+Implement custom sample generation: the user should be able to specify a gate which produces custom inputs based on given entropy.

56+Implement sample re-generation, allowing the test to put restricting assumptions on the input. For example, an [@ud @ud] sample testing (sub a b) might require (lte b a), and the user should be able to specify this, rejecting any samples which don’t conform, reporting that inputs were discarded without the test failing.

57+Implement sample shrinking, trying to create the smallest possible failure example.

58+Write documentation for the urbit.org website.

59+Write an example property test suite, showing off the various capabilities of the test framework, for some relevant core functionality from the Hoon standard library.

60+

61+# Timeline and Compensation

62+

63+Timeline: 1-2 Months

64+

65+Reward: 7 Stars

66+

67+# Who we are

68+

69+Runtime Verification, Inc. is a specialist in formal verification, auditing and security products for smart contracts and blockchains. We are the main developers and supporters of the K Framework which we are constantly optimizing and extending.

70+

71+Rikard Hjort (~bithex-topnym) is an auditor and verification engineer at Runtime Verification. He’s an MSc in Computer Science from Chalmers University of Technology, the creator of kNock, a Hoon School finisher, and the host of the Urbit Berlin meetups.

content/grants/2023/lick.mdnew file+82

@@ -0,0 +1,82 @@

1++++

2+

3+title = "%lick"

4+date = "2023-02-23"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "An Earth Communication Vane"

13+reward = "7 Stars"

14+assignee = ["~mopfel-winrux"]

15+champion = ["~lagrev-nocfep, ~rovnys-ricfer"]

16+grant_id = "P0244"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Introduction

23+This is a grant for a new vane called %lick. This will act as a way for `Gall` agents to open and close a communication port to Earth processes; enabling communication with various devices and processes ranging from cryptographic hardware keys and dongles, embedded devices speaking on common communication interfaces (UART, SPI, I2C, etc), and IoT connected devices.

24+

25+How %lick will work is best explained with the following usecase:

26+

27+I have a receipt printer that communicates through UART communication. I want it to print out any %rumors I recieve.

28+

29+This usecase will act as an end to end test of the entire system (described below) and allow incremental experimentation until the final product.

30+

31+This grant is split into 4 parts

32+

33+1. Creation of the vane (%lick and lick.c)

34+2. Gall agent (%receipt)

35+3. Earth process which communicates with lick's port and the receipt printer

36+4. Documentation and Tutorial

37+

38+# Vane

39+The Arvo vane exposes an interface for opening and communicating with a host device through Unix IPC ports. `%lick` extends `%galls` pokes to Earth based processes.

40+

41+An agent will be able to `%spin` up a port (type `path`) and `vere` will create it in the piers `.urb/dev` folder. An agent will also be able to `%shut` this port. When an Earth process connects to the IPC port `vere` will send a `%soak` to the `duct` that opened the port. The soak will have the `mark` `%connect`. When the Earth process disconnects `vere` will send a `%soak` with a `%disconnect` `mark`. Whenever an earth process is connected the `gall` agent will be able to `%spit` a noun with the structure `[=mark =noun]`. The `gall` agent should also be able to receive a `%soak` with a similar noun structure.

42+

43+Data being transfered along the IPC port will be `jam`med nouns.

44+

45+

46+# Gall Agent

47+Once the vane and library is tested work will begin on implementing a gall agent that subscribes to the %rumors app by ~paldev. The app will begin by `%spin`ing a port. When an earth process connects to the port it will subscribe to %rumors and on recieving one it will send the correct command for the printer to output it.

48+

49+# Earth Process

50+

51+The Earth process will connect to a given IPC port and wait for a `%print` mark with a `@ta`. It will use `vere`'s eval function to `cue` the noun from the port and parse the hoon pretty printer to correctly print the message.

52+

53+This will be fine for a receipt printer but future work will have to be done to implement a noun library in a given language.

54+

55+# Documentation and Tutorial

56+Documentation of how the vane works is vital to the succuss of it. The benefit of having a working app alongside the vane is to show users how to use the vane. The resulting gall agent and earth process will be written into a tutorial that should allow anyone to replicate this work.

57+

58+

59+# Milestones

60+

61+## Milestone 1: Vane

62+Payment: 3 Stars

63+

64+This milestone includes a working vane that we can send nouns back and forth too.

65+

66+

67+## Milestone 2: Gall Agent

68+Payment: 2 stars

69+

70+This milestone is complete when a user can install `%receipt` and have it print rumors.

71+

72+## Milestone 3: Earth Process

73+Payment: 1 star

74+

75+This milestone is complete when a user can install the app and have the printer print its rumors

76+

77+

78+## Milestone 4: Documentation and Tutorial

79+Payment: 1 star

80+

81+This milestone is complete with the delivery of a documentation and tutorial package.

82+

content/grants/2023/mapping-ids.mdnew file+106

@@ -0,0 +1,106 @@

1++++

2+

3+title = "Mapping Urbit IDs to Web 2 Domains"

4+date = "2023-06-13"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = ""

13+reward = "5 Stars"

14+assignee = ["Web23"]

15+champion = ["~rovnys-ricfer"]

16+grant_id = "P0262"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Overview

23+

24+Urbit has a striking design that makes Urbit IDs scarce, full of utilities and many more new use cases would evolve around them.

25+

26+Urbit IDs also have an analogy with the Unix file systems where hostname resolves to the loopback address of the localhost. Further, an address will be reachable via network packets as well as be accessible via a local naming system.

27+

28+This structure of hostnames mapped with the IP addresses evolved to DNS at large. Urbit is perfectly aligned to evolve Urbit IDs into a true decentralized DNS structure.

29+

30+Domain names run over Web2 stack & current technological stack is in a transition state. For example, Web3 domains, let’s say john.eth or john.crypto are not recognized by the existing DNS and hence the resolvers & browsers. Typing john.eth in Chrome will not take a user to john.eth even if a dAPP is running over john.eth

31+

32+Additionally, with the Decentralized Identifiers (DIDs) evolving as the perfect way to identify the assets over the chain, it becomes imperative to look-up for DIDs and resolve them for multiple use cases.

33+

34+To fill the technical discontinuity amongst Web2 domainers & Web3 domainers, we propose a hinge between Urbit IDs & Web2 domains and also propose to build the DID resolver.

35+

36+# Why?

37+ - Web2 domains still serve as the starting points for most of the things on the Internet. (Even when Web3 products start their journey, maybe one of the first steps is to register a Web2 domain.)

38+ - People across the world know, understand & value Web2 domains more than any other thing (for example, a dot com)

39+ - There are millions of Web2 domainers who have no idea of Web3 landscape & considering them the long tail it is far more easier to use Web2 domains and nudge them towards Web3

40+

41+# The Proposal

42+

43+1. Chain agnostic Web23 domain centric wallet, first of it’s kind with the capabilities of Ethereum, Solana, Hedera Hashgraph to allow:

44+1

45+ - Existing Web2 domainers (likes of .com, .link) to explore, mint new Urbit IDs (from within the wallet) - pulled via GoDaddy, Tucows etc.

46+ - Existing Web3 domainers (likes of .eth, .sol, .hbar) to explore, mint new Urbit IDs (from within the wallet)

47+2. Decentralized application with the web interface to allow minting of new Urbit IDs via:

48+ - Web2 domains pulled over GoDaddy & Web3 domains pulled via Metamask (for Ethereum) or Phantom (for Solana) or Blade (for Hedera Hashgraph)

49+3. Integrated DID resolver:

50+ - To be accessed within the entire galaxy/ships of Urbit - an application layer in the form of NPM based libraries - could be used by all the calls/requests

51+ - To be accessed within the Web23 wallet as eventually DIDs would be the best fit & initial hook for the wallet - allowing end users to map multiple assets along with their DIDs

52+

53+# Timeline and Compensation

54+

55+This proposal will be completed in multiple phases, beginning with:

56+

57+Web23 wallet in the form of Chrome Extension for the Urbit community with the capabilities to map Web2 domains + Web3 domains of Ethereum, Solana, Hedera Hashgraph, Concordium along with the Urbit IDs:

58+ - Option to buy new Urbit IDs

59+ - Option to configure existing Urbit IDs

60+ - Access to Urbit IDs via sub-domains of the existing Web2 domains in question. For example, john.com may have ~Urbit ID.john.com

61+ - Option to exchange DMs (Direct Messages) within the wallet amongst each other

62+

63+Timeline: 8 weeks from start of project

64+

65+Reward: 5 Stars

66+

67+# Future Work

68+

69+The next two phases of work will consist of:

70+

71+1. Web based decentralized application to allow Web2 domain holders + Web3 domain holders of Ethereum, Solana, Hedera Hashgraph & Concordium to:

72+ - Map their existing Urbit IDs with the Web2 or Web3 domains (as indicated above)

73+ - Buy new Urbit IDs

74+ - Configure Urbit IDs

75+ - Decentralized application to allow connectivity for the respective wallets of the chains (one wallet each chain)

76+ - Exchange DMs using the Urbit IDs as hook and accessible over decentralized application

77+

78+

79+2. Integration of DID Resolver for Urbit allowing:

80+ - Ships to resolve to DIDs

81+ - Web23 wallet to resolve DIDs since Urbit IDs would be mapped to the

82+wallet

83+ - Decentralied apps to resolve DIDs

84+

85+# Overall Benefits

86+

87+ - Web2 domains get coupled with Urbit IDs for future sign-ups over dApps - for enhanced utilities of Urbit IDs

88+ - Insertion of Urbit IDs into the zone files of Web2 domains - for future readiness when DNS resolvers may have to query about the Urbit IDs

89+ - Easy access of Urbit IDs or dApp running web pages via integrated hosting services. For example, ravmel-ropdyl.john.com if Urbit ID ~ravmel-ropdyl creates a hinge with john.com

90+ - Integration of DID resolving part from within the proposed Web23 wallet- allowing users to keep & manage Urbit IDs, DIDs, Web2 domains and even Web3 domains -lying over Ethereum, Solana & Hedera Hashgraph

91+ - Push of Urbit IDs to all the Web2 domainers

92+

93+# Why Us?

94+

95+ - Our core expertise & experience run in decades of man hours in the Unix/Linux & domains, DNS at large

96+ - [Web23](https://web23.io/) is one of the grantees of Hedera Hashgraph - we have developed complete naming system for .hbar and various project TLDs over Hedera

97+ - Web23 has collaborated with many ICANN registrars & registries to bring in the Web2 domainers to the evolving webspace of Web3

98+ - Web23 is working to transform any Web2 domain to a Web3 domain

99+

100+# Specific Deliverables

101+

102+ - Web23 domain centric wallet

103+ - DID resolver as NPM based library

104+ - Integrated DID resolver within the Web23 wallet as well as the application layer for the ships

105+ - A decentralized web application with integrations of Metamask, Phantom & Blade to allow buying, mapping of Urbit IDs to Web2 domains

106+

content/grants/2023/network-weather.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+

3+title = "Network Weather Simulator for %pyro/%aqua"

4+date = "2023-03-02"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Network Weather Simulator for `%pyro`/`%aqua"

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1004"

17+completed = false

18+canceled = false

19++++

20+

21+`%pyro` and `%aqua` are virtualization tools that allow developers to run one or many virtual ships within their ship. This opens up many testing possibilities, since it's possible to spin up an entire fleet of virtual ships with state and orchestrate them within your ship. But since all of hte ships run one one computer, the network conditions are unrealistically good. In the real world, network connections fail, time out and generally perform in unexpected ways.

22+

23+Write a library that allows developers to easily add realistic "network weather" to fleet testing in `%pyro`/`%aqua`

24+

content/grants/2023/oauth2-stella-fixa-rfp.mdnew file+31

@@ -0,0 +1,31 @@

1++++

2+title = "Build a Single-Sign-On App for Urbit"

3+date = "2023-05-11"

4+

5+[taxonomies]

6+grant_type = ["RFP"]

7+grant_category = ["App Dev"]

8+

9+[extra]

10+image = ""

11+description = "Produce an OAuth-compatible token issuer and login manager."

12+reward = "TBD"

13+assignee = [""]

14+champion = [""]

15+grant_id = "P1001"

16+completed = false

17+canceled = false

18+

19++++

20+

21+OAuth has widespread support in Web 2.0 circles. OAuth issues permissioned tokens for service providers to manage sessions. There are burgeoning tools for Web3 integration.

22+

23+OAuth focuses on access delegation, meaning that one can authenticate into a third-party session using a primary identity but without giving one’s password to the third-party service provider. “OpenID is a way to use a single set of user credentials to access multiple sites, while OAuth facilitates the authorization of one site to access and use information related to the user's account on another site.”

24+

25+By providing Urbit with OAuth support, the ability to use Urbit to log into a variety of Web 2.0 services will be unlocked.

26+

27+Some resources that may be helpful in scoping such a project:

28+

29+- https://oauth.net/getting-started/

30+- https://www.oauth.com/oauth2-servers/getting-ready/

31+- https://www.pmail.com/devnews.htm

content/grants/2023/osmosis-client.mdnew file+48

@@ -0,0 +1,48 @@

1++++

2+

3+title = "Osmosis Client on Urbit"

4+date = "2023-03-26"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "The Urbit client for the Osmosis multi-chain DEX."

13+reward = "3 Stars + Bonus"

14+assignee = ["~larryx-woldyr"]

15+champion = [""]

16+grant_id = "B0234"

17+completed = true

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0234&prefill_Grant+Name=Osmosis%20Client%20for%20Urbit"

20+deliverable = "~larryx-woldyr/osmosis"

21+

22++++

23+

24+

25+## Overview

26+

27+An Urbit app that serves a personal client for the [Osmosis](https://app.osmosis.zone) multi-chain DEX.

28+

29+## Rationale

30+

31+Osmosis is the leading decentralized exchange for the Cosmos ecosystem. Most users access this DEX through [the front end developed](https://github.com/osmosis-labs/osmosis-frontend) by the Osmosis team and deployed at [app.osmosis.zone](https://app.osmosis.zone).

32+

33+Like many Dapps, the most used Osmosis front end is hosted on a central server. This falls short of the promise of decentralization and makes the application less resilient. On Urbit, it is easy for users to host their own front ends, making the system truly decentralized.

34+

35+Osmosis uses local browser storage for user configuration. This is not portable across browsers on the same machine or on different devices. The storage of this metadata on a user's urbit allows the data to remain private to the user and will survive swapping browsers and devices. At a later date, this configuration can be used by other apps and expand the scope of interoperability, eg. displaying which ships in a chat have a Cosmos wallet.

36+

37+## Scope / Implementation

38+

39+The first phase of this project is to bundle the [existing Osmosis front end](https://github.com/osmosis-labs/osmosis-frontend) and make it possible to serve from an Urbit.

40+

41+Once this is accomplished, a simple gall back end will be developed to replace the Osmosis client's use of browser `localStorage`. It may be necessary to fork the `osmosis-labs` code in order to replace API calls to localStorage with calls to the Urbit back end.

42+

43+Developer can assume that users will access this client through a browser that can install the Keplr wallet extension. There are currently projects in process to create an in-Urbit Cosmos wallet, but that integration is out of scope for this bounty.

44+

45+## Compensation

46+

47+3 Stars with a 1500 USDC bonus to be provided by the Osmosis foundation.

48+

content/grants/2023/pastebin-RFP.mdnew file+28

@@ -0,0 +1,28 @@

1++++

2+

3+title = "Pastebin on Urbit"

4+date = "2023-03-02"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Share plaintext snippets on Urbit"

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1000"

17+completed = true

18+canceled = false

19+

20++++

21+

22+# Description

23+Tools like pastebin and Github gists allow users to easily share plain text snippets. This is useful for sharing code or simple writeups.

24+

25+Implement minimal plaintext snippet sharing for Urbit, with support for both public (anyone with the path can read the snippet) and private (only invited individuals can read snippets).

26+

27+# Link to Proposal

28+[Pastebin on Urbit](https://urbit.org/grants/pastebin-proposal)

content/grants/2023/pastebin-proposal.mdnew file+33

@@ -0,0 +1,33 @@

1++++

2+

3+title = "Pastebin on Urbit"

4+date = "2023-06-05"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = ""

13+reward = "1 Star"

14+assignee = ["~polwex"]

15+champion = ["~poldec-tonteg"]

16+grant_id = "P0271"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Description #

23+

24+One of the promises of Urbit, perhaps the biggest one, is making the Internet peer-to-peer again. That's what it's designed to do. If I want to share data with other people I should be able to share it directly. I should not need to use other people's computers (the "cloud") to share a file, or a text snippet.

25+

26+While Dropbox-like functionality will take some time to arrive to Urbit, one thing we can do right now is more simple data sharing. Pastebin is a very useful website, but again it boggles the mind that you need to use an external service to share a simple piece of text with your friends. It should be easier. We will make it so.

27+

28+This proposal will create an Urbit application to share arbitrary text. You will be able to produce a link that will display a piece of text that you saved. You will be able to expose that document to the clearweb, only inside Urbit, or to selected Urbit ships of your choice.

29+

30+# Compensation #

31+Reward: 1 star

32+#

33+Note: This proposal was modified from the [Pastebin on Urbit RFP](https://urbit.org/grants/pastebin-RFP).

content/grants/2023/portal-features-1.mdnew file+82

@@ -0,0 +1,82 @@

1++++

2+

3+title = "Advanced Portal Features Phase 1"

4+date = "2023-04-13"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = ""

13+reward = "3 Stars"

14+assignee = ["~toptyr-bilder", "~dilryd-mopreg", "~foddur-hodler"]

15+champion = ["~poldec-tonteg"]

16+grant_id = "P0251"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Rationale

23+

24+Portal currently allows for simple discovery of groups and apps, but there are still outstanding problems in user onboarding and advanced curation and discovery. In particular, first-time users would benefit from an onboarding flow that provides personalized recommendations and an overview of Portal’s functionality. Further, curators should have the flexibility to make their posts and collections high-quality and personalized, and to create recurring relationships with users via follow and notification features. By solving these problems we further improve Urbit user activation and retention, and we aim to increase Portal’s weekly active user (WAU) count.

25+

26+For context on previous work, see our [previous grant](https://urbit.org/grants/app-store) and its [M4 redefinition](https://docs.google.com/document/d/10tZgF8ZA9KQbRYD7MDZ7v-iuIeO2nPNppj9CMRBVg7g/edit#).

27+

28+# Milestones Overview

29+

30+The grant will consist of many small features per milestone. We expect to be flexible on the actual grouping and focus rather on shipping features that will increase WAU. (Phase 1 will consist of Milestones 1 -3.)

31+

32+## Milestone 1

33+ - Build a real-time global feed

34+ - Build an indexer to accomplish the above

35+ - Build out unified data model and schemas for different types of items

36+## Milestone 2

37+ - %blogs and %groups notebooks integration

38+ - Basic custom feeds

39+ - Replace react with Svelte

40+## Milestone 3

41+ - Support comments on all items

42+ - Re-share posts

43+ - Pre-populate posts to share desks and groups that the user hosts

44+ - Publish content to web2

45+

46+# Future Work

47+## Milestone 4

48+ - Follow other users

49+ - Implement paywalls

50+ - Fully-featured posts

51+ - Markdown support for items

52+ - Groups and apps can only be posted by their host

53+## Milestone 5

54+ - %pals integration

55+ - Tags can be applied to all items (lists, curators, etc)

56+ - Richer post metadata like number of app downloads/app versioning/poster info

57+ - Fully-featured profiles

58+ - Richer profile metadata

59+ - Markdown support for profile descriptions

60+

61+# User Stories

62+## Milestone 1

63+1. I’m a first-time Urbit user and I want good suggestions for content so that I can find my people on Urbit

64+2. I’m a return user and I want personalized curation integrated into my experience so that I can find relevant content without trying

65+## Milestone 2

66+3. I’m a user and I want to be able to make my content discoverable quickly and easily so that I can get distribution

67+4. I’m a user and I want a synopsis of the content being shared in a group so that I can quickly pick out the most interesting parts of the conversation

68+## Milestone 3

69+5. I’m a user and I want to be able to reference and comment on other people’s items so that I can build on others’ content

70+6. I’m a user and I want to be able to make my content discoverable quickly and easily so that I can get distribution

71+7. I’m a user and I want to be able to make my content discoverable on web2 so that I can share my Urbit content more broadly

72+## Milestone 4

73+8. I’m a user and I want to know which developers and content creators are notable and trustworthy so that I can find good content

74+9. I’m a content creator and I want to be able to leverage markdown in my posts so that I can create more attractive + organized content

75+## Milestone 5

76+10. I’m a curator/developer/content creator and I want to have a fully-featured, professional-looking profile page so that I can create a good reputation

77+11. I’m a user and I want to know that the app I’m downloading is trusted and safe so that I don’t get malware

78+

79+# Timeline and Compensation

80+Each milestone is expected to be completed over the course of roughly 1 month. Along with the prescribed features (which may be subject to slight reprioritization), completion of each milestone is dependent upon increasing Portal’s WAUs by 10% over baseline, as measured before any of the current milestone’s features have been introduced. Meeting these criteria will yield compensation of 1 star per milestone.

81+

82+

content/grants/2023/privacy-msg.mdnew file+89

@@ -0,0 +1,89 @@

1++++

2+

3+title = "Privacy Messaging"

4+date = "2023-04-07"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "Communicating Urbit's unique privacy potential"

13+reward = "4 Stars"

14+assignee = ["~dibnyt-wisfyn"]

15+champion = ["~poldec-tonteg"]

16+grant_id = "P0257"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Overview #

23+

24+The goal of this work is to improve Urbit’s appeal to potential developers by highlighting and communicating its unique privacy potential.

25+

26+## Initial Insights

27+

28+ - Urbit is currently focused on attracting developers who will build the apps that bring users to the platform

29+ - Even some currently active developers don’t fully understand the full offering of Urbit

30+ - Urbit isn’t inherently private - it’s “privacy prone”

31+ - Urbit OS does so much for developers that they can add in features for almost nothing - privacy is one of those features

32+

33+# Work Summary #

34+

35+## Research

36+

37+ - Interviews to examine and understand current state of Urbit’s offering

38+ - Explore where Urbit wants to go in the future

39+ - Interviews to examine what developers are creating and motivations for coming to the platform

40+ - Determine what related offerings are being missed by existing developers

41+

42+## Development

43+

44+ - New messaging strategy and copywriting based on research

45+ - Incorporate growth strategy to target the ideal developers and grow our developer base in sync with Urbit’s theory of change

46+ - Exploration of ideal implementation - comms channels, structure, media formats

47+ - Rounds of feedback internally and externally (developers) to improve messaging

48+

49+## Implementation

50+

51+ - Messaging strategy presented internally to guide thinking for Urbit Foundation, Tlon, and other established developers

52+ - Messaging incorporated to assets presented to new and potential developers - (website and videos)

53+ - Potentially guidance verging on curricula - opportunity to incorporate into Hoon School

54+

55+# Guiding Principles #

56+

57+ - Overall - Develop a shared language around Urbit’s privacy features that both supports Urbit Foundation’s vision for the future and speaks to the practical implications for developers

58+ - Research - Ensure project success by making sure all stakeholder viewpoints are heard and considered from the earliest stages in the process

59+ - Development - Strive to approach communications in a way that feels interactive and engaging

60+ - Implementation - Identify and collaborate with the individuals within Urbit Foundation that need to greenlight any actions early on in the process

61+

62+# Growth Framework #

63+Through attracting new developers, deepening understanding, or a combination of both we can see three general types of growth:

64+

65+ - Attract new developers with a basic understanding of Urbit features

66+ - Expand capabilities of existing developers

67+ - Attract new developers interested in novel implementations of Urbit OS

68+

69+# How This Can Support Future Work #

70+

71+Privacy is one of many features that Urbit offers. This means that this project can model and test an approach to messaging replicable across all aspects of Urbit. The goal is to create something that is not solely top-down (led by Urbit Foundation) or bottom-up (led by 3rd party developers). Rather we want to support both the vision of Urbit and the motivations of developers and meet somewhere in the middle.

72+

73+# Timeline and Compensation #

74+

75+Timeline: Approximately 10 weeks

76+

77+ - Stakeholder Identification ~ .75 wks

78+ - Interview Prep + Scheduling ~ .75 wks

79+ - Internal + External Interviews ~ 2 wks

80+ - Analysis & Reframing ~ 1 wks

81+ - Ideation & Feedback ~ 2.5 wks

82+ - Development & Implementation ~ 3 wks

83+

84+Reward: 4 Stars

85+

86+# Summary #

87+

88+While the underlying technology behind Urbit is incredible, the current messaging strategy is not focused enough on the value that tech brings to our core audience. This hinders conversion of new developers to the platform and limits the capabilities of existing developers.

89+By addressing this issue (starting with the topic of privacy), this work will be invaluable in helping Urbit grow. Additionally, it will model a systematic yet flexible process of working with stakeholders—both internally and externally—that can be used to improve messaging across any number of topics.

content/grants/2023/quorum-2.mdnew file+84

@@ -0,0 +1,84 @@

1++++

2+title = "Quorum 2"

3+date = "2023-03-20"

4+

5+[taxonomies]

6+grant_type = ["Proposal"]

7+grant_category = ["App Dev"]

8+

9+[extra]

10+image = ""

11+description = "Improve the usability and accessibility of Quorum in the Urbit ecosystem"

12+reward = "6 stars"

13+assignee = ["~tamlut-modnys", "~litlep-nibbyt", "~sidnym-ladrut"]

14+grant_id = "P0254"

15+champion = ["~lagrev-nocfep"]

16+completed = false

17+canceled = false

18++++

19+

20+# Purpose #

21+

22+Quorum needs many usability and accessibility improvements to make it an impactful part of the Urbit ecosystem. Its latent utility to capture and retain domain knowledge across the ecosystem has been hindered by its “minimum viable product” feature set and its existence as disjoint to Tlon’s more central Groups product (with which it overlaps on many organizational features).

23+

24+The work proposed for this grant will address these issues by:

25+1) Extending Quorum into a custom Q&A channel type in Tlon’s Groups with the added goal of becoming a blueprint for future third-party Groups integrations.

26+2) Adding essential Q&A board functionalities to Quorum such as post editing, content moderation tools, and enhanced search.

27+3) Implementing quality of life improvements to the Quorum frontend which will make the UI more user friendly.

28+

29+# User Stories #

30+

31+## `%groups` User Stories ##

32+

33+- As a %groups admin with %quorum installed, I can create Q&A channels in my groups, which have a name, host ship, and permissions options identical to the existing channel types (i.e. open to all, members only, or admins only).

34+- As a %groups admin with %quorum installed, I can modify my Q&A channels like other channel types, e.g. by renaming the channel, deleting the channel, and so forth.

35+- As a %groups user with %quorum installed, I can see and join Q&A channels in my groups.

36+- As a %groups user with %quorum installed, I can browse and manipulate the content of Q&A channels in the %groups interface.

37+

38+## `%quorum` User Stories ##

39+

40+- As a %quorum admin, I can remove posts from my Q&A channels.

41+- As a %quorum admin, I can edit the content (i.e. title, text, and tags) of any post made to my Q&A channels.

42+- As a %quorum admin, I can create and edit a set of allowed tags for posts made within my Q&A channels.

43+- As a %quorum admin, I can run a `dojo` command in order to import a legacy %quorum board into the new interface.

44+- As a %quorum user, I can browse through the paginated archive of posts on my Q&A channels.

45+- As a %quorum user, I can perform a string or tag-based query and view the paginated results on my Q&A channels.

46+- As a %quorum user, I can edit the posts I’ve authored.

47+- As a %quorum user, I can delete the posts I’ve authored.

48+- As a %quorum user, I can view the history of a post that has been edited.

49+- As a %quorum user, I can paste a %groups reference into a question or answer submission to copy its content from %groups.

50+

51+# Timeline #

52+

53+## Milestone #1 - Permissions Refactor & QoL Improvements ##

54+

55+- **Reward**: 3 stars

56+- **Tasks**:

57+ - Refactor %quorum to gate board entry based on %groups permissions.

58+ - Add front-end subscription support for reliable post-poke page updates.

59+ - Enable authors and board admins to edit post content.

60+ - Enable authors and board admins to delete posts.

61+ - Update the post voting indicator to display the personal vote cast rather than the aggregate score direction.

62+

63+## Milestone #2 - New Features & Groups Integration ##

64+

65+- **Reward**: 2 stars

66+- **Tasks**:

67+ - Enable users to browse each post’s edit history.

68+ - Allow users to view the different edited versions of a post in the thread view (i.e. as different standalone versions without diffs).

69+ - Display all authors involved in constructing a post (original author & editors).

70+ - Add result pagination for board and question listings, including search results.

71+ - Implement tag-based search via (1) the search bar and (2) clicking on a post tag.

72+ - Allow admins to optionally create a set of eligible tags for their boards.

73+ - Enable %groups “refs” submissions for posts, which will be replaced on publication with the original %groups content.

74+

75+## Milestone #3 - Groups Plugin Support ##

76+

77+- **Reward**: 1 star

78+- **Tasks**:

79+ - Revamp the %quorum user interface to improve the UX for %groups embedding.

80+ - Replace the navigation bar actions with in-form buttons.

81+ - Replace the search bar with a form of floating/toggled search menu.

82+ - Integrate %quorum as a %groups channel type plugin.

83+ - Create scry endpoint(s) for %groups channel type metadata and coordination.

84+ - Add poke endpoint(s) for any necessary %groups join and leave behaviors.

content/grants/2023/replit.mdnew file+52

@@ -0,0 +1,52 @@

1++++

2+

3+title = "Replit & Replit Integration for Site"

4+date = "2023-06-21"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "Produce a Replit-compatible binary and instance."

13+reward = "4 stars"

14+assignee = [""]

15+champion = ["~mastyr-bottec"]

16+grant_id = "B0282"

17+completed = false

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0282&prefill_Grant+Name=Replit%20%26%20Replit%20Integration%20for%20Site"

20+

21++++

22+

23+# Replit & Replit Integration for Urbit Developer Site

24+

25+A Replit instance lets you specify the running status of a ship and associated files. In practice, this means a fakezod which is automatically logged in, has `%base` `|mount`ed, and has `|autocommit` set for ease of use. The instance should connect to the file in some cases, the Dojo terminal in others.

26+

27+We anticipate that the biggest part of this bounty will focus not on designing the Replit environment but instead on building a Prybar binary for full REPL compatibility.

28+

29+By forking from your base instance, you should be able to prepare a base instance which meets the above basic setup criteria. Then from that, build forks which automatically inject the correct code when a generator or other specified expression has been supplied to the student.

30+

31+## Milestones

32+

33+### Milestone 1 (3 stars)

34+

35+Build a working Replit-compatible binary and base instance. This Replit instance should be [Prybar](https://github.com/replit/prybar)-compatible so that the Replit console can directly run the Dojo instance. (That is, no `screen` or `tmux` screen management is necessary for the user.)

36+

37+This may require using `%khan` and other affordances to interact with Dojo or a primary agent.

38+

39+The final deliverable should include the Prybar binary, a base Replit instance, and a Docker image suitable for use with Replit.

40+

41+### Milestone 2 (1 star)

42+

43+The Hoon School docs will benefit from direct integration of executable code blocks. To claim this bounty, you will need to prepare and include customized Replit instances at every appropriate explanation, exercise, and challenge in [the Hoon School docs](https://developers.urbit.org/guides/core/hoon-school). (This does not mean everywhere there are code blocks now; you will work with your grant champion to identify all of these.)

44+

45+(This can be split into a separate bounty based on temperament of the grantee completing Milestone 1.)

46+

47+## Resources

48+

49+- https://docs.replit.com/programming-ide/configuring-repl

50+- https://github.com/replit/prybar

51+- https://replit.com/@matthew-levan/Urbit-1#README.md

52+- https://docs.replit.com/hosting/embedding-repls

content/grants/2023/school-support-23q1.mdnew file+43

@@ -0,0 +1,43 @@

1++++

2+

3+title = "School Support"

4+date = "2023-01-25"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Supporting online course teaching and composing grading apps."

13+reward = "2 stars"

14+assignee = ["~tamlut-modnys"]

15+champion = ["~lagrev-nocfep"]

16+grant_id = "B0225"

17+completed = true

18+canceled = false

19+link = ""

20+

21++++

22+

23+# Rationale

24+

25+A teaching assistant and developer will support App School Live and Hoon School

26+Live, including producing basic courseware tools as command-line apps and agents.

27+Some of this will involve further developing Urbit Forms or another backend to

28+facilitate grading of submissions and allow us to natively showcase that tool in

29+a course setting.

30+

31+# Implementation

32+

33+The basic spec for this proposal:

34+

35+- support teaching and grading ASL and HSL

36+- course grading CLI tools (grading agent or thread from reference answer to student answer yielding final grade)

37+- course admin CLI tools (gradebook store with DM reporting agent or thread)

38+- maybe Urbit Forms upgrade/update (postponing)

39+

40+(So about three agents/threads.)

41+

42+# Compensation

43+Reward: 2 Stars

content/grants/2023/splitwise-rfp.mdnew file+26

@@ -0,0 +1,26 @@

1++++

2+

3+title = "Expense Sharing App for Urbit"

4+date = "2023-04-03"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Create a crypto and fiat expense sharing app for Urbit "

13+reward = "1 Star"

14+assignee = ["~talfus-laddus"]

15+champion = [""]

16+grant_id = "P0279"

17+completed = true

18+canceled = false

19+

20++++

21+

22+The Urbit community hosts many IRL events and, inevitably, this means splitting tabs with other Urbiters. Urbit needs its own expense sharing app that seamlessly keeps track of all expenses and IOUs in one place and works with both crypto and fiat.

23+

24+The Urbit version can be loosely modeled on the expense sharing app [Splitwise](https://www.splitwise.com). Splitwise uses centralized cloud infrastructure, but an Urbit version could be architected so that accounts payable and receivable are kept on your ship. The Urbit version should also be mobile-first, so it's easy to use on the go.

25+

26+See the full proposal [here](https://urbit.org/grants/splitwise)

content/grants/2023/splitwise.mdnew file+129

@@ -0,0 +1,129 @@

1++++

2+

3+title = "Expense Sharing App"

4+date = "2023-06-22"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = ""

13+reward = "1 Star"

14+assignee = ["~talfus-laddus"]

15+champion = [""]

16+grant_id = "P0279"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Motivation

23+The Urbit community hosts many IRL events and, inevitably, this means splitting tabs with other Urbiters. Urbit needs its own expense sharing app that seamlessly keeps track of all expenses and IOUs in one place and works with both crypto and fiat [RFP](https://urbit.org/grants/splitwise-rfp).

24+

25+Urbit is for small communities. And those need a way to keep track of and to split shared expenses.

26+

27+# Basic User Story

28+A member of a group wants to keep track of all expenses in order to eventually settle debts with a minimal number of transactions.

29+

30+# Basic User Tasks

31+ - Create or select a group

32+ - Invite other people to the group

33+ - Add an expense involving other group members

34+ - View all expenses

35+ - Edit an expense

36+ - Delete an expense

37+ - Retrieve a suggestion on how to balance debts with minimal number of transactions

38+

39+# Basic User Flow

40+1. Select a group

41+2. Add an expense

42+3. Check balance

43+ - Who is owed, and who owes money to the group and how much?

44+4. Settle debts

45+ - The app suggests an efficient way to settle debts in the group

46+ - Mark outstanding expenses as paid

47+

48+# Architecture

49+The architecture will be loosely modeled on existing expense sharing apps such as [Splitwise](https://www.splitwise.com/) and [Tricount](https://www.tricount.com/en/).

50+

51+An expense can involve only a subset of all group members. It has the following attributes:

52+

53+- title (For what reasons?)

54+ - payer (Who paid?)

55+ - involves (For whom?)

56+ - date (When?)

57+ - amount (How much?)

58+ - currency

59+ - note

60+

61+All group members are ships (`@p`). A list of group members and all expenses of the group will be stored on the ship of the group initiator. Other group members will read and write from/to there.

62+

63+In order to find a minimum number of transaction to settle debts in the group ("simplified debts"), shared expenses will be modeled as a flow network. Money flows from the participants who owe money to the group (debitors) to the participants who are owed money by the group (creditors). Using [Edmonds–Karp algorithm](https://en.wikipedia.org/wiki/Edmonds%E2%80%93Karp_algorithm), the [maximum flow](https://en.wikipedia.org/wiki/Maximum_flow_problem) of this network will be computed. From the resulting residual network transactions to balance out shared expenses will be derived. A Python reference implementation can already be found [here](https://git.sr.ht/~talfus-laddus/splt-exps-py).

64+

65+*Note: The trivial case of settling debts among two person (group size of two) is of course supported.*

66+

67+# Backend

68+The backend will be a gall agent with a basic set of operations addressing the user's needs listed above. Alongside the gall agent, a couple of libraries will be created: A library implementing the Edmonds-Karp algorithm and a library handling currency exchange rates and conversions.

69+

70+# Frontend

71+[Keep it simple, stupid!](https://en.wikipedia.org/wiki/KISS_principle)

72+The frontend will be a mobile-first website.

73+

74+It is an open question whether the frontend will in the initial phase be served from Mars or Earth. The website should eventually be served from the ship.

75+

76+# Milestones

77+Documentation and tests throughout the code base will be present. The source code will be available in a public git repository and licensed under MIT.

78+

79+## Milestone 1 - Proof of Concept

80+Completion: Beginning of App School Live (August 2023)

81+

82+Payment: None

83+

84+Deliverables: Edmonds-Karp Library

85+

86+The Proof of Concept (POC) demonstrates how to model shared expenses as a flow network and how to derive from it the minimum number of transactions needed to settle debts. The POC implements the Edmonds-Karp algorithm as well as the logic of how to construct the flow network from a list of expenses and how to derive a list of transactions from the residual network.

87+

88+## Milestone 2 - Minimal Viable Product

89+Completion: End of App School Live before Assembly (October 2023)

90+

91+Payment: 1 Star

92+

93+Deliverables : Gall Agent: Website

94+

95+The Minimal Viable Product (MVP) consists of a gall agent as backend and a website as frontend.

96+

97+Iterations

98+1. Create a gall agent containing a basic set of operations to manage groups and to add, store, delete and retrieve group expenses.

99+2. Create a simple, stupid and mobile-first website as an interface to the gall agent.

100+3. Add a feature to “simplify debts” by integrating the Edmonds-Karp library into the gall agent. The agent can suggest a way to balance out shared expenses with a minimal number of transactions.

101+4. Synchronize expenses among the group members.

102+5. Handle different currencies. Retrieve the current exchange rate and do conversions between currencies.

103+6. Make the app available through Software Distribution.

104+

105+# Limitations

106+Since the list of expenses is stored on the group initiator's ship, when it is down other people can not synchronize their state of the application.

107+

108+# Additional Future Work

109+The future of the app could entail:

110+

111+ - A robust decentralization/synchronization mechanism which addresses the limitation raised above

112+ - A more polished interface

113+ - An integration into Groups

114+ - Apps for Android and iOS

115+ - A new feature to categorize expenses and derive statistics

116+ - Yet unforeseen improvements

117+

118+# About Me

119+I am in search of something worthwhile to contribute my time and effort to.

120+

121+My name is Matthias Schaub (`~talfus-laddus`). Even though I work part-time as a software developer for a non-profit corporation dedicated to better society and environment, I feel the need to spend my time on projects of which I am more confident that they provide sustained value to society (or at least have the potential to). That is why I am invested to contribute to the Urbit ecosystem by learning Hoon and how to build applications on Urbit. A more basic motivation is to have my flat mates on Urbit. Beside a chat, we need a way to handle shared expenses.

122+

123+I attended Hoon School and registered for App School. Alongside the App School curriculum, I want to foster my learning by building this application. On Earth side I have solid Python and basic HTML, CSS, and JavaScript skills. I am proficient in git, and I am used to working with a terminal on a Linux machine. In the past, I wanted to read the reference of a Hoon rune without leaving Vim. So I wrote a Python script to convert Hoon rune references from Markdown to Vimdoc. The result is a Vim helpfile in disguise of a plugin ([hoon-runes.vim](https://git.sr.ht/~talfus-laddus/hoon-runes.vim)). Shortly after, I did the same for the documentation of the Hoon standard library ([hoon-stdlib.vim](https://git.sr.ht/~talfus-laddus/hoon-stdlib.vim)).

124+

125+In order to find out more about my previous works:

126+ - [Personal website](https://talfus-laddus.de/)

127+ - [Sourcehut](https://git.sr.ht/~talfus-laddus)

128+ - [GitHub](https://github.com/matthiasschaub)

129+

content/grants/2023/text-search.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+

3+title = "Generic Text Search Tool for Urbit"

4+date = "2023-03-02"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Build Urbit's answer to grep."

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1002"

17+completed = false

18+canceled = false

19+

20++++

21+

22+Text search is a key part of many different use cases, but Urbit currently has no equivalent to `grep`, the general purpose GNU search tool.

23+

24+Build Urbit's answer to `grep`.

content/grants/2023/tinygrad.mdnew file+24

@@ -0,0 +1,24 @@

1++++

2+

3+title = "Tinygrad ML Library in Hoon"

4+date = "2023-03-02"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Implement a small machine learning library (and jets!) in hoon."

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1003"

17+completed = false

18+canceled = false

19+

20++++

21+

22+Geohot has published the [Tinygrad library](https://github.com/geohot/tinygrad) for doing basic machine learning. This library is small and simple which makes it a potentially good target for jetting. Doing so would give basic ML functionality in Urbit.

23+

24+Implement Tinygrad (with jets) in Urbit

content/grants/2023/treesitter.mdnew file+71

@@ -0,0 +1,71 @@

1++++

2+

3+title = "Treesitter Hoon Parser"

4+date = "2023-05-11"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Create a better hoon parser with Treesitter"

13+reward = "2 Stars"

14+assignee = ["~hosweg-silpur"]

15+champion = [""]

16+grant_id = "P0263"

17+completed = false

18+canceled = false

19+

20++++

21+

22+# Summary

23+

24+Tree-sitter is a fast parser that supports smarter syntax highlighting that makes use of the syntax tree.

25+

26+# Background

27+

28+Current syntax-highlighters are based off complicated regex that are overly complicated and inaccurate. Tree-sitter parses the whole document and creates an abstract syntax tree (AST) which can then be used to correctly highlight syntax.

29+

30+The current syntax highlighters available for hoon are:

31+

32+- **Hoon-lsp**: Decent, but due to being a semantic highlighter it naively highlights using regex matches. As an example it does not know the difference between `!=(a)` and `!=(a 1)`. (The first is the `zaptis` rune taking `a` as a sample, the second is `!` applied to an equality check between `a` and `1`)

33+

34+- **Hoon.vim/hoon-mode.el**(emacs package): This is also a regex matcher and suffers from the same problems above.

35+

36+In conclusion, creating a tree-sitter parser will allow for superior Hoon highlighting to be used in more code-editors.

37+

38+

39+# Milestones and Compensation

40+## Milestone 1: Writing the grammar

41+

42+**Estimated Completion**: Completed

43+

44+**Payment**: 1 star

45+

46+ - Write a tree-sitter grammar that parses Hoon

47+ - Create unit tests for each syntax component (runes, irregular syntax, mold, strings...)

48+

49+

50+## Milestone 2: Code editor Integration

51+

52+**Estimated Completion**: May 2023

53+

54+**Payment**: 1 star

55+

56+Integrate the tree-sitter parser with various code-editors.

57+

58+Desktop editors:

59+ - VScode

60+ - Emacs

61+ - Neovim

62+ - Atom

63+Online editors:

64+ - Monaco

65+ - Codemirror

66+

67+# Future Work

68+

69+- GitHub Gist alternative on Urbit

70+- Online IDE with `%pyro` sandbox

71+- Collaborative Hoon code-editing with CRDTs

content/grants/2023/turf.mdnew file+205

@@ -0,0 +1,205 @@

1++++

2+

3+title = "Turf"

4+date = "2023-05-17"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Build a thriving and customizable virtual world on Urbit"

13+reward = "9 Stars"

14+assignee = ["~midlev-mindyr"]

15+champion = ["~reb"]

16+grant_id = "P0265"

17+completed = false

18+canceled = false

19+

20++++

21+

22+## Summary

23+

24+Turf is like if [gather.town](http://gather.town/) were fully customizable, interconnected, and lived on Urbit. However, to start out with, it will have a lot less content and features. Turf will be good for Urbit for the following reasons:

25+

26+- it will be fun / it will give people another reason to use Urbit day-to-day

27+- it will enable spontaneous and casual social interactions

28+- it will be a space that people can mold and construct freely, which means it can naturally develop into a vibrant, complex virtual world

29+- it will cause people to crave app interoperability like never before, which will mean I can later build a plugins system (Monkey) and actually convince people to use it

30+

31+Each turf is made up of pixelated tiles which can be customized with a variety of items, and people can run around in them and chat with voice and text. Everyone can make their own turfs, and (with consent) make portals to other turfs. At the end of the final milestone, we hope to have a thriving, organically self-organizing web of connected turfs, where people know how to get where they’re going and have lots of new things to discover all around them.

32+

33+## Why me

34+

35+I have some amateur gamedev experience, some hoon experience, plenty of frontend experience (see Astrolabe). I have been thinking about something like Turf for a while, but I’m actually proposing it now because it seems like a necessary step to generate interest in a plugin system I want to build (plus it sounds fun!). So, I want to be the one to build Turf so that I can use it to demonstrate and promote Monkey (the plugin system).

36+

37+## User Stories

38+

39+After each user story is the short code for the milestone which will implement it:

40+

41+SP - Single-Player MVP

42+

43+MP - Multiplayer

44+

45+HT - Hometowns

46+

47+AI - Advanced Items

48+

49+SS - Super Speed with WebRTC

50+

51+TP - Advanced Turfs & Permissions

52+

53+?? - Some Future Grant??

54+

55+**My Avatar**

56+

57+- I can customize my avatar’s appearance somewhat (SP)

58+

59+**My Turf**

60+

61+- I can have a turf (SP)

62+- I can have multiple turfs (TP)

63+- I can resize my turf(s) (SP)

64+- I can customize my turf’s appearance by placing items (floor, walls, furniture, decor, objects, portals) (SP)

65+- I can move around in a turf (SP)

66+- I can explicitly specify who can and can’t enter my turf (SP)

67+- I can specify advanced permissions for my turf(s) (TP)

68+- I can grant write access to part of a turf (even if I'm not a star) (TP)

69+- I can transfer ownership of my turf to someone else (TP)

70+

71+**Items**

72+

73+- I can create my own items (wearable, wall, floor, furniture, etc) (AI)

74+- I can add items I find in the wild to my library (AI)

75+- I can make my custom items do cool custom things (??)

76+

77+**Multiplayer**

78+

79+- I can see other people moving around (MP)

80+- I can see other people moving around in realtime (SS)

81+- I can chat with other people over text (MP)

82+- I can chat with other people over voice (SS)

83+- I can create portals to other turfs (MP)

84+- I can walk through portals to travel between turfs (MP)

85+- I can summon people when I’m in a turf I admin (MP)

86+- I can teleport home to my turf from anywhere (MP)

87+- I can place my turf in a hometown (HT)

88+- As a star, I can grant plots of turf to planets for embedding (HT)

89+

90+**Misc**

91+

92+- I can integrate other apps with my turf (using %monkey) (??)

93+

94+# Milestones

95+

96+I’m asking for 9 stars for 6 milestones, which I plan to complete in 46 weeks, working part-time with a couple built-in vacations. These milestones may be accelerated if I’m able to spend fewer days on my day job. The Due Dates assume a contract is signed before May 20th, 2023. Milestones 4-6 may be reordered based on user feedback.

97+

98+## Milestone #1 - Single-Player MVP

99+

100+Reward: 1 star

101+

102+Time: 6 weeks (plus a bit of time I’ve already put in)

103+

104+Due Date: June 25th, 2023

105+

106+- You have a little pixel-art character which you can customize with basic wearable items (facial features, skin color, hats, hair, shirts, pants)

107+- You have a turf associated with your ship, composed of tiles

108+ - Each tile has a square image 32x32px image

109+ - You can place a limited set of basic items (e.g. walls, floor, grass, tables, chairs)

110+ - You can resize your turf

111+- You can move around on the grid

112+

113+## Milestone #2 - Multiplayer

114+

115+Reward: 2 stars

116+

117+Time: 9 weeks (I’d say 6, but I will have less time to work on Turf during this period)

118+

119+Due Date: August 27th, 2023

120+

121+- Through mutual agreement, two players can link their turfs with a 2-way portal. Players can visit each other by traveling through those portals.

122+- When in a turf with other players, you can see them move around (with some ames lag)

123+- You can send ephemeral, turf-scoped text chats which appear in a bubble overhead and in a chatbox sidebar

124+- Very basic permissions: I can choose to blacklist or whitelist @ps to gate visitors to my turf (prevent unwanted neighbors of neighbors)

125+- You can summon people to your turf

126+- You can teleport yourself home from anywhere

127+

128+## Milestone #3 - Hometowns

129+

130+Reward: 1 star

131+

132+Time: 5 weeks

133+

134+Due Date: October 1st, 2023

135+

136+- When I walk off my turf, I appear in my hometown, which is a star’s turf

137+- I can choose what star I want as my hometown and place my house in it, although some may require manual approval

138+- My turf/house has some little house avatar in the hometown which is customizable in some way

139+- Basic permissions for allowing people to claim (or request to claim) write access for a plot of land

140+

141+## Milestone #4 - Advanced Items

142+

143+Reward: 2 stars

144+

145+Time: 9 weeks

146+

147+Due Date: December 3rd, 2023

148+

149+- You can create custom items w/ custom art (tile, furniture, decor, wearable)

150+ - Enable png import

151+ - In-app pixel art canvas

152+- Items can have basic interactions like:

153+ - portal: teleport the activator to a particular turf (with or without coordinates)

154+ - sign: display some text, markdown, or html in a popup

155+- Items can have a foreground and/or a background image

156+- Items can have simple animations

157+- Items can be oversized (e.g. a tree which is taller than 1 tile)

158+ - Items turn partially transparent when a person walks behind them

159+- Sharing items: when you see a cool item in someone else’s turf, you can add it to your personal item library

160+

161+## Milestone #5 - Advanced Turfs & Permissions

162+

163+Reward: 1 star

164+

165+Time: 10 weeks (would be 7 or 8, but for Christmas-time)

166+

167+Due Date: Feb 11th, 2024

168+

169+- You can create multiple turfs (and link them together, of course)

170+- You can transfer your turf to someone else

171+- You can ban all comets and/or moons from your turf

172+- You can grant people/lists of people permission to do the following wrt your turf

173+ - Join, move around, and chat (whole turf)

174+ - Redecorate tiles, add/remove items, create custom items (for sections or whole turf)

175+ - Claim sections of turf (with limits, of course)

176+ - Full admin (for sections or whole turf)

177+- Permission lists

178+ - You can assemble lists of people to more easily whitelist or blacklist the same people over and over. E.g. if you want to make the same 5 people and some of your moons admins in multiple of your turfs

179+ - You can sync a list to a group so that only members of the group have access to the land

180+ - There’s a “pals” list

181+

182+## Milestone #6 - Super Speed with WebRTC

183+

184+Reward: 2 stars

185+

186+Time: 7 weeks (hard to estimate, because I’ve never done anything with WebRTC)

187+

188+Due Date: March 31st, 2024

189+

190+- Use WebRTC for low latency movement and chat

191+- Use WebRTC for proximity voice chat

192+- Enable private voice chat areas

193+

194+## Some other time

195+

196+- Use a plugin system (Monkey) to enable other apps to embed content, e.g. shared whiteboards; %radio streams; interacting with an item automatically requests a gora; link the text chat to a groups channel

197+- Item animations? (or include in Advanced Items milestone)

198+- Item inventories (allow some items to be picked up, carried, and set down elsewhere by visitors with no write access)

199+- Custom items with custom code so you can turn your turf into a full game or an economy or whatever

200+- Decentralized turfs

201+ - When you want to visit a galaxy turf that’s not turf-enabled, you instead ask one of its turf-enabled stars (if any) for its opinion on the layout of that galaxy-turf

202+ - Stars can coordinate to maintain agreement about what the fictional galaxy-turf looks like

203+ - When in a galaxy-turf, you can interact with any other people who have the same idea of what it looks like, even if they got it from a different star

204+ - The same can be done between galaxies for the notional “root turf”

205+ - The same can perhaps be done between any group of ships for some arbitrary unrooted turf

content/grants/2023/uc-concierge.mdnew file+42

@@ -0,0 +1,42 @@

1++++

2+

3+title = "Urbit Community Support Concierge"

4+date = "2023-02-03"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "The Urbit Community concierge will triage Urbit support issues that come in through the Urbit Community Group."

13+reward = "1 Star"

14+assignee = ["~sarlev-sarsen", "~ripnyt-ripnyt", "~doppeg-tonwel"]

15+champion = ["~poldec-tonteg"]

16+grant_id = "B0232"

17+completed = false

18+canceled = false

19+

20++++

21+

22+## Overview

23+

24+The Urbit Community concierge will triage Urbit support issues that come in through the Urbit Community Group. Some of these issues are routine, whereas occasionally complex issues arise that need to be escalated to the right people. Ideal candidates will also help synthesize support data to inform product feature work and documentation.

25+

26+## Responsibilities

27+

28+- Triage support issues in Urbit Community

29+- Write a weekly digest of issues addressed

30+- Attend a recurring meeting with Foundation staff

31+

32+## Qualifications

33+

34+- Helpfulness

35+- Familiarity with running urbit in a variety of environments (cloud server, laptop)

36+- Ability/interest in synthesizing support data and recommending new features or documentation

37+- Dilligence

38+- **Considering applications from contributors in Asia time zones UTC (GMT) +4 to UTC (GMT) +10 only.**

39+

40+## Compensation and Timeline

41+

42+1 Star for 3 months of work, at which time the agreement may be renewed.

content/grants/2023/update-mass.mdnew file+26

@@ -0,0 +1,26 @@

1++++

2+

3+title = "Modernize |mass"

4+date = "2023-03-02"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "Update the |mass utility to reinject the output into arvo from the runtime."

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1001"

17+completed = false

18+canceled = false

19+

20++++

21+

22+`|mass` is a utility for measuring a pier's resource usage. It is used for debugging and development. Currently, the output of this utility is a mixture of data from within arvo and from the runtime. This heterogeneity means that what is produced is not a noun but interleaved print statements to the terminal.

23+

24+Once `|mass` produces a noun, it can be sent to other ships over `%ames` for bug reports, collected in a central location or analyzed for further action by arvo.

25+

26+Update the `|mass` utility to reinject the output into arvo from the runtime.

content/grants/2023/urbit-ninja-strike-team.mdnew file+38

@@ -0,0 +1,38 @@

1++++

2+

3+title = "Urbit Ninja Strike Team"

4+date = "2023-05-16"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Other"]

9+

10+[extra]

11+image = ""

12+description = "Win a hackathon using Urbit."

13+reward = "1 star"

14+assignee = [""]

15+champion = ["~lagrev-nocfep"]

16+grant_id = "B0270"

17+completed = false

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefill_Grant+ID=B0270&prefill_Grant+Name=Urbit%20Ninja%20Strike%20Team%20Bounty"

20+

21++++

22+

23+## Overview

24+

25+Urbit is a superior development platform. Show this to the world. A team using Urbit’s ability to immediately deploy a server, identity system, and peer-to-peer communications will have an edge in programming competitions.

26+

27+To obtain this bounty, you must:

28+

29+1. Participate in a hackathon and write your submission using Urbit.

30+2. If you receive an award in the hackathon, we will award you a star for highlighting Urbit.

31+

32+Not every hackathon will qualify, so please clear it with us first at `grants@urbit.org` or in office hours. (Most competitions will qualify; we just want to avoid e.g. high school competitions or the like.)

33+

34+This bounty may be claimed multiple times by multiple teams.

35+

36+## Compensation

37+

38+1 Star

content/grants/2023/urbit-react-docs.mdnew file+124

@@ -0,0 +1,124 @@

1++++

2+

3+title = "Modernize Urbit React Developer Documentation"

4+date = "2023-02-23"

5+

6+[taxonomies]

7+grant_type = ["Proposal"]

8+grant_category = ["Documentation"]

9+

10+[extra]

11+image = ""

12+description = "Modernize Urbit React Developer Documentation"

13+reward = "1 Star"

14+assignee = ["~sidnym-ladrut"]

15+champion = ["~lagrev-nocfep"]

16+grant_id = "P0242"

17+completed = true

18+canceled = false

19+

20++++

21+

22+## Rationale ##

23+

24+

25+

26+The front-end React examples provided in Urbit's developer documentation (i.e. the ["Chat Lightning Tutorial"][ex-1] and ["App School II: Full-Stack"][ex-2] pages) use legacy, class-based React patterns that have largely been phased out over the past few years in favor of [modern, hook-based React style][re-hook]. These examples should be refactored to use this modern style to improve the developer onboarding experience (as increasing amounts of [React learning materials use hooks][re-tut]) and future-proof the material presented (as the official React documentation eventually migrates to [primarily present the modern style][re-docs]).

27+

28+

29+

30+## Overview ##

31+

32+

33+

34+The content for the Urbit React examples is split across two repositories:

35+

36+

37+

38+1. [urbit/doc-examples][git-ex]: Contains the source code for the React examples.

39+

40+2. [urbit/developers.urbit.org][git-org]: Contains the web-hosted documentation for the React examples, which can be viewed at [developers.urbit.org](developers.urbit.org).

41+

42+

43+

44+Within these repositories, the content associated with the following examples needs to be updated to the modern React style:

45+

46+

47+

48+1. ["Chat Lightning Tutorial"][ex-1]: Will require edits primarily in the source references, particularly those in the ["Additional commentary" section][ex-1-edit].

49+

50+2. ["App School II: Full-Stack"][ex-2]: Will require nearly a full rewrite, though many source references will look similar.

51+

52+

53+

54+## Features in scope ##

55+

56+

57+

58+- Refactor the ["Chat" example][git-chat-src] to replace React classes with React hooks wherever possible.

59+

60+- Refactor the ["Journal" example][git-jour-src] to replace React classes with React hooks wherever possible.

61+

62+- Revise the ["Chat Lightning Tutorial"][git-chat-doc] documentation to update source references and add commentary to any new and nontrivial references.

63+

64+- Rework the ["App School II: Full-Stack"][git-jour-doc] documentation to explain the flow and key operations (i.e. peeks, pokes, and subscriptions) of the refactored React "Journal" code.

65+

66+

67+

68+## Implementation Notes ##

69+

70+

71+

72+The refactored React examples will take architectural inspiration and library

73+

74+cues from popular React applications in the Urbit ecosystem (e.g. [`%landscape`][git-landscape] and [`%sphinx`][git-sphinx]) to further improve their utility for learning developers.

75+

76+

77+

78+## Milestones and Compensation ##

79+

80+

81+

82+The grantee will receive 1 star upon fulfillment of this grant.

83+

84+

85+

86+

87+

88+[git-ex]: https://github.com/urbit/docs-examples

89+

90+[git-org]: https://github.com/urbit/developers.urbit.org

91+

92+[git-chat-src]: https://github.com/urbit/docs-examples/blob/main/chat-app/react-frontend/src/App.jsx

93+

94+[git-chat-doc]: https://github.com/urbit/developers.urbit.org/blob/main/content/guides/quickstart/chat-guide.md

95+

96+[git-jour-src]: https://github.com/urbit/docs-examples/blob/main/journal-app/ui/src/App.js

97+

98+[git-jour-doc]: https://github.com/urbit/developers.urbit.org/blob/main/content/guides/core/app-school-full-stack/7-app-logic.md

99+

100+[git-landscape]: https://github.com/tloncorp/landscape-apps

101+

102+[git-sphinx]: https://github.com/arthyn/sphinx

103+

104+

105+

106+[re-hook]: https://reactjs.org/blog/2019/02/06/react-v16.8.0.html

107+

108+[re-tut]: https://beta.reactjs.org/learn/tutorial-tic-tac-toe

109+

110+[re-docs]: https://beta.reactjs.org/

111+

112+

113+

114+[ex-1]: https://developers.urbit.org/guides/quickstart/chat-guide

115+

116+[ex-1-edit]: https://developers.urbit.org/guides/quickstart/chat-guide#additional-commentary

117+

118+[ex-2]: https://developers.urbit.org/guides/core/app-school-full-stack/7-app-logic

119+

120+[ex-2-get]: https://developers.urbit.org/guides/core/app-school-full-stack/7-app-logic#getting-entries

121+

122+[ex-2-sub]: https://developers.urbit.org/guides/core/app-school-full-stack/7-app-logic#subscription

123+

124+[ex-2-add]: https://developers.urbit.org/guides/core/app-school-full-stack/7-app-logic#add-edit-delete

content/grants/2023/vere-eyre-cache.mdnew file+38

@@ -0,0 +1,38 @@

1++++

2+

3+title = "Vere Support for Eyre Cache"

4+date = "2023-02-23"

5+

6+[taxonomies]

7+grant_type = ["Bounty"]

8+grant_category = ["Core Dev"]

9+

10+[extra]

11+image = ""

12+description = "The second of a two-part bounty to add a cache to eyre."

13+reward = "3 stars"

14+assignee = ["~watter-parter"]

15+champion = ["~rovnys-ricfer"]

16+grant_id = "B0246"

17+completed = true

18+canceled = false

19+work_request_link = "https://airtable.com/shr4qt9t9kz7RaOIa?prefillGrant+ID=&prefillGrant+Name=Vere%20Support%20for%20Eyre%20Cache"

20+

21++++

22+

23+## Rationale

24+

25+Urbit's performance as a webserver is suboptimal, partially because the runtime does not expose a cache for GET requests. We will add a cache for GET requests that will allow inbound GET requests to avoid the Arvo event loop. This will drastically speed up the most common requests.

26+

27+This is the second of a two-part bounty. The first part, [successfully completed by ~watter-parter](https://github.com/urbit/urbit/pull/5927), added the necessary support for this feature in the Eyre vane. This part will update the Vere runtime to make use of this new affordance in Eyre. Once this bounty is completed, both PRs can be merged into the codebase and be tested for release.

28+

29+## Implementation

30+

31+The implementation of the runtime portion of this work will involve changes to the runtime to mirror the change made to Eyre in the first section. ~rovnys-ricfer will meet periodically with ~watter-parter to discuss the best course of action.

32+

33+The bounty will be successful when a cache has been successfully added and is being hit under normal usage. The test use case will be the serving of a blog or static page.

34+

35+## Compensation

36+

37+3 Stars

38+

content/grants/2023/wiki-stella-fixa-rfp.mdnew file+26

@@ -0,0 +1,26 @@

1++++

2+

3+title = "Implement a wiki on Urbit"

4+date = "2023-05-11"

5+

6+[taxonomies]

7+grant_type = ["RFP"]

8+grant_category = ["App Dev"]

9+

10+[extra]

11+image = ""

12+description = "Design and implement a wiki-like service on Urbit"

13+reward = "TBD"

14+assignee = [""]

15+champion = [""]

16+grant_id = "P1001"

17+completed = false

18+canceled = false

19+

20++++

21+

22+Urbit is a personal server, and it's a natural fit for a personal knowledge management system. It can even serve as a community knowledge management system—apps like Quorum gesture in this direction.

23+

24+A wiki-like system (but likely based on Markdown with internal references instead of Wikitext) would be a straightforward extension from existing capabilities in serving and storing pages.

25+

26+You could even imagine doing this in sync with an external interface like [Obsidian](https://obsidian.md/).

content/groups/~dalten/aera.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Quartus"

3+shortcode = "~mister-hilper-dozzod-dalten/quartus"

4+description = "Applications, Tech Support, and Community with Quartus"

5+type = "Public"

6+tile = "https://freedom-club.sfo2.digitaloceanspaces.com/rabsef-bicrym/2022.2.03..19.39.35-vertical_on_corporate_by_logaster.png"

7+participant_range = "200+"

8++++

9+

10+The Quartus public group is a place to find up to date application distribution information, get hands on tech support, and build community with other urbiters using the tools we build.

content/groups/~dibref-labter/arbit.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "arbit"

3+shortcode = "~dibref-labter/arbit"

4+type = "Public"

5+tile = "https://upload.wikimedia.org/wikipedia/commons/9/92/Johann_Melchior_Dinglinger_-_Sun_mask_with_facial_features_of_August_II_%28the_Strong%29_as_Apollo%2C_the_Sun_God_-_Google_Art_Project.jpg"

6+participant_range = "32"

7++++

8+

9+urbit argentina

content/groups/~hocwyn-tipwex/uqbar-event-horizon-forever.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Uqbar Event Horizon"

3+shortcode = "~hocwyn-tipwex/uqbar-event-horizon-forever"

4+type = "Public"

5+tile = "https://fra1.digitaloceanspaces.com/habsulbucket/habsul-rignyr/2022.12.31..08.53.06-uqbar.png"

6+participant_range = "600+"

7++++

8+

9+Uqbar Event Horizon is the place to learn about and discuss Urbit's own Ethereum zk-rollup, Uqbar.

10+

11+Uqbar are also the makers of EScape and %pokur. To learn more about Uqbar, join the Event Horizon or find us on the web at https://uqbar.network.

content/groups/~mister-hilper-dozzod-dalten/quartus.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Quartus"

3+shortcode = "~mister-hilper-dozzod-dalten/quartus"

4+description = "Applications, Tech Support, and Community with Quartus"

5+type = "Public"

6+tile = "https://freedom-club.sfo2.digitaloceanspaces.com/rabsef-bicrym/2022.2.03..19.39.35-vertical_on_corporate_by_logaster.png"

7+participant_range = "200+"

8++++

9+

10+The Quartus public group is a place to find up to date application distribution information, get hands on tech support, and build community with other urbiters using the tools we build.

content/groups/~nibset-napwyn/tlon-public.md+1−1

@@ -1,6 +1,6 @@

1+++

2title = "Tlon Public"

3−shortcode = "~nibset-napwyn/tlon-public"

3+shortcode = "~nibset-napwyn/tlon"

4description = "Updates, announcements, and broadcasts from Tlon."

5type = "Public"

6tile = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/tlon.png"

content/groups/~rondev/group-discovery.mddeleted−10

@@ -1,10 +0,0 @@

1−+++

2−title = "Group Discovery"

3−shortcode = "~rondev/group-discovery"

4−description = "A group for finding other groups"

5−type = "Public"

6−tile = "https://urbit.me/images/icons/icon-512x512.png"

7−participant_range = "1000+"

8−+++

9−

10−A group for finding other groups

content/groups/~wolref-podlex/foundation.mddeleted−10

@@ -1,10 +0,0 @@

1−+++

2−title = "Foundation"

3−shortcode = "~wolref-podlex/foundation"

4−description = "Town Square for the Urbit Foundation"

5−type = "Public"

6−tile = "https://interstellar.nyc3.digitaloceanspaces.com/battus-datsun/2022.6.10..21.28.21-urbit-inverted.png"

7−participant_range = "1000+"

8−+++

9−

10−The best place to get in touch with the team at the Urbit Foundation.

content/highlights/highlight-1.mdnew file+6

@@ -0,0 +1,6 @@

1++++

2+title = "Using Urbit in 2023"

3+url ="https://urbit.org/blog/using-urbit-in-2023"

4+image = "https://storage.googleapis.com/media.urbit.org/blog/usingurbit-2023.jpg"

5+description = "There are more ways to run Urbit than ever, and more options coming soon."

6++++

content/highlights/highlight-2.mdnew file+6

@@ -0,0 +1,6 @@

1++++

2+title = "The Roadmap"

3+image = "https://storage.googleapis.com/media.urbit.org/site/featured/roadmap-icon.jpg"

4+url="https://roadmap.urbit.org/"

5+description = "Explore the technical plan for making Urbit ready for mass adoption."

6++++

content/highlights/highlight-3.mdnew file+6

@@ -0,0 +1,6 @@

1++++

2+title = "Hoon School Live Summer '23"

3+image = "https://storage.googleapis.com/media.urbit.org/site/featured/hsl-june-2023.png"

4+url="https://developers.urbit.org/courses/hsl"

5+description = "Sign up now to learn the foundations of Urbit development."

6++++

content/ids/bintud-bitnev.mdnew file+8

@@ -0,0 +1,8 @@

1++++

2+ship = "~bintud-bitnev"

3+nickname = ""

4+bgColor = "#008080"

5+image = ""

6++++

7+

8+feelsgood.jpg

content/ids/botbyn-dolrum.mdnew file+7

@@ -0,0 +1,7 @@

1++++

2+ship = "~botbyn-dolrum"

3+nickname = ""

4+bgColor = "#000000"

5+image = ""

6++++

7+

content/ids/datryn-ribdun.mdnew file+12

@@ -0,0 +1,12 @@

1++++

2+ship = "~datryn-ribdun"

3+nickname = ""

4+bgColor = "#f0aa33"

5+image = ""

6++++

7+

8+Developer, explorer, Urbit-fanboy

9+

10+See my work on github, or message me on the network. I'm also addicted to Trill, so follow me there.

11+

12+[https://github.com/datryn-ribdun/](https://github.com/datryn-ribdun/)

content/ids/datsyr-radser.mdnew file+12

@@ -0,0 +1,12 @@

1++++

2+ship = "~datsyr-radser"

3+nickname = "Urbit Guide"

4+bgColor = "#000000"

5+image = "https://urbitguide.com/wp-content/uploads/2023/03/Urbit-Guide-website.jpg"

6++++

7+

8+Urbit Guide offers clear explanations of what Urbit is and how it works, without any technical jargon that might confuse or overwhelm newcomers. Whether you're interested in exploring the decentralized web or just want to learn more about this innovative platform, Urbit Guide has everything you need to get started. Check out today and start your Urbit journey with confidence.

9+

10+Website: https://urbitguide.com/

11+

12+Twitter: https://twitter.com/urbitguide

content/ids/dopbet-larped.mdnew file+7

@@ -0,0 +1,7 @@

1++++

2+ship = "~dopbet-larped"

3+nickname = ""

4+bgColor = "#000000"

5+image = ""

6++++

7+

content/ids/finmep-lanteb.md+15−3

@@ -5,7 +5,18 @@ bgColor = "#0dd33f"

5image = ""

6+++

7

8−The infamous hacker known as Urbit

8+**THE INFAMOUS HACKER KNOWN AS URBIT**

9+

10+General Manager of the Urbit hockey team

11+

12+Tlön employee

13+

14+Urbit Chess Ecosystem:

15+https://github.com/thecommons-urbit/chess

16+

17+Hoon Language Plugin for IntelliJ IDEA:

18+https://plugins.jetbrains.com/plugin/19294-hoon-language

19+https://github.com/ashelkovnykov/idea-hoon-plugin

9

20

10Urbit FAQ:

21Urbit FAQ:

11https://github.com/ashelkovnykov/urbit-faq

22https://github.com/ashelkovnykov/urbit-faq

@@ -13,5 +24,6 @@ https://github.com/ashelkovnykov/urbit-faq

13Urbit Hosting:

24Urbit Hosting:

14https://github.com/ashelkovnykov/urbit-hosting

25https://github.com/ashelkovnykov/urbit-hosting

15

26

16−Urbit Wordlists:

27+Urbit Wordlists (used by Gonetia):

17−https://github.com/ashelkovnykov/urbit-wordlists

28+https://github.com/ashelkovnykov/urbit-wordlists

29+https://github.com/tomholford/gonetia

content/ids/haddef-sigwen.md+4−2

@@ -5,6 +5,8 @@ bgColor = "#dcedce"

5image = "https://s3.us-east-1.amazonaws.com/haddefsigwen1/haddef-sigwen/2021.2.24..20.22.37-bw400.png"

6+++

7

8−Tlon Corporation (2019-2021), Urbit Foundation (2022-)

8+[Tlon Corporation](https://tlon.io) (2019-2021), [Reciprocal Ltd.](https://reciprocal.ltd) (2022-)

9

10−Lawful neutral, interactive media artist, mercenary for hire. [Decept.org](https://decept.org) proprietor. More projects at [my website](https://matildepark.ca).

10+Lawful neutral, "computational creative", all-purpose gynoid. [Decept.org](https://decept.org) proprietor.

11+

12+Previous interactive and creative projects at [my website](https://matildepark.ca).

content/ids/hocmed-lidrev.mdnew file+8

@@ -0,0 +1,8 @@

1++++

2+ship = "~hocmed-lidrev"

3+nickname = ""

4+bgColor = "#4E9EFD"

5+image = ""

6++++

7+

8+Software Developer

content/ids/monnys-riphet.mdnew file+7

@@ -0,0 +1,7 @@

1++++

2+ship = "~monnys-riphet"

3+nickname = "yy"

4+bgColor = "#000000"

5+image = ""

6++++

7+

content/ids/sarlev-sarsen.md+2−2

@@ -2,7 +2,7 @@

2ship = "~sarlev-sarsen"

3nickname = ""

4bgColor = "#ffffff"

5−image = ""

5+image = "https://sarlev-sarsen.sfo3.digitaloceanspaces.com/sarlev-sarsen/2022.12.15..03.13.58-roof%20koreans%20voting.jpg"

6+++

7

8−liberty, growth, crypto, hijinks, innovation, agency. allocating capital via grants from the urbit foundation.

8+liberty, growth, crypto, hijinks, innovation, agency.

content/ids/tambes-palped.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+ship = "~tambes-palped"

3+nickname = "Hackalife"

4+bgColor = "#000000"

5+image = ""

6++++

7+

8+Ali Hackalife.

9+Based in Germany.

10+23, Artist, Developer, Wikipedia Editor.

content/ids/tobrun-tomnet.mdnew file+8

@@ -0,0 +1,8 @@

1++++

2+ship = "~tobrun-tomnet"

3+nickname = "somkirann"

4+bgColor = "#000000"

5+image = ""

6++++

7+

8+1st page being set-up

content/ids/topfet-parmed.mdnew file+6

@@ -0,0 +1,6 @@

1++++

2+ship = "~topfet-parmed"

3+nickname = ""

4+bgColor = "#000000"

5+image = ""

6++++

content/organizations/assemblycapital.md+1

@@ -3,6 +3,7 @@ title = "Assembly Capital"

3description = "engineer-led early stage vc investing in things that matter, mostly urbit"

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/assemblycapital.jpg"

5URL = "https://assembly.capital"

6+twitter = "assemblycap"

6ships = ["~nodmyn-dosrux"]

7ships = ["~nodmyn-dosrux"]

7+++

8+++

8

9

content/organizations/dalten.md+1

@@ -3,6 +3,7 @@ title = "Dalten Collective"

3description = "Dalten is a distributed fellowship of like minded individuals."

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/dalten.jpg"

5URL = "https://dalten.org"

6+twitter = "_dalten"

6ships = ["~dalten", "~mirler-dozzod-talwet"]

7ships = ["~dalten", "~mirler-dozzod-talwet"]

7+++

8+++

8

9

content/organizations/holium.md+3−2

@@ -1,9 +1,10 @@

1+++

2title = "Holium"

3description = "Holium's mission is to enable the networked state."

4−image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/holium.png"

4+image = "https://media.urbit.org/site/ecosystem/organizations/holium-logo.jpg"

5URL = "https://holium.com"

6+twitter = "HoliumCorp"

6−ships = ["~livdel-binmun-lomder-librun", "~lomder-librun"]

7+ships = ["~livdel-binmun-lomder-librun", "~lomder-librun", "~hostyv"]

7+++

8+++

8

9

9Holium's mission is to enable the networked state, starting by enabling DAOs, building digitally sovereign colonies, and then making them physically sovereign. Are you ready to build your world?

10Holium's mission is to enable the networked state, starting by enabling DAOs, building digitally sovereign colonies, and then making them physically sovereign. Are you ready to build your world?

content/organizations/labyrinthdao.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Labyrinth DAO"

3+description = "Labyrinth DAO is a new decentralized autonomous organization investing in Urbit projects."

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/labyrinth.jpeg"

5+URL = "https://labyrinthdao.io/"

6+ships = []

7+twitter = "labyrinth_dao"

8++++

9+

10+Labyrinth DAO is a new decentralized autonomous organization investing in Urbit projects. Supported by [Tribute Labs](https://tributelabs.xyz/), Labyrinth DAO will foster the growth and development of Urbit as it paves the way for the new internet. Find Labyrinth DAO on Twitter or connect at labyrinthdao.io to get involved.

content/organizations/mars-review-of-books.md+1

@@ -3,6 +3,7 @@ title = "The Mars Review of Books"

3description = "The Mars Review of Books is a magazine in print and on Urbit which combines ruthlessly intelligent and fearless sense-making on subjects of global importance with today’s most stylish belletristic writing on contemporary arts and culture."

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/marsreview.jpg"

5URL = "https://store.marsreview.org"

6+twitter = "marsreviewer"

6ships = []

7ships = []

7+++

8+++

8

9

content/organizations/nativeplanet.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Native Planet"

3+description = "Native Planet builds Urbit-centric hardware and software that simplifies sovereign self hosting and ship management."

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/nativeplanet2.png"

5+URL = "https://www.nativeplanet.io/"

6+twitter = "NativePlanetIO"

7+ships = []

8++++

9+

10+Native Planet builds Urbit centric hardware and software that simplifies sovereign self hosting and ship management. Native Planet's open source software enables users to turn nearly any computer into an Urbit dedicated server in minutes.

content/organizations/quartus.md+4−3

@@ -3,7 +3,8 @@ title = "Quartus by Dalten"

3description = "We build software using the novel affordances of Urbit."

4image = "https://freedom-club.sfo2.digitaloceanspaces.com/ab_Quartus-03.jpg"

5URL = "https://www.quartus.co/"

6−ships = ["~mister-dozzod-dalten", "~laddys-dozzod-dalten", "~magped-magped-rabsef-bicrym", "~doller-doller-rabsef-bicrym"]

6+ships = ["~mister-hilper-dozzod-dalten", "~dister-dozzod-dalten"]

7+twitter = "QuartusCo"

7+++

8+++

8

9

9### Quartus is Fulfilling Urbit's Covenant with Users

10### Quartus is Fulfilling Urbit's Covenant with Users

@@ -16,6 +17,6 @@ We build software, according to specification, on a contract basis. Contact one

16

17

17### Quartus is

18### Quartus is

18

19

19−Headed by [~rabsef-bicrym](https://urbit.org/ids/~rabsef-bicrym), with Chief Products Officer [~sogrum-savluc](https://urbit.org/ids/~sogrum-savluc) and Chief Technical Officer [~wicrum-wicrun](https://urbit.org/ids/~wicrum-wicrun).

20+Headed by [~rabsef-bicrym](https://urbit.org/ids/~rabsef-bicrym), with Chief Product Officer [~sogrum-savluc](https://urbit.org/ids/~sogrum-savluc), and Chief Technical Officer [~wicrum-wicrun](https://urbit.org/ids/~wicrum-wicrun), along with [~sarlev-sarsen](https://urbit.org/ids/~sarlev-sarsen) and [~simfur-ritwed](https://urbit.org/ids/~simfur-ritwed).

20

21

21−Founded by [~sicdev-pilnup](https://urbit.org/ids/~sicdev-pilnup) and ~rabsef-bicrym, as a product of the [Dalten Collective](https://dalten.org/).

22+Founded by [~sicdev-pilnup](https://urbit.org/ids/~sicdev-pilnup) and [~rabsef-bicrym](https://urbit.org/ids/~rabsef-bicrym), as a product of the [Dalten Collective](https://dalten.org/).

content/organizations/sortug.md+1

@@ -4,6 +4,7 @@ description = "Sortug is an Urbit development DAO based on Earth Time UTC+08:00.

4image = "https://s3.urbit.cloud/sortug/logo.png"

5URL = "https://sortug.com"

6ships = ["~sortug", "~polwex", "~sonwet", "~dovwex", "~sovwex", "~ticrel", "~nodwet"]

7+twitter = "SortugDev"

7+++

8+++

8

9

9Sortug is a DAO focused on software development and promotion of Urbit to a global audience. We are focused on creating and distributing Urbit applications and on integrating Urbit in Earth business and communities through innovative gatekeeping ideas.

10Sortug is a DAO focused on software development and promotion of Urbit to a global audience. We are focused on creating and distributing Urbit applications and on integrating Urbit in Earth business and communities through innovative gatekeeping ideas.

content/organizations/third-earth.md+1

@@ -4,6 +4,7 @@ description = "Third.Earth is an Urbit hosting and development company focused o

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/thirdearth.png"

5URL = "https://third.earth"

6ships = ["~botwet"]

7+twitter = "ThirdEarth3"

7+++

8+++

8

9

9Third.Earth is an Urbit hosting and development company focused on bridging Web2 capabilities to the Urbit ecosystem. We currently assist Urbit startups with their hosting needs with our fully automated platform integrated seamlessly with their current UI/UX and workflow. By utilizing the latest in cloud technology, we help bring Urbit to the masses.

10Third.Earth is an Urbit hosting and development company focused on bridging Web2 capabilities to the Urbit ecosystem. We currently assist Urbit startups with their hosting needs with our fully automated platform integrated seamlessly with their current UI/UX and workflow. By utilizing the latest in cloud technology, we help bring Urbit to the masses.

content/organizations/tirrel.md+1

@@ -4,6 +4,7 @@ description = "Tirrel Corporation is an Urbit product studio."

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/Tirrel%20Corp%20Logo.png"

5URL = "https://tirrel.io"

6ships = ["~tirrel"]

7+twitter = "tirrelcorp"

7+++

8+++

8

9

9### Tirrel Corporation is an Urbit product studio.

10### Tirrel Corporation is an Urbit product studio.

content/organizations/tlon.md+2−1

@@ -3,7 +3,8 @@ title = "Tlon"

3description = "The first developer of Urbit. Their work continues to maintain core infrastructure development in addition to designing products for communities on the network."

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/tlon.png"

5URL = "https://tlon.io"

6−ships = ["~mister-dister-dozzod-dozzod", "~lander-dister-dozzod-dozzod"]

6+ships = ["~mister-dister-dozzod-dozzod", "~lander-dister-dozzod-dozzod", "~sogryp-dister-dozzod-dozzod"]

7+twitter = "tloncorporation"

7+++

8+++

8

9

9[Tlon Corporation](https://tlon.io) is the first developer of Urbit, and their work continues to maintain core infrastructure development in addition to designing products for communities on the network. Tlon’s primary products are Hosting, cloud storage for your urbit, Landscape, an operating system and interface, and Groups, a communication suite.

10[Tlon Corporation](https://tlon.io) is the first developer of Urbit, and their work continues to maintain core infrastructure development in addition to designing products for communities on the network. Tlon’s primary products are Hosting, cloud storage for your urbit, Landscape, an operating system and interface, and Groups, a communication suite.

content/organizations/uqbar.md+1

@@ -4,6 +4,7 @@ description = "Uqbar is a one-stop coding environment that makes writing and dep

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/uqbar.png"

5URL = "https://uqbar.network"

6ships = ["~fabnev-hinmur", "~dister-dozzod-bacdun", "~hocwyn-tipwex"]

7+twitter = "uqbarnetwork"

7+++

8+++

8

9

9Uqbar is a one-stop coding environment that makes writing and deploying smart contracts simple, efficient, and secure.

10Uqbar is a one-stop coding environment that makes writing and deploying smart contracts simple, efficient, and secure.

content/organizations/urbit-foundation.md+1

@@ -4,6 +4,7 @@ description = "Urbit Foundation is a non-profit organization whose mission is to

4image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/urbit-foundation.png"

5URL = "https://urbit.org"

6ships = ["~lapdeg"]

7+twitter = "urbitfoundation"

7+++

8+++

8

9

9Urbit Foundation is a non-profit organization whose mission is to ensure Urbit's success as a technology.

10Urbit Foundation is a non-profit organization whose mission is to ensure Urbit's success as a technology.

content/organizations/zorp.mdnew file+10

@@ -0,0 +1,10 @@

1++++

2+title = "Zorp"

3+description = "We assure critical computation using zero-knowledge proofs"

4+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/organizations/zorp.jpeg"

5+URL = "https://zorp.io/"

6+twitter = "ZorpZK"

7+ships = []

8++++

9+

10+Zorp has built a secure-by-design zero-knowledge virtual machine (zkVM) with a uniquely minimal software supply chain which utilizes Nock as its instruction set. Nock, Urbit’s low-level language, is a famously simple instruction set. That property aligns itself well with what you might create if you were designing a language from first principles to do zero-knowledge proofs. Zorp’s zkVM could unlock new possibilities for crypto and more. Check back at Zorp’s website and Twitter for more info.

content/overview/people-history.md+36−31

@@ -8,61 +8,66 @@ image = "https://media.urbit.org/site/understanding-urbit/project-history/projec

8

9So who builds this thing? Where does it come from? What’s the history?

10

11−Today, Urbit is built and maintained by three organizations, a community of contributors and core developers, infrastructure (star) operators, and governance (galaxy) node owners.

11+Urbit is an open-source project that anyone can work on. The Urbit Foundation, a non-profit organization, is charged with shepherding the network toward a successful future. [Tlon](https://tlon.io/) was the first private company founded for the purposes of working on Urbit, back in 2013. Now there are several more.

12+

13+These include [Uqbar](https://uqbar.network/), [Holium](https://www.holium.com/), [Tirrel](https://tirrel.io/), [Native Planet](https://nativeplanet.io/), and others. Beyond that, an ecosystem has sprung up around Urbit that includes [funds](https://assembly.capital/), [DAOs](https://labyrinthdao.io/), and [publications](https://marsreview.org/). And of course there are many community contributors, many of whom have received [grants](https://urbit.org/grants) from the Urbit Foundation.

12

14

13Let’s talk first about these individual groups within the Urbit community, then about the history of the project and how it came to be.

15Let’s talk first about these individual groups within the Urbit community, then about the history of the project and how it came to be.

14

16

15Organizations {% .font-bold .subpixel-antialiased .pt-8 %}

17Organizations {% .font-bold .subpixel-antialiased .pt-8 %}

16

18

17−There are currently three principal organizations involved in Urbit’s development and maintenance: Tlon, Urbit.live and the Urbit Foundation.

19+The Urbit Foundation was formally established in 2021 when it split off from Tlon. The Foundation runs the grants program, maintains [urbit.org](https://urbit.org/), the [network explorer](https://network.urbit.org/), [education](https://developers.urbit.org/courses/hsl), and it organizes Urbit events like [Assembly](https://assembly.urbit.org/). Recently, the Urbit Foundation has also taken the lead on Urbit's [core development](https://roadmap.urbit.org/).

18

20

19−Tlon has been around since 2013 or so, and is primarily focussed on the development of Urbit OS and its user experience. Urbit.live was started in 2018 to make the on ramp into Urbit as easy as possible. Both companies contribute regularly to the code base.

21+[Tlon Corporation](https://tlon.io/) was founded in 2013 to bootstrap Urbit. Currently it is building a hosting service and a suite of Urbit applications, including [Groups](/applications/~sogryp-dister-dozzod-dozzod/groups), [Talk](/applications/~sogryp-dister-dozzod-dozzod/talk), and Small Talk.

20

22

21−Tlon was originally granted about half of the Urbit ID address space, and has used that to fund its operations so far. Over time, Tlon plans to offer hosting and services to make using Urbit as easy as possible.

23+[Tirrel Corporation](https://tirrel.io/) was founded in 2021, it creates tools for creators to build their communities, share content, and make money. most notably the subscription application [Studio](https://urbit.studio/). They also produce the Urbit desktop environment Scene.

22

24

23−Urbit.live started selling Urbit IDs very early once that became possible, and also plans to offer services within the Urbit ecosystem.

25+[Uqbar](http://uqbar.network), founded in 2022, is working on an L2 blockchain on Urbit. Uqbar uses Urbit’s native language, Hoon, for its smart contracts, enabling developers to write smart contracts and decentralized off-chain applications that utilize them all in one language and stack. They have also produced the Urbit apps Pongo, Pokur, and [Blog](/applications/~hanrut-sillet-dachus-tiprel/blog).

24

26

25−The Urbit Foundation was formally established in 2021. The Foundation runs the grants program, maintains urbit.org, the network explorer, and organizes Urbit events like Assembly.

27+[Holium](http://holium.com), founded in 2022, builds Realm. An Urbit-backed desktop (and soon mobile) environment focused on collaborative computing. Realm allows you to create Spaces in which a group of people interact with the same applications, e.g. shared dictionary, meme library, group chat, voice chats, shared cursors, code editors, web browser.

26

28

27−The community of contributors and core developers has been steadily contributing to the code base since before Tlon existed, and they’re still going strong. They can primarily be found on Urbit itself, in the Urbit Community ([~bitbet-bolbel/urbit-community](/groups/~bitbet-bolbel/urbit-community)), the urbit-dev mailing list and on GitHub.

29+[Quartus](http://quartus.co/), founded in 2022, provides custom tooling stacks for Urbit companies. They produce applications such as [Keep](/applications/~dister-dozzod-dalten/keep), a recovery tool for Urbit computers and Urdl, an Urbit version of the popular Wordl game.

28

30

29−Timeline {% .font-bold .subpixel-antialiased .pt-8 %}

31+[Zorp](http://zorp.io), founded in 2022, works on Zero Knowledge proofs of Nock.

30

32

31−At the beginning, Urbit was just a few people with the right combination of imagination and discipline to try to rebuild computing.

33+The community of contributors and core developers has been steadily contributing to the code base since before the Urbit Foundation existed, and they're still going strong. They can primarily be found on Urbit itself, in the Urbit Community group [~bitbet-bolbel/urbit-community](/groups/~bitbet-bolbel/urbit-community), the [urbit-dev](https://groups.google.com/a/urbit.org/g/dev?pli=1) mailing list and on [GitHub](https://github.com/urbit). See also The Urbit Foundation's public group at [~halbex-palheb/uf-public](/groups/~halbex-palheb/uf-public).

32

34

33−**2002**

35+Timeline {% .font-bold .subpixel-antialiased .pt-8 %}

34−Urbit starts as an open-ended personal project. An “independent study PhD” to reinvent computing for a network-centric world.

35

36

36−**2008**

37+In the beginning, Urbit was just a few people with the right combination of imagination and discipline to try to rebuild computing.

37−Nock, the foundation of Urbit, works. Coming in at 32 lines of code, that’s 1 line of code every two months.

38

39−**2012**

39+**2022**

40−Hoon, Urbit’s programming language, compiles itself to Nock. Writing Hoon is much easier than writing Nock.

40+The Urbit Foundation's split from Tlon becomes complete, and the Foundation organizes [Urbit NYC](https://urbit.org/groups/~ladtem-filmyr/urbit-ny-week) and [Assembly 2022](https://assembly.urbit.org/) in Miami while launching a highly successful education project, new developer documentation and many other things. Read the Foundation's full annual report [here](https://storage.googleapis.com/media.urbit.org/site/overview/~2023%20Retrospective%20%26%20Plan%20PUBLIC.pdf). New Urbit companies Uqbar, Holium, Quartus, and Zorp are formed.

41

42−**2013**

42+**2021**

43−Arvo, Urbit’s OS kernel, boots and the first live Urbit network is started with a command-line chat.

43+Tlon hosts the first Urbit Assembly and the Urbit Foundation is formally organized.

44

45−**2014**

45+**2019**

46−Tlon is founded to help support Urbit development (and is < 8 people for the next four years).

46+Tlon spends the year stabilizing Arvo and building Landscape.

47

48−**2015**

48+**2018**

49−Urbit has its first web interface and serves its own website.

49+Tlon sells about 8% of its stake in the network to accelerate Urbit development.

50+

51+**2017**

52+Urbit’s test network runs for ten months without a reboot. Tlon's private sale of address space, shared only with its mailing list, sells out in six hours — limit two per person.

50

53

51**2016**

54**2016**

52The first sale of Urbit address space sells out in four hours.

55The first sale of Urbit address space sells out in four hours.

53

56

54−**2017**

57+**2015**

55−Our test network runs for ten months without a reboot.

58+Urbit has its first web interface and serves its own website.

56

59

57−Our private sale, shared only with our mailing list, sells out in six hours — limit two per person.

60+**2014**

61+Tlon is founded to help support Urbit development (and is < 8 people for the next four years).

58

62

59−**2018**

63+**2013**

60−Tlon sells about 8% of its stake in the network to accelerate Urbit development. urbit.live gets going and starts selling Urbit IDs to the public.

64+Arvo, Urbit’s OS kernel, boots and the first live Urbit network is started with a command-line chat.

61

65

62−**2019**

66+**2012**

63−Tlon spends the year stabilizing Arvo and building Landscape.

67+Hoon, Urbit’s programming language, compiles itself to Nock. Writing Hoon is much easier than writing Nock.

64

68

65−**2021**

69+**2008**

66−Tlon hosts the first Urbit Assembly and the Urbit Foundation is formally organized.

70+Nock, the foundation of Urbit, works. Coming in at 32 lines of code, that’s 1 line of code every two months.

67

71

68−Building Urbit is about building a future where technology doesn’t control us. Instead, we look forward to a future where technology is simpler, more reliable and less invasive.

72+**2002**

73+Urbit starts as an open-ended personal project. An “independent study PhD” to reinvent computing for a network-centric world.

content/podcasts/2022-10-06_urbit-maxi-episode.md → content/podcasts/2022-10-06_urbit-maxi-episode copy.mdrenamed

The content is the same.

content/podcasts/2022-12-22_epicenter-ted-blackman-gary-lieberman.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Gary Lieberman & Ted Blackman: Urbit – Decentralized Computing Platforms"

3+podcast = "Epicenter"

4+date = "2022-12-22"

5+URL = "https://www.youtube.com/watch?v=Jd1qxbNHAmE&t=1s"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/epicenter.jpg"

7++++

8+

9+When discussing the widespread adoption of true, peer-to-peer decentralization, one could easily identify various social and political obstacles. However, there is also an often overlooked technological impairment as the underlying architecture of computer networks was not designed to achieve global-scale decentralization. Ideally a complete restructuring would be necessary, from applications and programming language, to as profound as rewriting operating system kernels. This is what Urbit is trying to achieve; a decentralized network where users have full control over their computer, running a unified operating system, where applications function seamlessly, without centralized chokepoints.

10+

11+We were joined by Ted Blackman, CTO of Urbit Foundation, and Gary Lieberman, the Chorus One Team Lead for Urbit, to discuss how Urbit reshapes the way we interact with computers, its current development stage, and what challenges it has to overcome.

content/podcasts/2023-01-05_lets-get-personal.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E21 - Let's Get Personal...AI feat. (Owen Barnes)"

3+podcast = "The Network Age"

4+date = "2023-01-05"

5+URL = "https://rss.com/podcasts/thenetworkage/767653/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys are joined by blockchain entrepreneur and decentralization advocate Owen Barnes (~locruc-fonmec) to discuss the rise of personal artificial intelligence tools, the importance of user interface, and how to design a new internet from the ground up. Then, they explore how new AI platforms (such as Chat GPT and Codex) can empower programmers, whether AI will protect (or exploit) personal data, and the role of crypto in curation of AI content. All this plus digital reincarnation of departed loved ones, algorithmic broadway musicals, and sign placement on the London Underground.

content/podcasts/2023-01-19_crypto-metaphysics.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E22 - Crypto Metaphysics feat. Grant Hummer and Matt Liston"

3+podcast = "The Network Age"

4+date = "2023-01-19"

5+URL = "https://rss.com/podcasts/thenetworkage/786206/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+In this extra special episode, the boys are joined by Grant Hummer and Matt Liston, two of Ethereum's most original gangsters, to discuss the blockchain's complicated past, its mistakes and pitfalls, and what the future might hold for our favorite L1. Matt, a cofounder of Augur and Gnosis, previously worked for the Ethereum foundation, while Grant founded San Francisco's oldest Ethereum developer meetup. Assisted by your handsome co-hosts, our guests also explore the future of blockchain on Urbit, the pitfalls of inadequate leadership, startup pessimism, how to found a crypto religion, and the metaphysical ecstasy of blockchain contemplation. This is an episode you won't want to miss.

content/podcasts/2023-01-24_reject-triviality.mdnew file+13

@@ -0,0 +1,13 @@

1++++

2+title = "What does it mean to reject and transcend triviality?"

3+podcast = "Crazy Wisdom"

4+date = "2023-01-24"

5+URL = "https://podcasts.apple.com/us/podcast/what-does-it-mean-to-reject-and-transcend-triviality/id1354589767?i=1000597317474"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/crazywisdom.jpg"

7++++

8+

9+An interview with Trent Gillham, Founder of Holium.

10+

11+Urbit: [~lomder-librun](/ids/~lomder-librun)

12+

13+Twitter: [@AidenSolaran](https://twitter.com/AidenSolaran)

content/podcasts/2023-01-26_building-future-states-with-nation3.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E23 - Building Future States with Nation3 (feat. Luis Cuende and Anastasiya Belyaeva)"

3+podcast = "The Network Age"

4+date = "2023-01-26"

5+URL = "https://rss.com/podcasts/thenetworkage/795280/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys are joined by Luis Cuende and Anastasiya Belyaeva of Nation3, the world's first internet-native jurisdiction and "cloud nation." Luis (cofounder of Aragon) and Anastasiya discuss their network state optimism, how DAOs and smart contracts will shape a digital court system, and the benefits of becoming a Nation3 citizen. Then, they dive into capital formation in special economic zones, how digital states can support values-driven community, and the relative value of patriotism.

content/podcasts/2023-01-29_urbit-for-idiots.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Urbit for Idiots | Galen Wolfe-Pauly, Tlon Corporation"

3+podcast = "Boys Club"

4+date = "2023-01-29"

5+URL = "https://podcasts.apple.com/us/podcast/urbit-for-idiots-galen-wolfe-pauly-tlon-corporation/id1616327892?i=1000597057523"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/boysclub.jpg"

7++++

8+

9+Galen Wolfe-Pauly joins the pod to talk about Urbit, a decentralized personal server platform. They talk about what Urbit is, and why owning your own 'space' on the internet is valuable. Galen answers a bunch of questions like, is Urbit a computer? Can you send an email on Urbit? How will Urbit ever get users? This podcast is perfect for Urbit beginners.

10+

11+Draft tweets close out the episode. Feelings check-in to return on the next pod.

content/podcasts/2023-02-09_crypto-narratives-new-and-old.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E24 - Crypto Narratives, New and Old (feat. CoinDesk Reporters Marc Hochstein and Tracy Wang)"

3+podcast = "The Network Age"

4+date = "2023-02-09"

5+URL = "https://rss.com/podcasts/thenetworkage/818546/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys are joined by esteemed CoinDesk reporters Marc Hochstein (~fodrex-malmev) and Tracy Wang to discuss the major crypto narratives of 2022. In particular, they dive into FTX (covered in-depth by Tracy for CoinDesk) and its implications for the coming year, as well as the general craziness of crypto reporting and the importance of being "long volatility." Then, the crew looks to 2023 to consider federal crypto regulation, the rise of zero-knowledge rollups, and protocol-level advances for Ethereum. All this plus polycules, Urbit, and buying Bitcoin in person from a man in the park.

content/podcasts/2023-02-13_distributed-networked-computing.mdnew file+17

@@ -0,0 +1,17 @@

1++++

2+title = "What are the use cases for distributed networked computing instead of centralized systems?"

3+podcast = "Crazy Wisdom"

4+date = "2023-02-13"

5+URL = "https://crazywisdom.libsyn.com/what-are-the-use-cases-for-distributed-networked-computing-instead-of-centralized-systems-eric-helal"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/crazywisdom.jpg"

7++++

8+

9+Eric Helal Founder of Quartus a Dev shop for Urbit Apps

10+

11+~rabsef-bicrym on Urbit

12+

13+https://twitter.com/SafePen

14+

15+~dalten/new-aera

16+

17+https://twitter.com/_dalten

content/podcasts/2023-02-23_the-urbit-episode.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E25 - The Urbit Episode (feat. Sam Frank)"

3+podcast = "The Network Age"

4+date = "2023-02-23"

5+URL = "https://rss.com/podcasts/thenetworkage/837778/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys (sans ~timluc) are joined by Sam Frank (~todset-partug) of the Urbit Foundation to discuss his defection from the New York literary scene to the frontiers of distributed technology. As an early investor to both Ethereum and Urbit, Sam has witnessed how digital-first communities can organize around shared values and the pursuit of knowledge. Together, Sam and our hosts dive into the future of Urbit, the wild world of Miladies, and Sam's own journey as a writer and esoteric explorer. All this plus Urbit marriages, psychic abilities, and the importance of throwing a really good party.

content/podcasts/2023-03-09_reclaiming-web-1.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E26 - Reclaiming Web 1 (feat. ~dachus-tiprel)"

3+podcast = "The Network Age"

4+date = "2023-03-09"

5+URL = "https://rss.com/podcasts/thenetworkage/858056/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys are joined by Uqbar developer, Urbit explorer, and Network Age frontiersman ~dachus-tiprel to discuss the joys of peer-to-peer programming with a Web 1 aesthetic. We also touch on a few of ~dachus' recent projects, including %blog, a p2p publishing platform you can host from your own server, and %pyro, a testing script that has transformed into one of Urbit's most promising methods for low-cost hosting. All this plus "exiting", the instantiation of an IRL Party DAO, and whether programmers are more like artists or plumbers. Don't miss it.

content/podcasts/2023-03-23_how-to-invest-in-web3-like-a-cool-kid.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E27 - How to Invest in Web3 Like a Cool Kid (feat. Shad)"

3+podcast = "The Network Age"

4+date = "2023-03-23"

5+URL = "https://rss.com/podcasts/thenetworkage/878369/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys are joined by Shad (~narpel-machul), the GP of Giga Corp, a crypto marketing and investment firm, to discuss liquid lobbying (using capital allocation to direct the positive development of public goods in Web3), blockchain conferences, and how to tell a real DAO from a fake one. The squad also dives deep on Urbit culture, the untapped potential of being cool in crypto, and the accelerating fusion of lifestyle with technology. All this plus diarrhea, fighting on a volcano, crypto breakfasts in Kyiv, and frontier favelas. Don't miss it.

content/podcasts/2023-03-28_pupusas-volcanoes-and-databases.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "Pupusas, Volcanoes and Databases with ~hodzod-walrus"

3+podcast = "ZeroK - UF"

4+date = "2023-03-28"

5+URL = "https://www.youtube.com/watch?v=W7oMxY39tl8"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/ZeroK-logo.png"

7++++

8+

9+In this inaugural episode, ~poldec-tonteg and ~roslet-tanner recap the Urbit Volcano Summit, new Hoon School and App School classes, growth metrics for Urbit and the news that, finally, you can fit at least one movie from the Shrek franchise in your Urbit. Enjoy!

content/podcasts/2023-04-03_legacy-internet-new-internet.mdnew file+15

@@ -0,0 +1,15 @@

1++++

2+title = "Legacy internet vs New Internet?"

3+podcast = "Crazy Wisdom"

4+date = "2023-04-03"

5+URL = "https://crazywisdom.libsyn.com/legacy-internet-vs-new-internet-aj-lamarc"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/crazywisdom.jpg"

7++++

8+

9+AJ is a software engineer interested in Urbit and data composability.

10+

11+Twitter: https://twitter.com/ajlamarc

12+

13+https://www.ajlamarc.com/

14+

15+Keep an eye out on Holium, and making it easier to code in Javascript for Urbit

content/podcasts/2023-04-06_the-ai-episode.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E28 - The AI Episode (feat. Jake Brukhman)"

3+podcast = "The Network Age"

4+date = "2023-04-06"

5+URL = "https://rss.com/podcasts/thenetworkage/896645/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys (including OG host ~timluc-miptev) are joined by Jake Brukhman (~ranter-tapper), the founder and CEO of Coinfund, as well as an engineer, technologist, investor, and cosmonaut exploring the frontiers of AI. The crew discusses the creation of Jargon, a Chat GPT pseudolanguage, which Jake used to build a personal AI Spanish teacher, and the implications of recent AI development. In particular, they focus on AI's implications for privacy, the intersection of AI and Web3 (including crypto as a force of decentralization), and the many types of doom that could be facing us. All this, plus how to use Chat GPT to optimize your personal life, the role of AI in education, the coming marriage between Urbit and AI, and whether interacting with AI is a religious experience. Don't miss it.

content/podcasts/2023-04-11_its-urbits-all-the-way-down-with-dachus-tiprel.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "It's Urbits All the Way Down with ~dachus-tiprel"

3+podcast = "ZeroK - UF"

4+date = "2023-04-11"

5+URL = "https://www.youtube.com/watch?v=hgVE_EZiyms"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/ZeroK-logo.png"

7++++

8+

9+On the newest episode of Zero K, ~poldect-tonteg interviews ~dachus-tiprel of Uqbar network about his virtualization system, Pyro. Also discussed: Exiting college, how he got linked up with Uqbar through the grants program and the ultimate Urbit hosting solution.

content/podcasts/2023-04-14_epicenter-tim-galebach.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Tim Galebach: Uqbar – Smart Contracts on Urbit"

3+podcast = "Epicenter"

4+date = "2023-04-14"

5+URL = "https://www.youtube.com/watch?v=stEn6RacXtY"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/epicenter.jpg"

7++++

8+

9+Building a truly decentralised, peer-to-peer network, based on a built-in identity system, limits the ecosystem’s interoperability with the outside world. Onboarding developers and users to Urbit was only the first hurdle. On-ramping crypto was a whole different & daunting task. Uqbar set out to build an execution layer on top of Urbit, enabling smart contracts, which would ultimately settle, via a ZK rollup, on Starknet.

10+

11+We were joined by Tim Galebach, founder of Uqbar, to discuss the different design choices involved, from Hoon programming DevEx to a hybrid ZK-optimistic rollup.

content/podcasts/2023-04-20_artificial-qintelligence.mdnew file+9

@@ -0,0 +1,9 @@

1++++

2+title = "E29 - Artificial Qintelligence (feat. Xianyang)"

3+podcast = "The Network Age"

4+date = "2023-04-20"

5+URL = "https://rss.com/podcasts/thenetworkage/914980/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys welcome a new cohost, ~habsul-rignyr of the OG Urbit podcast, The Stack (Rest in Power). More importantly, our trio of idiots is joined by famed translator, scholar, technologist, and sinophile Xianyang (~forlyt-novmep) to discuss AI-enhanced gaming, Taoist philosophy, and the creation of DAObi, a token-based simulation game of an ancient Chinese state. Then, we dive into Lexicat, Xianyang's natural language processing platform, and dissect her attempts to create GPT Burmese. All this plus: economic incentives to instantiate the AI apocalypse, the startling Confucian-Taoist rivalry, a scandalous battle for DAObi Chancellor, digital wife swapping, and how to murder a cat.

content/podcasts/2023-04-27_hoon-only-legal-ui-with-hastuc-dibtux.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "Hoon Only Legal UI with ~hastuc-dibtux"

3+podcast = "ZeroK - UF"

4+date = "2023-04-27"

5+URL = "https://www.youtube.com/watch?v=jF5hY-CduTI"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/ZeroK-logo.png"

7++++

8+

9+In new episode of Zero K, ~poldec-tonteg interviews the mysterious hooner/aesthetic crusader known as ~hastuc-dibtux

10+

11+Witness a discussion of immorality of javascript, the importance of a sovereign UI and much more

content/podcasts/2023-05-11_full-metal-urbit-with-mopfel-winrux.mdnew file+15

@@ -0,0 +1,15 @@

1++++

2+title = "Full Metal Urbit with ~mopfel-winrux"

3+podcast = "ZeroK - UF"

4+date = "2023-05-11"

5+URL = "https://www.youtube.com/watch?v=tW2FlJmUy8w"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/ZeroK-logo.png"

7++++

8+

9+Live from my heartland headquarters, another exciting episode of Zero K, an interview with ~mopfel-winrux, hardware extraordinaire.

10+

11+~mopfel has a deep background in hardware: chips, robots, wiring harnesses. Today he talks about the interaction between your Urbit and the metal that it runs on.

12+

13+He also touches on a project that has since been named %lick which lets your Urbit directly control hardware like peripherals and GPUs.

14+

15+You might also get a glimpse or two at the hardware plans of his company Native Planet, leading many to ask: When Urbit phone?

content/podcasts/2023-05-18_crypto-takes-flight.mdnew file+11

@@ -0,0 +1,11 @@

1++++

2+title = "E31 - Crypto Takes Flight (feat. Brian Crain)"

3+podcast = "The Network Age"

4+date = "2023-05-18"

5+URL = "https://rss.com/podcasts/thenetworkage/955387/"

6+image = "https://storage.googleapis.com/media.urbit.org/site/ecosystem/podcasts/networkage.jpg"

7++++

8+

9+On this extra special episode, the boys are joined by technologist and investor Brian Crain (~minwyc-dablen), CEO and co-founder of Chorus One and host of crypto's longest running podcast, Epicenter. They discuss his work building Web3 infrastructure, the evolution of Urbit (Brian just joined the Urbit Foundation board), and the next five years of crypto narratives. Then, they dive into Brian's work on Epicenter, his favorite guests, and what he has learned from spending so many years in the space. All this plus government regulation, AI-crypto integrations, and tips from a master podcaster on how we can improve The Network Age. Don't miss it.

10+

11+Our thoughts go out to Brian, who is currently in the hospital recovering from his experience on this podcast.x3

content/privacy.md+1−1

@@ -76,7 +76,7 @@ We do not knowingly collect, maintain, or use personal information from children

76

77### International visitors

78

79−The Services are hosted in the United States and are intended for visitors located within the United States. If you choose to use the Services from the European Union or other regions of the world with laws governing data collection and use that may differ from U.S. law, then please note that you are transferring your personal information outside of those regions to the United States for storage and processing. Also, we may transfer your data from the U.S. to other countries or regions in connection with storage and processing of data, fulfilling your requests, and operating the Services. By providing any information, including personal information, on or to the Services, you consent to such transfer, storage, and processing.

79+[Omitted long matching line]

80

81### Changes to this Privacy Policy

82

content/proposals.md+14−35

@@ -1,6 +1,6 @@

1+++

2title = "Submit a Proposal"

3−date = "2022-10-26"

3+date = "2023-01-04"

4weight = 1

5description = "A comprehensive guide to creating a grant proposal"

6+++

@@ -11,9 +11,9 @@ We have a track record of funding many different kinds of different projects: ne

11

12Ready to get started? Here's how the process works:

13

14−1. [Create your proposal](#create-your-proposal) as a group on Urbit

15−2. Submit your proposal using [this form](https://airtable.com/shrCi54rEDxgSZr3z)

14+1. Submit your proposal using [this form](https://airtable.com/shrCi54rEDxgSZr3z)

16−3. Obtain [approval](#community-approval) from a member of our community and finalize your proposal

15+2. Obtain [approval](#approval-by-the-foundation) from the Urbit Foundation and find a member of our community to champion your proposal

16+3. When your proposal is approved the Urbit Foundation and you will start looking for a suitable [champion](#looking-for-a-champion)

174. Sign our [grant agreement](#paperwork)

185. [Submit invoices](#getting-paid) after obtaining community signoff

19

@@ -21,21 +21,6 @@ Ready to get started? Here's how the process works:

21

22Submitting a proposal starts by clearly articulating your idea and the value it will bring to the Urbit network. Getting the Urbit Foundation's signoff requires [approval from an established member of our community](#community-approval) and a compelling reason for receiving the requested amount of funding.

23

24−### Create a group

25−

26−The first step is to create a group in Landscape's Groups app — this will be installed by default on your ship. If you don't have a ship running, check out our [Getting Started](https://urbit.org/getting-started) guide.

27−

28−Your group should:

29−

30−- Be **named** after your proposal

31−- Be **public** so our community can join

32−- Contain **a notebook** called `proposal`

33−- Contain **a chat channel** called `discussion`

34−

35−You'll write your proposal in markdown into the notebook, and engage with community members that would approve your proposal in the discussion channel.

36−

37−After writing up your proposal, [fill out this form](https://airtable.com/shrCi54rEDxgSZr3z), including the name of your group. The group name can be found in the URL of your browser. For example, in the URL `https://your.ship.domain/apps/landscape/~landscape/ship/~wolref-podlex/foundation` the group name is `~wolref-podlex/foundation`.

38−

39### Elements of a proposal

24### Elements of a proposal

40

25

41Good proposals all include the following:

26Good proposals all include the following:

@@ -55,6 +40,8 @@ Here are some examples of exceptional proposals for reference:

55- [%pony](https://urbit.org/grants/pony-bounty) contains detailed thinking of current affordances of existing software if trying to build analogs to the traditional software stack

40- [%pony](https://urbit.org/grants/pony-bounty) contains detailed thinking of current affordances of existing software if trying to build analogs to the traditional software stack

56- [App Store](https://urbit.org/grants/app-store) blends the above with a nearly ideal balance of user stories mapped to milestones for clarity of completion, initial architectural thinking, and thinking around unique affordances and challenges of building on a distributed p2p system

41- [App Store](https://urbit.org/grants/app-store) blends the above with a nearly ideal balance of user stories mapped to milestones for clarity of completion, initial architectural thinking, and thinking around unique affordances and challenges of building on a distributed p2p system

57

42

43+After writing up your proposal, [fill out this form](https://airtable.com/shrCi54rEDxgSZr3z) to submit your idea to the Foundation.

44+

58### Funding

45### Funding

59

46

60The Urbit Foundation will provide funding of up to five stars for any one grant.

47The Urbit Foundation will provide funding of up to five stars for any one grant.

@@ -74,19 +61,11 @@ The intent of this policy is to:

74

61

75We try to use this rule in good faith. Reasonable delays due to unforseen life circumstances or project complexity will be tolerated, so long as the contributor is communicative with their champion and/or the Urbit Foundation. In these cases we'll encourage the contributor to modify the timelines and/or scope of their proposals to accommodate new information.

62We try to use this rule in good faith. Reasonable delays due to unforseen life circumstances or project complexity will be tolerated, so long as the contributor is communicative with their champion and/or the Urbit Foundation. In these cases we'll encourage the contributor to modify the timelines and/or scope of their proposals to accommodate new information.

76

63

77−## Community approval

64+### Approval by the Foundation

78−

65+The Grants team of the Urbit Foundation looks at Grants on a bi-weekly basis. After they have decided on the grant they will inform you whether it is approved, rejected or needs some adjustments. In the latter case someone of the grants team will help you finetune your proposal so it can be reconsidered in the next round.

79−Your proposal will be considered approved when an established member of our community decides to _champion_ it. Only those that have made substantial past contributions to the project, generally through their own grants, are eligible to provide such a seal of approval.

80−

81−Approval from the community goes beyond simply clearing the project for funding. The community member that approves your project, called the _Champion_, will meet with you regularly to provide mentorship and support, help onboard you to the rest of the community, and ultimately be responsible for approving your work.

82−

83−### How it works

84−

85−After creating your group and [submitting it](https://airtable.com/shrCi54rEDxgSZr3z), the Urbit Foundation team will post your group to the community members that are approved for Championing proposals.

86−

87−The contents of your submission will be available to prospective champions, and if they're interested, they'll join your group and dive into the details with you (that's why that **discussion channel** is important).

88

66

89−When someone is sufficiently interested, they'll say so and ask to champion your project. If multiple people are interested in championing, you'll need to choose who to go with! This is, in our view, a good problem to have.

67+### Looking for a Champion

68+Finding a suitable champion is important for the success of your grant. Therefore we ask you to stay on the look-out for someone on the network who is capable to champion your proposal. The Foundation will assist you in finding a good champion.

90

69

91### Working with your Champion

70### Working with your Champion

92

71

@@ -97,18 +76,18 @@ Here are some guidelines for how to engage with your champion:

97- **Meet regularly:** Those that can champion projects are chosen for their past contributions. This means that they're able to provide hands-on support. This structure works best if you set up a regular check-in, either once a week or every other week. If nothing else, having an accountability buddy is really helpful.

76- **Meet regularly:** Those that can champion projects are chosen for their past contributions. This means that they're able to provide hands-on support. This structure works best if you set up a regular check-in, either once a week or every other week. If nothing else, having an accountability buddy is really helpful.

98- **Stay in touch:** Leverage the Urbit network for keeping in touch about your project. Don't hesitate to ask questions! The `[battery payload]` group (~dister-dozzod-lapdeg/battery-payload) is a great place to hang out with other developers, ask questions, and share your experiences.

77- **Stay in touch:** Leverage the Urbit network for keeping in touch about your project. Don't hesitate to ask questions! The `[battery payload]` group (~dister-dozzod-lapdeg/battery-payload) is a great place to hang out with other developers, ask questions, and share your experiences.

99- **Ask for connections:** Champions are well-connected throughout the network and know who's who. If you need support in a particular area that is beyond your Champion's expertise, they should be able to put you in touch with someone that can help.

78- **Ask for connections:** Champions are well-connected throughout the network and know who's who. If you need support in a particular area that is beyond your Champion's expertise, they should be able to put you in touch with someone that can help.

100−- **Get your work reviewed:** Part of your Champion's job is to review your work and get others' eyes on it as well. Let them know when you need something reviewed by making a post in your proposal groups. Particularly, this is required for getting review and signoff that you have completed a milestone, but can be helpful for other complex asks as well.

79+- **Get your work reviewed:** Part of your Champion's job is to review your work and get others' eyes on it as well. Let them know when you need something reviewed. Particularly, this is required for getting review and signoff that you have completed a milestone, but can be helpful for other complex asks as well.

101

80

102If your Champion becomes unresponsive or is unhelpful, let someone at the Urbit Foundation know and we'll take care of it.

81If your Champion becomes unresponsive or is unhelpful, let someone at the Urbit Foundation know and we'll take care of it.

103

82

104## Paperwork

83## Paperwork

105

84

106−After your proposal is Championed the Urbit Foundation will need to get a **signed contributor agreement** and **collect a small amount of personal information** from you as part of our KYC process.

85+After your proposal is approved and Championed, it will be added to this website, and the Urbit Foundation will need to get a **signed contributor agreement** and **collect a small amount of personal information** from you as part of our KYC process.

107

86

108The Urbit Foundation must comply with international law when distributing address space. We try to keep this process as minimal as we can, but there's no way to avoid it entirely without legally jeopardizing the Foundation's operations.

87The Urbit Foundation must comply with international law when distributing address space. We try to keep this process as minimal as we can, but there's no way to avoid it entirely without legally jeopardizing the Foundation's operations.

109

88

110## Getting Paid

89## Getting Paid

111

90

112−After you've finished your work on a given milestone, you will need to get signoff from your champion. To do this, make a notebook post in your proposal group with the details of the milestone completed, any relevant instructions, github repos, or app download links, and solicit review from your champion. Their reply of `approved` in the notebook post comments will constitute signoff and you'll need a link to that milestone post when you [submit an invoice](https://airtable.com/shrXXCs1uaxtNSBcg). Upon successful review of this notebook post by the Urbit Foundation and an invoice recieved for the amount agreed upon in your grant or milestone, the Foundation will pay your star allocation to the Ethereum address you have provided.

91+After you've finished your work on a given milestone, you will need to get signoff from your champion. To do this, you'll want to contact them to share the details of the milestone completed, any relevant instructions, github repos, or app download links, and solicit review from your champion. They can submit their approval by contacting `~marfun-pacpet`, at which point you are ready to [submit an invoice](https://airtable.com/shrXXCs1uaxtNSBcg). Once the Urbit Foundation receives approval from your champion and an invoice for the amount agreed upon in your grant or milestone, the Foundation will pay your star allocation to the Ethereum address you have provided.

113

92

114−We approve and issue payments within 30 days of invoice receipt and approval, although often payment is made more quickly as transactions are batched with other grantees who have recently completed milestones. If you are having any issues accepting stars through [Bridge](https://bridge.urbit.org) please contact `~taller-ravnut` for assistance.

93+We approve and issue payments within 30 days of invoice receipt and approval, although often payment is made more quickly. If you have any questions regarding getting paid or submitting an invoice, please contact `~marfun-pacpet` for assistance.

content/rfps.mdnew file+40

@@ -0,0 +1,40 @@

1++++

2+title = "Requests for Proposals"

3+date = "2023-03-02"

4+weight = 1

5+description = "Everything you need to know about fulfilling a request for proposal or RFP"

6++++

7+

8+The imagination of people building on Urbit often outpaces the available development hours. For this case, we have Requests for Proposals (RFPs).

9+

10+These are ideas that the community would like to see come to fruition, but whose details haven't been completely ironed out. Since they're not fully fleshed out, they're a great opportunity for contributors to add their own ideas and creative approaches, while learning about developing and shipping on Urbit.

11+

12+If any of these RFPs sound compelling, we encourage you to come by the [Urbit Grants office hours](https://app.gather.town/app/xAYeiPI2XDYhRM9t/urbit-hacker-house?spawnToken=ufV1APwWTGmYVTgzyx0z) or DM [~poldec-tonteg](https://urbit.org/ids/~poldec-tonteg) to discuss drafting and submitting a proposal.

13+

14+# Jump in

15+

16+The Hacker House is a UF-hosted gather.town instance where contributors hang out, pair program and discuss all things Urbit. At the Office Hours, members from the UF team can help refine the Request idea and give you context about what needs to be built, potential use cases and architectural precedents in the codebase.

17+

18+Once you've got your mind around this, the next step is to draft the Proposal

19+

20+# Drafting a proposal

21+

22+All of the best practices outlined on the [Proposals](https://urbit.org/grants/proposals) section of the website apply equally to Proposals that respond to a Request.

23+

24+Good proposals all include the following:

25+

26+- A **detailed and clear description of the proposal**. If you're proposing something technical, user stories are a good idea.

27+- An overview of **why you are the right person for the job**. A description of your background, familiarity with the project, and professional/education experience are all good starts.

28+- Your estimate for **date of completion**.

29+- The **amount of funding** you'd like for the project, denominated in stars.

30+- What **specific deliverables** will look like.

31+

32+It's recommended to break your project into _milestones_, each of which must have its own completion dates, funding amounts and deliverables. In general, proposals should target a first deliverable within two months of the start of the project. Proposals should have a maximum of five milestones as scoping a project beyond that is impractical, and each milestone should constitute significant enough work to warrant the reward of a full star.

33+

34+Feel free to come to multiple office hours or connect on network to develop the proposal further. Once it's in a good state, submit it through [this form](https://airtable.com/shrCi54rEDxgSZr3z). Submitted proposals are then reviewed internall twice a week by the full grants team.

35+

36+The main distinction between a self-originating Proposal and one that responds to a Request is that the latter doesn't need to go through the further step of getting a champion, as the originator of the Request will fulfill that role.

37+

38+# Getting paid

39+

40+A good proposal will have clear success criteria for each milestone. At the completion of each milestone, submit an invoice to the UF for that milestones star compensation and your champion will have the opportunity to review work.

content/updates/2018-7-30-update.md+1−1

@@ -53,7 +53,7 @@ latest backend Landscape API's that _Isaac_ `~davtyr-nimren` has been improving.

53Urbit is becoming more usable by the day.

54

55Last but not least, the Documentation team continued doing `~zod`'s work helping

56−teach Urbit to the world. _Josh_ `~taglux-nidsep` extended his new Hoon docs to cover Hoon cores, an introduction to the Hoon standard library, and a couple of Hoon examples with very detailed walkthrough commentary (drafts [here](https://github.com/joshuareagan/doc-drafts)). And _Robert_ `~lodleb-ritrul` extended the current Hoon-standard-library documentation on random atom generation and atom scrambling, as well as the Hoon cores for computing modular and signed-integer arithmetic (`urbit/docs` pull requests [here](https://github.com/urbit/docs/pulls)). Very soon you'll actually be able to understand how Urbit works.

56+[Omitted long matching line]

57

58Also: we'll be hosting another party this month on Friday, August 17th. Save the date! Link: [meetup.com: Urbit IRL ~2018.8](https://www.meetup.com/urbit-sf/events/253292678/)

59

content/updates/2019-2-11-update.md+1−1

@@ -26,7 +26,7 @@ To stay up to date on network status, follow [@zodisok](https://twitter.com/zodi

26

27## Team

28

29−_Ted_ `~rovnys-ricfer` and _Joe_ `~master-morzod` got an `%ames` rewrite to compile and are working on documentation and unit tests. _Elliot_ `~littel-ponys` is rewriting `%eyre`, our webserver, which is some of the gnarliest code in Arvo. Outbound web requests are now working, which has allowed us to delete old `%eyre` from the [lighter-than-eyre branch](https://github.com/urbit/arvo/tree/lighter-than-eyre), and work continues porting individual `%gall` applications over to `%light`. We’re looking forward to moving Landscape onto new `%eyre` soon. _Logan_ `~tacryt-socryp` is rewriting the HTTP client in Vere (Arvo’s interpreter) to better support HTTP/2. This will allow us to provide push notifications in the heretofore rumored Landscape iOS app. Finally, _Gavin_ `ridlur-figbud` and _Jimmy_ `fallyn-balfus` are working on a new design system to enable fast UI prototyping. We’re very excited to share more about that in the near future!

29+[Omitted long matching line]

30

31Shout-out to _Philip_ `wicdev-wisryt` for [this heroic weekend PR](https://github.com/urbit/arvo/pull/1072) that fixed persistent connectivity issues on the network after [Thursday’s breach](https://twitter.com/zodisok/status/1096225302210957312).

32

lib/constants.js+14−6

@@ -76,17 +76,25 @@ export const footerData = [

76 },

77 { title: "Get Started", href: "/getting-started" },

78 {

79− title: "Events",

79+ title: "Overview",

80− href: "/events",

80+ href: "/overview",

81 },

82 {

83− title: "Blog",

83+ title: "Ecosystem",

84− href: "/blog",

84+ href: "/ecosystem",

85 },

86 {

87 title: "Grants",

88 href: "/grants",

89 },

90+ {

91+ title: "Events",

92+ href: "/events",

93+ },

94+ {

95+ title: "Blog",

96+ href: "/blog",

97+ }

90 ],

98 ],

91 },

99 },

92 {

100 {

@@ -102,8 +110,8 @@ export const footerData = [

102 href: "https://github.com/urbit/urbit/releases",

110 href: "https://github.com/urbit/urbit/releases",

103 },

111 },

104 {

112 {

105− title: "Urbit Client",

113+ title: "Developer Mailing List",

106− href: "https://github.com/urbit/port/releases",

114+ href: "https://groups.google.com/a/urbit.org/g/dev",

107 },

115 },

108 {

116 {

109 title: "Issue Tracker",

117 title: "Issue Tracker",

lib/lib.js+84−1

@@ -3,7 +3,7 @@ import { join, parse } from "path";

3import matter from "gray-matter";

4import toml from "@iarna/toml";

5import { DateTime } from "luxon";

6−import { getPostBySlug, getPostSlugs } from "@urbit/foundation-design-system";

6+import { Markdown, getPostBySlug, getPostSlugs } from "@urbit/foundation-design-system";

7

8// NB Gavin: This could be much simpler if we converted everything to a more common standard, like YAML

9const options = {

@@ -166,3 +166,86 @@ export const pair = (arr) =>

166 rows

167 );

168 }, []);

169+

170+// Match ecosystem report to posts to inject metadata

171+export const matchEcosystemPost = (ecosystem) => {

172+ const articles = getAllPosts(

173+ ["title", "image", "date", "podcast", "slug"],

174+ "articles",

175+ "date"

176+ );

177+

178+ const marketplaces = getAllPosts(["title", "image", "slug"], "marketplaces");

179+ const podcasts = getAllPosts(

180+ ["title", "image", "date", "podcast", "slug"],

181+ "podcasts",

182+ "date"

183+ );

184+ const organizations = getAllPosts(

185+ ["title", "image", "slug"],

186+ "organizations"

187+ );

188+ const applications = fs

189+ .readdirSync(join(process.cwd(), "content/applications"), {

190+ withFileTypes: true,

191+ })

192+ .filter((f) => f.isDirectory())

193+ .map((dir) =>

194+ getAllPosts(

195+ ["title", "bgColor", "image", "slug", "description"],

196+ `applications/${dir.name}`

197+ )

198+ .map((e) => ({ ...e, ship: dir.name }))

199+ .flat()

200+ )

201+ .flat()

202+ .sort((a, b) => {

203+ const nameA = a.title.toLowerCase();

204+ const nameB = b.title.toLowerCase();

205+ return nameA < nameB ? -1 : 1;

206+ });

207+

208+ const groups = fs

209+ .readdirSync(join(process.cwd(), "content/groups"), {

210+ withFileTypes: true,

211+ })

212+ .filter((f) => f.isDirectory())

213+ .map((dir) =>

214+ getAllPosts(

215+ ["title", "tile", "slug", "description"],

216+ `groups/${dir.name}`

217+ )

218+ .map((e) => ({ ...e, ship: dir.name }))

219+ .flat()

220+ )

221+ .flat()

222+ .sort((a, b) => {

223+ const nameA = a.title.toLowerCase();

224+ const nameB = b.title.toLowerCase();

225+ return nameA < nameB ? -1 : 1;

226+ });

227+

228+ ["featured-1", "featured-2", "featured-3"].forEach((feat) => {

229+ if (ecosystem?.[feat]) {

230+ const matchedPost = [

231+ ...articles.map((e) => ({ ...e, type: "Article" })),

232+ ...applications.map((e) => ({ ...e, type: "Application" })),

233+ ...organizations.map((e) => ({ ...e, type: "Organization" })),

234+ ...podcasts.map((e) => ({ ...e, type: "Podcast" })),

235+ ...marketplaces.map((e) => ({ ...e, type: "Marketplace" })),

236+ ...groups.map((e) => ({ ...e, type: "Group" }))

237+ ].filter((e) => e.title === ecosystem[feat].title)?.[0];

238+ ecosystem[feat].image =

239+ ecosystem[feat].image || matchedPost?.image || null;

240+ ecosystem[feat].type = matchedPost?.type || "Podcast";

241+ ecosystem[feat].matchedPost = matchedPost || null;

242+ ecosystem[feat].content = JSON.stringify(

243+ Markdown.parse({

244+ post: { content: ecosystem[feat].content },

245+ })

246+ );

247+ }

248+ });

249+

250+ return ecosystem;

251+}

package-lock.json+356−82

@@ -12,7 +12,7 @@

12 "@socialgouv/matomo-next": "^1.3.0",

13 "@tailwindcss/aspect-ratio": "^0.4.0",

14 "@tlon/sigil-js": "^1.4.5",

15− "@urbit/foundation-design-system": "0.6.4",

15+ "@urbit/foundation-design-system": "0.7.3",

16 "@urbit/markdoc": "^0.1.4",

17 "axios": "^0.26.1",

18 "buffer": "^6.0.3",

@@ -47,41 +47,6 @@

47 "tailwindcss-theme-swapper": "^0.6.2"

48 }

49 },

50− "../foundation-design-system": {

51− "name": "@urbit/foundation-design-system",

52− "version": "0.6.4",

53− "license": "MIT",

54− "dependencies": {

55− "@iarna/toml": "^2.2.5",

56− "core-js": "^3.23.1",

57− "gray-matter": "^4.0.3",

58− "html-react-parser": "^1.4.14",

59− "luxon": "^3.0.1",

60− "prism-react-renderer": "^1.3.3",

61− "react-swipeable": "^6.2.1"

62− },

63− "devDependencies": {

64− "@babel/preset-react": "^7.17.12",

65− "@rollup/plugin-babel": "^5.3.1",

66− "@rollup/plugin-commonjs": "^22.0.0",

67− "@rollup/plugin-node-resolve": "^13.3.0",

68− "rollup": "^2.75.7",

69− "rollup-plugin-peer-deps-external": "^2.2.4"

70− },

71− "peerDependencies": {

72− "@tailwindcss/aspect-ratio": "^0.4.0",

73− "@urbit/markdoc": "^0.1.6",

74− "autoprefixer": "^10.4.7",

75− "classnames": "^2.3.1",

76− "next": "^12.1.6",

77− "postcss": "^8.4.14",

78− "prismjs": "^1.29.0",

79− "react": "^17.0.2",

80− "react-dom": "^17.0.2",

81− "tailwindcss": "^3.1.3",

82− "tailwindcss-theme-swapper": "^0.6.2"

83− }

84− },

85 "node_modules/@babel/runtime": {

50 "node_modules/@babel/runtime": {

86 "version": "7.20.1",

51 "version": "7.20.1",

87 "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.20.1.tgz",

52 "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.20.1.tgz",

@@ -393,8 +358,58 @@

393 "dev": true

358 "dev": true

394 },

359 },

395 "node_modules/@urbit/foundation-design-system": {

360 "node_modules/@urbit/foundation-design-system": {

361+ "version": "0.7.3",

396− "resolved": "../foundation-design-system",

362+ "resolved": "https://registry.npmjs.org/@urbit/foundation-design-system/-/foundation-design-system-0.7.3.tgz",

397− "link": true

363+ "integrity": "sha512-txg6G2Gv7thd04YqStVilX2CJrkkwrLrWEZx7DaclB+tq1q7Eh9Uud51J2QIytIE/SvWak/innapLL0bUNZI0Q==",

364+ "dependencies": {

365+ "@iarna/toml": "^2.2.5",

366+ "@tlon/sigil-js": "^1.4.5",

367+ "core-js": "^3.23.1",

368+ "downshift": "^7.0.1",

369+ "gray-matter": "^4.0.3",

370+ "html-react-parser": "^1.4.14",

371+ "lodash.debounce": "^4.0.8",

372+ "luxon": "^3.0.1",

373+ "prism-react-renderer": "^1.3.3",

374+ "react-swipeable": "^6.2.1",

375+ "urbit-ob": "^5.0.1"

376+ },

377+ "peerDependencies": {

378+ "@tailwindcss/aspect-ratio": "^0.4.0",

379+ "@urbit/markdoc": "^0.1.6",

380+ "autoprefixer": "^10.4.7",

381+ "classnames": "^2.3.1",

382+ "next": "^12.1.6",

383+ "postcss": "^8.4.14",

384+ "prismjs": "^1.29.0",

385+ "react": "^17.0.2",

386+ "react-dom": "^17.0.2",

387+ "tailwindcss": "^3.1.3",

388+ "tailwindcss-theme-swapper": "^0.6.2"

389+ }

390+ },

391+ "node_modules/@urbit/foundation-design-system/node_modules/downshift": {

392+ "version": "7.0.1",

393+ "resolved": "https://registry.npmjs.org/downshift/-/downshift-7.0.1.tgz",

394+ "integrity": "sha512-AdFU8qJjUg9WZaLKzh7xAPfEwAB0dSqDGb7/Gnx/teldUXcNlaZrxhymOWedzDV+62xphMVustttAngmG33pXw==",

395+ "dependencies": {

396+ "@babel/runtime": "^7.14.8",

397+ "compute-scroll-into-view": "^1.0.17",

398+ "prop-types": "^15.7.2",

399+ "react-is": "^17.0.2",

400+ "tslib": "^2.3.0"

401+ },

402+ "peerDependencies": {

403+ "react": ">=16.12.0"

404+ }

405+ },

406+ "node_modules/@urbit/foundation-design-system/node_modules/luxon": {

407+ "version": "3.1.0",

408+ "resolved": "https://registry.npmjs.org/luxon/-/luxon-3.1.0.tgz",

409+ "integrity": "sha512-7w6hmKC0/aoWnEsmPCu5Br54BmbmUp5GfcqBxQngRcXJ+q5fdfjEzn7dxmJh2YdDhgW8PccYtlWKSv4tQkrTQg==",

410+ "engines": {

411+ "node": ">=12"

412+ }

398 },

413 },

399 "node_modules/@urbit/markdoc": {

414 "node_modules/@urbit/markdoc": {

400 "version": "0.1.6",

415 "version": "0.1.6",

@@ -545,7 +560,6 @@

545 "version": "10.4.13",

560 "version": "10.4.13",

546 "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.13.tgz",

561 "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.13.tgz",

547 "integrity": "sha512-49vKpMqcZYsJjwotvt4+h/BCjJVnhGwcLpDt5xkcaOG3eLrG/HUYLagrihYsQ+qrIBgIzX1Rw7a6L8I/ZA1Atg==",

562 "integrity": "sha512-49vKpMqcZYsJjwotvt4+h/BCjJVnhGwcLpDt5xkcaOG3eLrG/HUYLagrihYsQ+qrIBgIzX1Rw7a6L8I/ZA1Atg==",

548− "dev": true,

549 "funding": [

563 "funding": [

550 {

564 {

551 "type": "opencollective",

565 "type": "opencollective",

@@ -643,7 +657,6 @@

643 "version": "4.21.4",

657 "version": "4.21.4",

644 "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.21.4.tgz",

658 "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.21.4.tgz",

645 "integrity": "sha512-CBHJJdDmgjl3daYjN5Cp5kbTf1mUhZoS+beLklHIvkOWscs83YAhLlF3Wsh/lciQYAcbBJgTOD44VtG31ZM4Hw==",

659 "integrity": "sha512-CBHJJdDmgjl3daYjN5Cp5kbTf1mUhZoS+beLklHIvkOWscs83YAhLlF3Wsh/lciQYAcbBJgTOD44VtG31ZM4Hw==",

646− "dev": true,

647 "funding": [

660 "funding": [

648 {

661 {

649 "type": "opencollective",

662 "type": "opencollective",

@@ -794,7 +807,6 @@

794 "version": "4.2.3",

807 "version": "4.2.3",

795 "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz",

808 "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz",

796 "integrity": "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==",

809 "integrity": "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==",

797− "dev": true,

798 "dependencies": {

810 "dependencies": {

799 "color-convert": "^2.0.1",

811 "color-convert": "^2.0.1",

800 "color-string": "^1.9.0"

812 "color-string": "^1.9.0"

@@ -807,7 +819,6 @@

807 "version": "2.0.1",

819 "version": "2.0.1",

808 "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",

820 "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",

809 "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",

821 "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",

810− "dev": true,

811 "dependencies": {

822 "dependencies": {

812 "color-name": "~1.1.4"

823 "color-name": "~1.1.4"

813 },

824 },

@@ -824,7 +835,6 @@

824 "version": "1.9.1",

835 "version": "1.9.1",

825 "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz",

836 "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz",

826 "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==",

837 "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==",

827− "dev": true,

828 "dependencies": {

838 "dependencies": {

829 "color-name": "^1.0.0",

839 "color-name": "^1.0.0",

830 "simple-swizzle": "^0.2.2"

840 "simple-swizzle": "^0.2.2"

@@ -853,6 +863,16 @@

853 "resolved": "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz",

863 "resolved": "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz",

854 "integrity": "sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ=="

864 "integrity": "sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ=="

855 },

865 },

866+ "node_modules/core-js": {

867+ "version": "3.26.1",

868+ "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.26.1.tgz",

869+ "integrity": "sha512-21491RRQVzUn0GGM9Z1Jrpr6PNPxPi+Za8OM9q4tksTSnlbXXGKK1nXNg/QvwFYettXvSX6zWKCtHHfjN4puyA==",

870+ "hasInstallScript": true,

871+ "funding": {

872+ "type": "opencollective",

873+ "url": "https://opencollective.com/core-js"

874+ }

875+ },

856 "node_modules/cross-spawn": {

876 "node_modules/cross-spawn": {

857 "version": "7.0.3",

877 "version": "7.0.3",

858 "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",

878 "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",

@@ -983,6 +1003,65 @@

983 "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",

1003 "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",

984 "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA=="

1004 "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA=="

985 },

1005 },

1006+ "node_modules/dom-serializer": {

1007+ "version": "1.4.1",

1008+ "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-1.4.1.tgz",

1009+ "integrity": "sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag==",

1010+ "dependencies": {

1011+ "domelementtype": "^2.0.1",

1012+ "domhandler": "^4.2.0",

1013+ "entities": "^2.0.0"

1014+ },

1015+ "funding": {

1016+ "url": "https://github.com/cheeriojs/dom-serializer?sponsor=1"

1017+ }

1018+ },

1019+ "node_modules/dom-serializer/node_modules/entities": {

1020+ "version": "2.2.0",

1021+ "resolved": "https://registry.npmjs.org/entities/-/entities-2.2.0.tgz",

1022+ "integrity": "sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A==",

1023+ "funding": {

1024+ "url": "https://github.com/fb55/entities?sponsor=1"

1025+ }

1026+ },

1027+ "node_modules/domelementtype": {

1028+ "version": "2.3.0",

1029+ "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",

1030+ "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw==",

1031+ "funding": [

1032+ {

1033+ "type": "github",

1034+ "url": "https://github.com/sponsors/fb55"

1035+ }

1036+ ]

1037+ },

1038+ "node_modules/domhandler": {

1039+ "version": "4.3.1",

1040+ "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",

1041+ "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",

1042+ "dependencies": {

1043+ "domelementtype": "^2.2.0"

1044+ },

1045+ "engines": {

1046+ "node": ">= 4"

1047+ },

1048+ "funding": {

1049+ "url": "https://github.com/fb55/domhandler?sponsor=1"

1050+ }

1051+ },

1052+ "node_modules/domutils": {

1053+ "version": "2.8.0",

1054+ "resolved": "https://registry.npmjs.org/domutils/-/domutils-2.8.0.tgz",

1055+ "integrity": "sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==",

1056+ "dependencies": {

1057+ "dom-serializer": "^1.0.1",

1058+ "domelementtype": "^2.2.0",

1059+ "domhandler": "^4.2.0"

1060+ },

1061+ "funding": {

1062+ "url": "https://github.com/fb55/domutils?sponsor=1"

1063+ }

1064+ },

986 "node_modules/downshift": {

1065 "node_modules/downshift": {

987 "version": "6.1.12",

1066 "version": "6.1.12",

988 "resolved": "https://registry.npmjs.org/downshift/-/downshift-6.1.12.tgz",

1067 "resolved": "https://registry.npmjs.org/downshift/-/downshift-6.1.12.tgz",

@@ -1001,8 +1080,7 @@

1001 "node_modules/electron-to-chromium": {

1080 "node_modules/electron-to-chromium": {

1002 "version": "1.4.284",

1081 "version": "1.4.284",

1003 "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.4.284.tgz",

1082 "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.4.284.tgz",

1004− "integrity": "sha512-M8WEXFuKXMYMVr45fo8mq0wUrrJHheiKZf6BArTKk9ZBYCKJEOU5H8cdWgDT+qCVZf7Na4lVUaZsA+h6uA9+PA==",

1083+ "integrity": "sha512-M8WEXFuKXMYMVr45fo8mq0wUrrJHheiKZf6BArTKk9ZBYCKJEOU5H8cdWgDT+qCVZf7Na4lVUaZsA+h6uA9+PA=="

1005− "dev": true

1006 },

1084 },

1007 "node_modules/emoji-regex": {

1085 "node_modules/emoji-regex": {

1008 "version": "8.0.0",

1086 "version": "8.0.0",

@@ -1018,11 +1096,21 @@

1018 "once": "^1.4.0"

1096 "once": "^1.4.0"

1019 }

1097 }

1020 },

1098 },

1099+ "node_modules/entities": {

1100+ "version": "3.0.1",

1101+ "resolved": "https://registry.npmjs.org/entities/-/entities-3.0.1.tgz",

1102+ "integrity": "sha512-WiyBqoomrwMdFG1e0kqvASYfnlb0lp8M5o5Fw2OFq1hNZxxcNk8Ik0Xm7LxzBhuidnZB/UtBqVCgUz3kBOP51Q==",

1103+ "engines": {

1104+ "node": ">=0.12"

1105+ },

1106+ "funding": {

1107+ "url": "https://github.com/fb55/entities?sponsor=1"

1108+ }

1109+ },

1021 "node_modules/escalade": {

1110 "node_modules/escalade": {

1022 "version": "3.1.1",

1111 "version": "3.1.1",

1023 "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.1.tgz",

1112 "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.1.tgz",

1024 "integrity": "sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==",

1113 "integrity": "sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==",

1025− "dev": true,

1026 "engines": {

1114 "engines": {

1027 "node": ">=6"

1115 "node": ">=6"

1028 }

1116 }

@@ -1170,7 +1258,6 @@

1170 "version": "4.2.0",

1258 "version": "4.2.0",

1171 "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.2.0.tgz",

1259 "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.2.0.tgz",

1172 "integrity": "sha512-MhLuK+2gUcnZe8ZHlaaINnQLl0xRIGRfcGk2yl8xoQAfHrSsL3rYu6FCmBdkdbhc9EPlwyGHewaRsvwRMJtAlA==",

1260 "integrity": "sha512-MhLuK+2gUcnZe8ZHlaaINnQLl0xRIGRfcGk2yl8xoQAfHrSsL3rYu6FCmBdkdbhc9EPlwyGHewaRsvwRMJtAlA==",

1173− "dev": true,

1174 "engines": {

1261 "engines": {

1175 "node": "*"

1262 "node": "*"

1176 },

1263 },

@@ -1356,6 +1443,47 @@

1356 "node": ">=0.10.0"

1443 "node": ">=0.10.0"

1357 }

1444 }

1358 },

1445 },

1446+ "node_modules/html-dom-parser": {

1447+ "version": "1.2.0",

1448+ "resolved": "https://registry.npmjs.org/html-dom-parser/-/html-dom-parser-1.2.0.tgz",

1449+ "integrity": "sha512-2HIpFMvvffsXHFUFjso0M9LqM+1Lm22BF+Df2ba+7QHJXjk63pWChEnI6YG27eaWqUdfnh5/Vy+OXrNTtepRsg==",

1450+ "dependencies": {

1451+ "domhandler": "4.3.1",

1452+ "htmlparser2": "7.2.0"

1453+ }

1454+ },

1455+ "node_modules/html-react-parser": {

1456+ "version": "1.4.14",

1457+ "resolved": "https://registry.npmjs.org/html-react-parser/-/html-react-parser-1.4.14.tgz",

1458+ "integrity": "sha512-pxhNWGie8Y+DGDpSh8cTa0k3g8PsDcwlfolA+XxYo1AGDeB6e2rdlyv4ptU9bOTiZ2i3fID+6kyqs86MN0FYZQ==",

1459+ "dependencies": {

1460+ "domhandler": "4.3.1",

1461+ "html-dom-parser": "1.2.0",

1462+ "react-property": "2.0.0",

1463+ "style-to-js": "1.1.1"

1464+ },

1465+ "peerDependencies": {

1466+ "react": "0.14 || 15 || 16 || 17 || 18"

1467+ }

1468+ },

1469+ "node_modules/htmlparser2": {

1470+ "version": "7.2.0",

1471+ "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-7.2.0.tgz",

1472+ "integrity": "sha512-H7MImA4MS6cw7nbyURtLPO1Tms7C5H602LRETv95z1MxO/7CP7rDVROehUYeYBUYEON94NXXDEPmZuq+hX4sog==",

1473+ "funding": [

1474+ "https://github.com/fb55/htmlparser2?sponsor=1",

1475+ {

1476+ "type": "github",

1477+ "url": "https://github.com/sponsors/fb55"

1478+ }

1479+ ],

1480+ "dependencies": {

1481+ "domelementtype": "^2.0.1",

1482+ "domhandler": "^4.2.2",

1483+ "domutils": "^2.8.0",

1484+ "entities": "^3.0.1"

1485+ }

1486+ },

1359 "node_modules/https-proxy-agent": {

1487 "node_modules/https-proxy-agent": {

1360 "version": "5.0.1",

1488 "version": "5.0.1",

1361 "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",

1489 "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",

@@ -1419,6 +1547,11 @@

1419 "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",

1547 "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",

1420 "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="

1548 "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="

1421 },

1549 },

1550+ "node_modules/inline-style-parser": {

1551+ "version": "0.1.1",

1552+ "resolved": "https://registry.npmjs.org/inline-style-parser/-/inline-style-parser-0.1.1.tgz",

1553+ "integrity": "sha512-7NXolsK4CAS5+xvdj5OMMbI962hU/wvwoxk+LWR9Ek9bVtyuuYScDN6eS0rUm6TxApFpw7CX1o4uJzcd4AyD3Q=="

1554+ },

1422 "node_modules/invariant": {

1555 "node_modules/invariant": {

1423 "version": "2.2.4",

1556 "version": "2.2.4",

1424 "resolved": "https://registry.npmjs.org/invariant/-/invariant-2.2.4.tgz",

1557 "resolved": "https://registry.npmjs.org/invariant/-/invariant-2.2.4.tgz",

@@ -1430,8 +1563,7 @@

1430 "node_modules/is-arrayish": {

1563 "node_modules/is-arrayish": {

1431 "version": "0.3.2",

1564 "version": "0.3.2",

1432 "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.2.tgz",

1565 "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.2.tgz",

1433− "integrity": "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ==",

1566+ "integrity": "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ=="

1434− "dev": true

1435 },

1567 },

1436 "node_modules/is-binary-path": {

1568 "node_modules/is-binary-path": {

1437 "version": "2.1.0",

1569 "version": "2.1.0",

@@ -1920,8 +2052,7 @@

1920 "node_modules/node-releases": {

2052 "node_modules/node-releases": {

1921 "version": "2.0.6",

2053 "version": "2.0.6",

1922 "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.6.tgz",

2054 "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.6.tgz",

1923− "integrity": "sha512-PiVXnNuFm5+iYkLBNeq5211hvO38y63T0i2KKh2KnUs3RpzJ+JtODFjkD8yjLwnDkTYF1eKXheUwdssR+NRZdg==",

2055+ "integrity": "sha512-PiVXnNuFm5+iYkLBNeq5211hvO38y63T0i2KKh2KnUs3RpzJ+JtODFjkD8yjLwnDkTYF1eKXheUwdssR+NRZdg=="

1924− "dev": true

1925 },

2056 },

1926 "node_modules/nopt": {

2057 "node_modules/nopt": {

1927 "version": "5.0.0",

2058 "version": "5.0.0",

@@ -1949,7 +2080,6 @@

1949 "version": "0.1.2",

2080 "version": "0.1.2",

1950 "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",

2081 "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",

1951 "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==",

2082 "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==",

1952− "dev": true,

1953 "engines": {

2083 "engines": {

1954 "node": ">=0.10.0"

2084 "node": ">=0.10.0"

1955 }

2085 }

@@ -2282,6 +2412,14 @@

2282 "prettier": ">=2.0.0"

2412 "prettier": ">=2.0.0"

2283 }

2413 }

2284 },

2414 },

2415+ "node_modules/prism-react-renderer": {

2416+ "version": "1.3.5",

2417+ "resolved": "https://registry.npmjs.org/prism-react-renderer/-/prism-react-renderer-1.3.5.tgz",

2418+ "integrity": "sha512-IJ+MSwBWKG+SM3b2SUfdrhC+gu01QkV2KmRQgREThBfSQRoufqRfxfHUxpG1WcaFjP+kojcFyO9Qqtpgt3qLCg==",

2419+ "peerDependencies": {

2420+ "react": ">=0.14.9"

2421+ }

2422+ },

2285 "node_modules/prismjs": {

2423 "node_modules/prismjs": {

2286 "version": "1.29.0",

2424 "version": "1.29.0",

2287 "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.29.0.tgz",

2425 "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.29.0.tgz",

@@ -2394,6 +2532,11 @@

2394 "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",

2532 "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",

2395 "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w=="

2533 "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w=="

2396 },

2534 },

2535+ "node_modules/react-property": {

2536+ "version": "2.0.0",

2537+ "resolved": "https://registry.npmjs.org/react-property/-/react-property-2.0.0.tgz",

2538+ "integrity": "sha512-kzmNjIgU32mO4mmH5+iUyrqlpFQhF8K2k7eZ4fdLSOPFrD1XgEuSBv9LDEgxRXTMBqMd8ppT0x6TIzqE5pdGdw=="

2539+ },

2397 "node_modules/react-swipeable": {

2540 "node_modules/react-swipeable": {

2398 "version": "6.2.2",

2541 "version": "6.2.2",

2399 "resolved": "https://registry.npmjs.org/react-swipeable/-/react-swipeable-6.2.2.tgz",

2542 "resolved": "https://registry.npmjs.org/react-swipeable/-/react-swipeable-6.2.2.tgz",

@@ -2639,7 +2782,6 @@

2639 "version": "0.2.2",

2782 "version": "0.2.2",

2640 "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.2.tgz",

2783 "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.2.tgz",

2641 "integrity": "sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==",

2784 "integrity": "sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==",

2642− "dev": true,

2643 "dependencies": {

2785 "dependencies": {

2644 "is-arrayish": "^0.3.1"

2786 "is-arrayish": "^0.3.1"

2645 }

2787 }

@@ -2715,6 +2857,22 @@

2715 "node": ">=6"

2857 "node": ">=6"

2716 }

2858 }

2717 },

2859 },

2860+ "node_modules/style-to-js": {

2861+ "version": "1.1.1",

2862+ "resolved": "https://registry.npmjs.org/style-to-js/-/style-to-js-1.1.1.tgz",

2863+ "integrity": "sha512-RJ18Z9t2B02sYhZtfWKQq5uplVctgvjTfLWT7+Eb1zjUjIrWzX5SdlkwLGQozrqarTmEzJJ/YmdNJCUNI47elg==",

2864+ "dependencies": {

2865+ "style-to-object": "0.3.0"

2866+ }

2867+ },

2868+ "node_modules/style-to-object": {

2869+ "version": "0.3.0",

2870+ "resolved": "https://registry.npmjs.org/style-to-object/-/style-to-object-0.3.0.tgz",

2871+ "integrity": "sha512-CzFnRRXhzWIdItT3OmF8SQfWyahHhjq3HwcMNCNLn+N7klOOqPjMeG/4JSu77D7ypZdGvSzvkrbyeTMizz2VrA==",

2872+ "dependencies": {

2873+ "inline-style-parser": "0.1.1"

2874+ }

2875+ },

2718 "node_modules/styled-jsx": {

2876 "node_modules/styled-jsx": {

2719 "version": "5.0.7",

2877 "version": "5.0.7",

2720 "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.0.7.tgz",

2878 "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.0.7.tgz",

@@ -2811,7 +2969,6 @@

2811 "version": "0.6.2",

2969 "version": "0.6.2",

2812 "resolved": "https://registry.npmjs.org/tailwindcss-theme-swapper/-/tailwindcss-theme-swapper-0.6.2.tgz",

2970 "resolved": "https://registry.npmjs.org/tailwindcss-theme-swapper/-/tailwindcss-theme-swapper-0.6.2.tgz",

2813 "integrity": "sha512-l+DQJJH9g9/YXKnNApw0W/2gffSkbfBkhVJp8KBolK4E3SR6GbOUpJyuQRfnYbL8KR/BOjDuQntnZM3FZQqEnw==",

2971 "integrity": "sha512-l+DQJJH9g9/YXKnNApw0W/2gffSkbfBkhVJp8KBolK4E3SR6GbOUpJyuQRfnYbL8KR/BOjDuQntnZM3FZQqEnw==",

2814− "dev": true,

2815 "dependencies": {

2972 "dependencies": {

2816 "color": "^4.2.3",

2973 "color": "^4.2.3",

2817 "postcss": "^8.4.12",

2974 "postcss": "^8.4.12",

@@ -2876,7 +3033,6 @@

2876 "version": "1.0.10",

3033 "version": "1.0.10",

2877 "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.0.10.tgz",

3034 "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.0.10.tgz",

2878 "integrity": "sha512-OztqDenkfFkbSG+tRxBeAnCVPckDBcvibKd35yDONx6OU8N7sqgwc7rCbkJ/WcYtVRZ4ba68d6byhC21GFh7sQ==",

3035 "integrity": "sha512-OztqDenkfFkbSG+tRxBeAnCVPckDBcvibKd35yDONx6OU8N7sqgwc7rCbkJ/WcYtVRZ4ba68d6byhC21GFh7sQ==",

2879− "dev": true,

2880 "funding": [

3036 "funding": [

2881 {

3037 {

2882 "type": "opencollective",

3038 "type": "opencollective",

@@ -3186,21 +3342,40 @@

3186 "dev": true

3342 "dev": true

3187 },

3343 },

3188 "@urbit/foundation-design-system": {

3344 "@urbit/foundation-design-system": {

3189− "version": "file:../foundation-design-system",

3345+ "version": "0.7.3",

3346+ "resolved": "https://registry.npmjs.org/@urbit/foundation-design-system/-/foundation-design-system-0.7.3.tgz",

3347+ "integrity": "sha512-txg6G2Gv7thd04YqStVilX2CJrkkwrLrWEZx7DaclB+tq1q7Eh9Uud51J2QIytIE/SvWak/innapLL0bUNZI0Q==",

3190 "requires": {

3348 "requires": {

3191− "@babel/preset-react": "^7.17.12",

3192 "@iarna/toml": "^2.2.5",

3349 "@iarna/toml": "^2.2.5",

3193− "@rollup/plugin-babel": "^5.3.1",

3350+ "@tlon/sigil-js": "^1.4.5",

3194− "@rollup/plugin-commonjs": "^22.0.0",

3195− "@rollup/plugin-node-resolve": "^13.3.0",

3196 "core-js": "^3.23.1",

3351 "core-js": "^3.23.1",

3352+ "downshift": "^7.0.1",

3197 "gray-matter": "^4.0.3",

3353 "gray-matter": "^4.0.3",

3198 "html-react-parser": "^1.4.14",

3354 "html-react-parser": "^1.4.14",

3355+ "lodash.debounce": "^4.0.8",

3199 "luxon": "^3.0.1",

3356 "luxon": "^3.0.1",

3200 "prism-react-renderer": "^1.3.3",

3357 "prism-react-renderer": "^1.3.3",

3201 "react-swipeable": "^6.2.1",

3358 "react-swipeable": "^6.2.1",

3202− "rollup": "^2.75.7",

3359+ "urbit-ob": "^5.0.1"

3203− "rollup-plugin-peer-deps-external": "^2.2.4"

3360+ },

3361+ "dependencies": {

3362+ "downshift": {

3363+ "version": "7.0.1",

3364+ "resolved": "https://registry.npmjs.org/downshift/-/downshift-7.0.1.tgz",

3365+ "integrity": "sha512-AdFU8qJjUg9WZaLKzh7xAPfEwAB0dSqDGb7/Gnx/teldUXcNlaZrxhymOWedzDV+62xphMVustttAngmG33pXw==",

3366+ "requires": {

3367+ "@babel/runtime": "^7.14.8",

3368+ "compute-scroll-into-view": "^1.0.17",

3369+ "prop-types": "^15.7.2",

3370+ "react-is": "^17.0.2",

3371+ "tslib": "^2.3.0"

3372+ }

3373+ },

3374+ "luxon": {

3375+ "version": "3.1.0",

3376+ "resolved": "https://registry.npmjs.org/luxon/-/luxon-3.1.0.tgz",

3377+ "integrity": "sha512-7w6hmKC0/aoWnEsmPCu5Br54BmbmUp5GfcqBxQngRcXJ+q5fdfjEzn7dxmJh2YdDhgW8PccYtlWKSv4tQkrTQg=="

3378+ }

3204 }

3379 }

3205 },

3380 },

3206 "@urbit/markdoc": {

3381 "@urbit/markdoc": {

@@ -3313,7 +3488,6 @@

3313 "version": "10.4.13",

3488 "version": "10.4.13",

3314 "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.13.tgz",

3489 "resolved": "https://registry.npmjs.org/autoprefixer/-/autoprefixer-10.4.13.tgz",

3315 "integrity": "sha512-49vKpMqcZYsJjwotvt4+h/BCjJVnhGwcLpDt5xkcaOG3eLrG/HUYLagrihYsQ+qrIBgIzX1Rw7a6L8I/ZA1Atg==",

3490 "integrity": "sha512-49vKpMqcZYsJjwotvt4+h/BCjJVnhGwcLpDt5xkcaOG3eLrG/HUYLagrihYsQ+qrIBgIzX1Rw7a6L8I/ZA1Atg==",

3316− "dev": true,

3317 "requires": {

3491 "requires": {

3318 "browserslist": "^4.21.4",

3492 "browserslist": "^4.21.4",

3319 "caniuse-lite": "^1.0.30001426",

3493 "caniuse-lite": "^1.0.30001426",

@@ -3372,7 +3546,6 @@

3372 "version": "4.21.4",

3546 "version": "4.21.4",

3373 "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.21.4.tgz",

3547 "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.21.4.tgz",

3374 "integrity": "sha512-CBHJJdDmgjl3daYjN5Cp5kbTf1mUhZoS+beLklHIvkOWscs83YAhLlF3Wsh/lciQYAcbBJgTOD44VtG31ZM4Hw==",

3548 "integrity": "sha512-CBHJJdDmgjl3daYjN5Cp5kbTf1mUhZoS+beLklHIvkOWscs83YAhLlF3Wsh/lciQYAcbBJgTOD44VtG31ZM4Hw==",

3375− "dev": true,

3376 "requires": {

3549 "requires": {

3377 "caniuse-lite": "^1.0.30001400",

3550 "caniuse-lite": "^1.0.30001400",

3378 "electron-to-chromium": "^1.4.251",

3551 "electron-to-chromium": "^1.4.251",

@@ -3458,7 +3631,6 @@

3458 "version": "4.2.3",

3631 "version": "4.2.3",

3459 "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz",

3632 "resolved": "https://registry.npmjs.org/color/-/color-4.2.3.tgz",

3460 "integrity": "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==",

3633 "integrity": "sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==",

3461− "dev": true,

3462 "requires": {

3634 "requires": {

3463 "color-convert": "^2.0.1",

3635 "color-convert": "^2.0.1",

3464 "color-string": "^1.9.0"

3636 "color-string": "^1.9.0"

@@ -3468,7 +3640,6 @@

3468 "version": "2.0.1",

3640 "version": "2.0.1",

3469 "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",

3641 "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",

3470 "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",

3642 "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",

3471− "dev": true,

3472 "requires": {

3643 "requires": {

3473 "color-name": "~1.1.4"

3644 "color-name": "~1.1.4"

3474 }

3645 }

@@ -3482,7 +3653,6 @@

3482 "version": "1.9.1",

3653 "version": "1.9.1",

3483 "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz",

3654 "resolved": "https://registry.npmjs.org/color-string/-/color-string-1.9.1.tgz",

3484 "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==",

3655 "integrity": "sha512-shrVawQFojnZv6xM40anx4CkoDP+fZsw/ZerEMsW/pyzsRbElpsL/DBVW7q3ExxwusdNXI3lXpuhEZkzs8p5Eg==",

3485− "dev": true,

3486 "requires": {

3656 "requires": {

3487 "color-name": "^1.0.0",

3657 "color-name": "^1.0.0",

3488 "simple-swizzle": "^0.2.2"

3658 "simple-swizzle": "^0.2.2"

@@ -3508,6 +3678,11 @@

3508 "resolved": "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz",

3678 "resolved": "https://registry.npmjs.org/console-control-strings/-/console-control-strings-1.1.0.tgz",

3509 "integrity": "sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ=="

3679 "integrity": "sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ=="

3510 },

3680 },

3681+ "core-js": {

3682+ "version": "3.26.1",

3683+ "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.26.1.tgz",

3684+ "integrity": "sha512-21491RRQVzUn0GGM9Z1Jrpr6PNPxPi+Za8OM9q4tksTSnlbXXGKK1nXNg/QvwFYettXvSX6zWKCtHHfjN4puyA=="

3685+ },

3511 "cross-spawn": {

3686 "cross-spawn": {

3512 "version": "7.0.3",

3687 "version": "7.0.3",

3513 "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",

3688 "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.3.tgz",

@@ -3599,6 +3774,46 @@

3599 "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",

3774 "resolved": "https://registry.npmjs.org/dlv/-/dlv-1.1.3.tgz",

3600 "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA=="

3775 "integrity": "sha512-+HlytyjlPKnIG8XuRG8WvmBP8xs8P71y+SKKS6ZXWoEgLuePxtDoUEiH7WkdePWrQ5JBpE6aoVqfZfJUQkjXwA=="

3601 },

3776 },

3777+ "dom-serializer": {

3778+ "version": "1.4.1",

3779+ "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-1.4.1.tgz",

3780+ "integrity": "sha512-VHwB3KfrcOOkelEG2ZOfxqLZdfkil8PtJi4P8N2MMXucZq2yLp75ClViUlOVwyoHEDjYU433Aq+5zWP61+RGag==",

3781+ "requires": {

3782+ "domelementtype": "^2.0.1",

3783+ "domhandler": "^4.2.0",

3784+ "entities": "^2.0.0"

3785+ },

3786+ "dependencies": {

3787+ "entities": {

3788+ "version": "2.2.0",

3789+ "resolved": "https://registry.npmjs.org/entities/-/entities-2.2.0.tgz",

3790+ "integrity": "sha512-p92if5Nz619I0w+akJrLZH0MX0Pb5DX39XOwQTtXSdQQOaYH03S1uIQp4mhOZtAXrxq4ViO67YTiLBo2638o9A=="

3791+ }

3792+ }

3793+ },

3794+ "domelementtype": {

3795+ "version": "2.3.0",

3796+ "resolved": "https://registry.npmjs.org/domelementtype/-/domelementtype-2.3.0.tgz",

3797+ "integrity": "sha512-OLETBj6w0OsagBwdXnPdN0cnMfF9opN69co+7ZrbfPGrdpPVNBUj02spi6B1N7wChLQiPn4CSH/zJvXw56gmHw=="

3798+ },

3799+ "domhandler": {

3800+ "version": "4.3.1",

3801+ "resolved": "https://registry.npmjs.org/domhandler/-/domhandler-4.3.1.tgz",

3802+ "integrity": "sha512-GrwoxYN+uWlzO8uhUXRl0P+kHE4GtVPfYzVLcUxPL7KNdHKj66vvlhiweIHqYYXWlw+T8iLMp42Lm67ghw4WMQ==",

3803+ "requires": {

3804+ "domelementtype": "^2.2.0"

3805+ }

3806+ },

3807+ "domutils": {

3808+ "version": "2.8.0",

3809+ "resolved": "https://registry.npmjs.org/domutils/-/domutils-2.8.0.tgz",

3810+ "integrity": "sha512-w96Cjofp72M5IIhpjgobBimYEfoPjx1Vx0BSX9P30WBdZW2WIKU0T1Bd0kz2eNZ9ikjKgHbEyKx8BB6H1L3h3A==",

3811+ "requires": {

3812+ "dom-serializer": "^1.0.1",

3813+ "domelementtype": "^2.2.0",

3814+ "domhandler": "^4.2.0"

3815+ }

3816+ },

3602 "downshift": {

3817 "downshift": {

3603 "version": "6.1.12",

3818 "version": "6.1.12",

3604 "resolved": "https://registry.npmjs.org/downshift/-/downshift-6.1.12.tgz",

3819 "resolved": "https://registry.npmjs.org/downshift/-/downshift-6.1.12.tgz",

@@ -3614,8 +3829,7 @@

3614 "electron-to-chromium": {

3829 "electron-to-chromium": {

3615 "version": "1.4.284",

3830 "version": "1.4.284",

3616 "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.4.284.tgz",

3831 "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.4.284.tgz",

3617− "integrity": "sha512-M8WEXFuKXMYMVr45fo8mq0wUrrJHheiKZf6BArTKk9ZBYCKJEOU5H8cdWgDT+qCVZf7Na4lVUaZsA+h6uA9+PA==",

3832+ "integrity": "sha512-M8WEXFuKXMYMVr45fo8mq0wUrrJHheiKZf6BArTKk9ZBYCKJEOU5H8cdWgDT+qCVZf7Na4lVUaZsA+h6uA9+PA=="

3618− "dev": true

3619 },

3833 },

3620 "emoji-regex": {

3834 "emoji-regex": {

3621 "version": "8.0.0",

3835 "version": "8.0.0",

@@ -3631,11 +3845,15 @@

3631 "once": "^1.4.0"

3845 "once": "^1.4.0"

3632 }

3846 }

3633 },

3847 },

3848+ "entities": {

3849+ "version": "3.0.1",

3850+ "resolved": "https://registry.npmjs.org/entities/-/entities-3.0.1.tgz",

3851+ "integrity": "sha512-WiyBqoomrwMdFG1e0kqvASYfnlb0lp8M5o5Fw2OFq1hNZxxcNk8Ik0Xm7LxzBhuidnZB/UtBqVCgUz3kBOP51Q=="

3852+ },

3634 "escalade": {

3853 "escalade": {

3635 "version": "3.1.1",

3854 "version": "3.1.1",

3636 "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.1.tgz",

3855 "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.1.1.tgz",

3637− "integrity": "sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==",

3856+ "integrity": "sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw=="

3638− "dev": true

3639 },

3857 },

3640 "esprima": {

3858 "esprima": {

3641 "version": "4.0.1",

3859 "version": "4.0.1",

@@ -3736,8 +3954,7 @@

3736 "fraction.js": {

3954 "fraction.js": {

3737 "version": "4.2.0",

3955 "version": "4.2.0",

3738 "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.2.0.tgz",

3956 "resolved": "https://registry.npmjs.org/fraction.js/-/fraction.js-4.2.0.tgz",

3739− "integrity": "sha512-MhLuK+2gUcnZe8ZHlaaINnQLl0xRIGRfcGk2yl8xoQAfHrSsL3rYu6FCmBdkdbhc9EPlwyGHewaRsvwRMJtAlA==",

3957+ "integrity": "sha512-MhLuK+2gUcnZe8ZHlaaINnQLl0xRIGRfcGk2yl8xoQAfHrSsL3rYu6FCmBdkdbhc9EPlwyGHewaRsvwRMJtAlA=="

3740− "dev": true

3741 },

3958 },

3742 "fs-minipass": {

3959 "fs-minipass": {

3743 "version": "2.1.0",

3960 "version": "2.1.0",

@@ -3869,6 +4086,37 @@

3869 "resolved": "https://registry.npmjs.org/has-values/-/has-values-0.1.4.tgz",

4086 "resolved": "https://registry.npmjs.org/has-values/-/has-values-0.1.4.tgz",

3870 "integrity": "sha512-J8S0cEdWuQbqD9//tlZxiMuMNmxB8PlEwvYwuxsTmR1G5RXUePEX/SJn7aD0GMLieuZYSwNH0cQuJGwnYunXRQ=="

4087 "integrity": "sha512-J8S0cEdWuQbqD9//tlZxiMuMNmxB8PlEwvYwuxsTmR1G5RXUePEX/SJn7aD0GMLieuZYSwNH0cQuJGwnYunXRQ=="

3871 },

4088 },

4089+ "html-dom-parser": {

4090+ "version": "1.2.0",

4091+ "resolved": "https://registry.npmjs.org/html-dom-parser/-/html-dom-parser-1.2.0.tgz",

4092+ "integrity": "sha512-2HIpFMvvffsXHFUFjso0M9LqM+1Lm22BF+Df2ba+7QHJXjk63pWChEnI6YG27eaWqUdfnh5/Vy+OXrNTtepRsg==",

4093+ "requires": {

4094+ "domhandler": "4.3.1",

4095+ "htmlparser2": "7.2.0"

4096+ }

4097+ },

4098+ "html-react-parser": {

4099+ "version": "1.4.14",

4100+ "resolved": "https://registry.npmjs.org/html-react-parser/-/html-react-parser-1.4.14.tgz",

4101+ "integrity": "sha512-pxhNWGie8Y+DGDpSh8cTa0k3g8PsDcwlfolA+XxYo1AGDeB6e2rdlyv4ptU9bOTiZ2i3fID+6kyqs86MN0FYZQ==",

4102+ "requires": {

4103+ "domhandler": "4.3.1",

4104+ "html-dom-parser": "1.2.0",

4105+ "react-property": "2.0.0",

4106+ "style-to-js": "1.1.1"

4107+ }

4108+ },

4109+ "htmlparser2": {

4110+ "version": "7.2.0",

4111+ "resolved": "https://registry.npmjs.org/htmlparser2/-/htmlparser2-7.2.0.tgz",

4112+ "integrity": "sha512-H7MImA4MS6cw7nbyURtLPO1Tms7C5H602LRETv95z1MxO/7CP7rDVROehUYeYBUYEON94NXXDEPmZuq+hX4sog==",

4113+ "requires": {

4114+ "domelementtype": "^2.0.1",

4115+ "domhandler": "^4.2.2",

4116+ "domutils": "^2.8.0",

4117+ "entities": "^3.0.1"

4118+ }

4119+ },

3872 "https-proxy-agent": {

4120 "https-proxy-agent": {

3873 "version": "5.0.1",

4121 "version": "5.0.1",

3874 "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",

4122 "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",

@@ -3909,6 +4157,11 @@

3909 "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",

4157 "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",

3910 "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="

4158 "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="

3911 },

4159 },

4160+ "inline-style-parser": {

4161+ "version": "0.1.1",

4162+ "resolved": "https://registry.npmjs.org/inline-style-parser/-/inline-style-parser-0.1.1.tgz",

4163+ "integrity": "sha512-7NXolsK4CAS5+xvdj5OMMbI962hU/wvwoxk+LWR9Ek9bVtyuuYScDN6eS0rUm6TxApFpw7CX1o4uJzcd4AyD3Q=="

4164+ },

3912 "invariant": {

4165 "invariant": {

3913 "version": "2.2.4",

4166 "version": "2.2.4",

3914 "resolved": "https://registry.npmjs.org/invariant/-/invariant-2.2.4.tgz",

4167 "resolved": "https://registry.npmjs.org/invariant/-/invariant-2.2.4.tgz",

@@ -3920,8 +4173,7 @@

3920 "is-arrayish": {

4173 "is-arrayish": {

3921 "version": "0.3.2",

4174 "version": "0.3.2",

3922 "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.2.tgz",

4175 "resolved": "https://registry.npmjs.org/is-arrayish/-/is-arrayish-0.3.2.tgz",

3923− "integrity": "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ==",

4176+ "integrity": "sha512-eVRqCvVlZbuw3GrM63ovNSNAeA1K16kaR/LRY/92w0zxQ5/1YzwblUX652i4Xs9RwAGjW9d9y6X88t8OaAJfWQ=="

3924− "dev": true

3925 },

4177 },

3926 "is-binary-path": {

4178 "is-binary-path": {

3927 "version": "2.1.0",

4179 "version": "2.1.0",

@@ -4253,8 +4505,7 @@

4253 "node-releases": {

4505 "node-releases": {

4254 "version": "2.0.6",

4506 "version": "2.0.6",

4255 "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.6.tgz",

4507 "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.6.tgz",

4256− "integrity": "sha512-PiVXnNuFm5+iYkLBNeq5211hvO38y63T0i2KKh2KnUs3RpzJ+JtODFjkD8yjLwnDkTYF1eKXheUwdssR+NRZdg==",

4508+ "integrity": "sha512-PiVXnNuFm5+iYkLBNeq5211hvO38y63T0i2KKh2KnUs3RpzJ+JtODFjkD8yjLwnDkTYF1eKXheUwdssR+NRZdg=="

4257− "dev": true

4258 },

4509 },

4259 "nopt": {

4510 "nopt": {

4260 "version": "5.0.0",

4511 "version": "5.0.0",

@@ -4272,8 +4523,7 @@

4272 "normalize-range": {

4523 "normalize-range": {

4273 "version": "0.1.2",

4524 "version": "0.1.2",

4274 "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",

4525 "resolved": "https://registry.npmjs.org/normalize-range/-/normalize-range-0.1.2.tgz",

4275− "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA==",

4526+ "integrity": "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA=="

4276− "dev": true

4277 },

4527 },

4278 "npm-run-path": {

4528 "npm-run-path": {

4279 "version": "4.0.1",

4529 "version": "4.0.1",

@@ -4476,6 +4726,12 @@

4476 "multimatch": "^4.0.0"

4726 "multimatch": "^4.0.0"

4477 }

4727 }

4478 },

4728 },

4729+ "prism-react-renderer": {

4730+ "version": "1.3.5",

4731+ "resolved": "https://registry.npmjs.org/prism-react-renderer/-/prism-react-renderer-1.3.5.tgz",

4732+ "integrity": "sha512-IJ+MSwBWKG+SM3b2SUfdrhC+gu01QkV2KmRQgREThBfSQRoufqRfxfHUxpG1WcaFjP+kojcFyO9Qqtpgt3qLCg==",

4733+ "requires": {}

4734+ },

4479 "prismjs": {

4735 "prismjs": {

4480 "version": "1.29.0",

4736 "version": "1.29.0",

4481 "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.29.0.tgz",

4737 "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.29.0.tgz",

@@ -4555,6 +4811,11 @@

4555 "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",

4811 "resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",

4556 "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w=="

4812 "integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w=="

4557 },

4813 },

4814+ "react-property": {

4815+ "version": "2.0.0",

4816+ "resolved": "https://registry.npmjs.org/react-property/-/react-property-2.0.0.tgz",

4817+ "integrity": "sha512-kzmNjIgU32mO4mmH5+iUyrqlpFQhF8K2k7eZ4fdLSOPFrD1XgEuSBv9LDEgxRXTMBqMd8ppT0x6TIzqE5pdGdw=="

4818+ },

4558 "react-swipeable": {

4819 "react-swipeable": {

4559 "version": "6.2.2",

4820 "version": "6.2.2",

4560 "resolved": "https://registry.npmjs.org/react-swipeable/-/react-swipeable-6.2.2.tgz",

4821 "resolved": "https://registry.npmjs.org/react-swipeable/-/react-swipeable-6.2.2.tgz",

@@ -4714,7 +4975,6 @@

4714 "version": "0.2.2",

4975 "version": "0.2.2",

4715 "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.2.tgz",

4976 "resolved": "https://registry.npmjs.org/simple-swizzle/-/simple-swizzle-0.2.2.tgz",

4716 "integrity": "sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==",

4977 "integrity": "sha512-JA//kQgZtbuY83m+xT+tXJkmJncGMTFT+C+g2h2R9uxkYIrE2yy9sgmcLhCnw57/WSD+Eh3J97FPEDFnbXnDUg==",

4717− "dev": true,

4718 "requires": {

4978 "requires": {

4719 "is-arrayish": "^0.3.1"

4979 "is-arrayish": "^0.3.1"

4720 }

4980 }

@@ -4775,6 +5035,22 @@

4775 "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",

5035 "integrity": "sha512-BrpvfNAE3dcvq7ll3xVumzjKjZQ5tI1sEUIKr3Uoks0XUl45St3FlatVqef9prk4jRDzhW6WZg+3bk93y6pLjA==",

4776 "dev": true

5036 "dev": true

4777 },

5037 },

5038+ "style-to-js": {

5039+ "version": "1.1.1",

5040+ "resolved": "https://registry.npmjs.org/style-to-js/-/style-to-js-1.1.1.tgz",

5041+ "integrity": "sha512-RJ18Z9t2B02sYhZtfWKQq5uplVctgvjTfLWT7+Eb1zjUjIrWzX5SdlkwLGQozrqarTmEzJJ/YmdNJCUNI47elg==",

5042+ "requires": {

5043+ "style-to-object": "0.3.0"

5044+ }

5045+ },

5046+ "style-to-object": {

5047+ "version": "0.3.0",

5048+ "resolved": "https://registry.npmjs.org/style-to-object/-/style-to-object-0.3.0.tgz",

5049+ "integrity": "sha512-CzFnRRXhzWIdItT3OmF8SQfWyahHhjq3HwcMNCNLn+N7klOOqPjMeG/4JSu77D7ypZdGvSzvkrbyeTMizz2VrA==",

5050+ "requires": {

5051+ "inline-style-parser": "0.1.1"

5052+ }

5053+ },

4778 "styled-jsx": {

5054 "styled-jsx": {

4779 "version": "5.0.7",

5055 "version": "5.0.7",

4780 "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.0.7.tgz",

5056 "resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.0.7.tgz",

@@ -4839,7 +5115,6 @@

4839 "version": "0.6.2",

5115 "version": "0.6.2",

4840 "resolved": "https://registry.npmjs.org/tailwindcss-theme-swapper/-/tailwindcss-theme-swapper-0.6.2.tgz",

5116 "resolved": "https://registry.npmjs.org/tailwindcss-theme-swapper/-/tailwindcss-theme-swapper-0.6.2.tgz",

4841 "integrity": "sha512-l+DQJJH9g9/YXKnNApw0W/2gffSkbfBkhVJp8KBolK4E3SR6GbOUpJyuQRfnYbL8KR/BOjDuQntnZM3FZQqEnw==",

5117 "integrity": "sha512-l+DQJJH9g9/YXKnNApw0W/2gffSkbfBkhVJp8KBolK4E3SR6GbOUpJyuQRfnYbL8KR/BOjDuQntnZM3FZQqEnw==",

4842− "dev": true,

4843 "requires": {

5118 "requires": {

4844 "color": "^4.2.3",

5119 "color": "^4.2.3",

4845 "postcss": "^8.4.12",

5120 "postcss": "^8.4.12",

@@ -4895,7 +5170,6 @@

4895 "version": "1.0.10",

5170 "version": "1.0.10",

4896 "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.0.10.tgz",

5171 "resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.0.10.tgz",

4897 "integrity": "sha512-OztqDenkfFkbSG+tRxBeAnCVPckDBcvibKd35yDONx6OU8N7sqgwc7rCbkJ/WcYtVRZ4ba68d6byhC21GFh7sQ==",

5172 "integrity": "sha512-OztqDenkfFkbSG+tRxBeAnCVPckDBcvibKd35yDONx6OU8N7sqgwc7rCbkJ/WcYtVRZ4ba68d6byhC21GFh7sQ==",

4898− "dev": true,

4899 "requires": {

5173 "requires": {

4900 "escalade": "^3.1.1",

5174 "escalade": "^3.1.1",

4901 "picocolors": "^1.0.0"

5175 "picocolors": "^1.0.0"

package.json+3−3

@@ -7,10 +7,10 @@

7 "build": "next build",

8 "export": "npm run prebuild && next build && next export",

9 "start": "next start",

10− "prebuild": "npm run cache-posts && npm run rss && npm run glossary && npm run community-tree && npm run getting-started-tree && npm run overview-tree",

10+ "prebuild": "npm run cache-posts && npm run rss && npm run glossary && npm run getting-started-tree && npm run overview-tree && npm run campus-tree",

11− "community-tree": "node lib/buildPageTree community weight",

12 "getting-started-tree": "node lib/buildPageTree getting-started weight",

11 "getting-started-tree": "node lib/buildPageTree getting-started weight",

13 "overview-tree": "node lib/buildPageTree overview weight",

12 "overview-tree": "node lib/buildPageTree overview weight",

13+ "campus-tree": "node lib/buildPageTree campus weight",

14 "cache-posts": "node lib/cache.js",

15 "glossary": "node lib/buildGlossary.js",

16 "rss": "node lib/rss.js",

@@ -21,7 +21,7 @@

21 "@socialgouv/matomo-next": "^1.3.0",

22 "@tailwindcss/aspect-ratio": "^0.4.0",

23 "@tlon/sigil-js": "^1.4.5",

24− "@urbit/foundation-design-system": "0.6.4",

24+ "@urbit/foundation-design-system": "0.7.3",

25 "@urbit/markdoc": "^0.1.4",

26 "axios": "^0.26.1",

27 "buffer": "^6.0.3",

pages/_app.js+6−2

@@ -1,10 +1,11 @@

1import { useState, useEffect } from "react";

2import { configure, GlobalHotKeys } from "react-hotkeys";

3import { init } from "@socialgouv/matomo-next";

4−import Search from "../components/Search";

4+import { Search } from "@urbit/foundation-design-system";

5import "@urbit/foundation-design-system/styles/globals.css";

6import "@urbit/foundation-design-system/styles/markdown.css";

7import "@urbit/foundation-design-system/styles/prism.css";

8+import Head from "next/head";

8

9

9const MATOMO_URL = process?.env?.NEXT_PUBLIC_MATOMO_URL || "";

10const MATOMO_URL = process?.env?.NEXT_PUBLIC_MATOMO_URL || "";

10const MATOMO_SITE_ID = process?.env?.NEXT_PUBLIC_MATOMO_SITE_ID || "";

11const MATOMO_SITE_ID = process?.env?.NEXT_PUBLIC_MATOMO_SITE_ID || "";

@@ -54,17 +55,20 @@ function MyApp({ Component, pageProps }) {

54 configure({

55 configure({

55 // ignoreTags: [],

56 // ignoreTags: [],

56 ignoreTags: ["input", "select", "textarea"],

57 ignoreTags: ["input", "select", "textarea"],

57− ignoreEventsCondition: function () {},

58+ ignoreEventsCondition: function () { },

58 });

59 });

59

60

60 return (

61 return (

61 <>

62 <>

63+

62 <GlobalHotKeys keyMap={keyMap} handlers={handlers} />

64 <GlobalHotKeys keyMap={keyMap} handlers={handlers} />

63 <Search

65 <Search

64 showSearch={showSearch}

66 showSearch={showSearch}

65 toggleSearch={toggleSearch}

67 toggleSearch={toggleSearch}

66 closeSearch={closeSearch}

68 closeSearch={closeSearch}

67 openSearch={openSearch}

69 openSearch={openSearch}

70+ order={["org", "dev", "ops", "roadmap"]}

71+ ourSite="https://urbit.org"

68 />

72 />

69 <Component

73 <Component

70 {...pageProps}

74 {...pageProps}

pages/api/roadmap-search.jsnew file+8

@@ -0,0 +1,8 @@

1+export default async (req, res) => {

2+ const results = await fetch(

3+ `https://roadmap.urbit.org/api/search?q=${req.query.q}`

4+ ).then((res) => res.json());

5+ res.statusCode = 200;

6+ res.setHeader("Content-Type", "application/json");

7+ res.end(JSON.stringify(results));

8+};

pages/api/urbit-org-search.jsnew file+45

@@ -0,0 +1,45 @@

1+import { index } from "../../cache/data";

2+import { glossary } from "../../cache/glossary";

3+const levenSort = require("leven-sort");

4+

5+export default (req, res) => {

6+ const results = index.filter(

7+ (e) =>

8+ e.title?.toLowerCase().includes(req.query.q.toLowerCase()) ||

9+ e?.slug.includes(req.query.q.toLowerCase()) ||

10+ e?.parent.toLowerCase().includes(req.query.q.toLowerCase())

11+ );

12+

13+ const entries = glossary.filter((entry) => {

14+ return (

15+ entry.name.includes(req.query.q.toLowerCase()) ||

16+ entry.symbol.includes(req.query.q)

17+ );

18+ });

19+

20+ results.push(

21+ ...index

22+ .filter((e) => !results.includes(e))

23+ .filter((e) => {

24+ let found = false;

25+ e.headings.forEach((heading) => {

26+ if (heading.toLowerCase().includes(req.query.q.toLowerCase())) {

27+ found = true;

28+ }

29+ });

30+ return found;

31+ })

32+ .map((e) => ({ ...e, foundOnPage: true }))

33+ );

34+

35+ const sorted = levenSort(results, req.q, [

36+ "title",

37+ "slug",

38+ "parent",

39+ "headings",

40+ ]);

41+ const sortedEntries = levenSort(entries, req.query.q, ["symbol"]);

42+ res.statusCode = 200;

43+ res.setHeader("Content-Type", "application/json");

44+ res.end(JSON.stringify({ results: sorted, glossary: sortedEntries }));

45+};

pages/applications/[[...application]].js+4−2

@@ -111,7 +111,7 @@ const ApplicationPage = ({ data, markdown, organisation, matchedGrants, search,

111 markdown={markdown}

112 />

113 <hr className="text-wall-200" />

114− {matchedGrants && <div className="basis-full flex flex-col space-y-2">

114+ {matchedGrants.length > 0 && <div className="basis-full flex flex-col space-y-2">

115 <p className="font-semibold text-wall-400">Related Grants</p>

116 {matchedGrants.map((grant) => {

117 return <GrantPreview grant={grant} />

@@ -181,7 +181,9 @@ export const getServerSideProps = async ({ params, res }) => {

181 ? JSON.stringify(Markdown.parse({ post: { content } }))

182 : null;

183

184− const matchedGrants = getGrantsByShortcode(params.application) || null;

184+ const matchedGrants = getGrantsByShortcode(params.application)

185+ .filter((e) => !e.extra.canceled)

186+ .sort((a, b) => new Date(b.date) - new Date(a.date))

185

187

186 if (!data.title) {

188 if (!data.title) {

187 data = {

189 data = {

pages/bitcoin.js+7−7

@@ -35,6 +35,12 @@ export default function Bitcoin({ search, posts, data, markdown, events }) {

35 <div>

36 <p>Sound digital money and sound computing need each other to achieve a free and prosperous future, and Urbit and Bitcoin's common paradigm of long-termism and self-sovereignty will get us there. Check out the resources on this page to learn about current Lightning Network development on Urbit and join the Urbitcoiner community.</p>

37 </div>

38+ <div className="mt-32">

39+ <h2 className="mb-8" id="title">{data.title}</h2>

40+ <div className="markdown">

41+ <Markdown.render content={JSON.parse(markdown)} />

42+ </div>

43+ </div>

38 <div className="mt-32">

44 <div className="mt-32">

39 <h2 className="mb-8" id="blog">Blog Posts</h2>

45 <h2 className="mb-8" id="blog">Blog Posts</h2>

40 <TwoUp>

46 <TwoUp>

@@ -59,12 +65,6 @@ export default function Bitcoin({ search, posts, data, markdown, events }) {

59 </a>

65 </a>

60 </Link>

66 </Link>

61 </div>

67 </div>

62− <div className="mt-32">

63− <h2 className="mb-8" id="title">{data.title}</h2>

64− <div className="markdown">

65− <Markdown.render content={JSON.parse(markdown)} />

66− </div>

67− </div>

68 </div>

69 <TableOfContents markdown={false} />

70 </Section>

@@ -95,4 +95,4 @@ export async function getStaticProps() {

95 events

96 }

97 }

98−}

98+}

pages/campus/[[...slug]].jsnew file+312

@@ -0,0 +1,312 @@

1+import Head from "next/head";

2+import Link from "next/link";

3+import { useRouter } from "next/router";

4+import classnames from "classnames";

5+import React from "react";

6+import { DateTime } from "luxon";

7+import {

8+ Container,

9+ Section,

10+ SingleColumn,

11+ TwoUp,

12+ IntraNav,

13+ getAllPosts,

14+ generateRealtimeDate,

15+ getPage,

16+ Markdown,

17+ getPreviousPost,

18+ getNextPost,

19+} from "@urbit/foundation-design-system";

20+import { getAllEvents } from "../../lib/lib";

21+import { join } from 'path';

22+import Header from "../../components/Header";

23+import Footer from "../../components/Footer";

24+import Contact from "../../components/Contact";

25+import PostPreview from "../../components/PostPreview";

26+import EventPreview from "../../components/EventPreview";

27+import Sidebar from "../../components/Sidebar";

28+import { eventKeys } from "../../lib/constants";

29+import IndexCard from "../../components/ecosystem/IndexCard";

30+import HighlightCard from "../../components/HighlightCard";

31+import fs from "fs";

32+import path from "path";

33+import Meta from "../../components/Meta";

34+import campusTree from "../../cache/campus.json";

35+import { matchEcosystemPost } from "../../lib/lib";

36+

37+export default function Home({

38+ posts,

39+ highlights,

40+ ecosystem,

41+ events,

42+ grantNumbers,

43+ search,

44+ data,

45+ markdown,

46+}) {

47+ const post = {

48+ title: "Urbit",

49+ description: "A clean-slate OS and network for the 21st century.",

50+ image: "https://storage.googleapis.com/media.urbit.org/site/opengraph/urbit.png"

51+ };

52+ return (

53+ <Container>

54+ <Head>

55+ <title>Urbit</title>

56+ {Meta(post, false, true)}

57+ </Head>

58+ <IntraNav ourSite="https://urbit.org" search={search} />

59+

60+ <SingleColumn>

61+ <Header search={search} />

62+

63+ {/* Hero statement */}

64+ <Section className="pb-6">

65+ <div className="flex flex-col space-y-4">

66+ <h1 className="max-w-prose">

67+ Campus Outreach Program

68+ </h1>

69+ <h3 className="max-w-prose">

70+ Leave your mark on the future. Build on Urbit.

71+ </h3>

72+ </div>

73+ </Section>

74+

75+

76+

77+ {/* Brief explanatory paragraph */}

78+ <Section className="sm:flex sm:space-x-8 space-y-8 sm:space-y-0">

79+

80+ <div className="space-y-8">

81+ <div className="space-y-4">

82+ <p className="type-ui max-w-prose">

83+ The Urbit Foundation’s Campus Outreach Program aims to find ambitious students interested in reimagining the possibilities of decentralized systems and networked computing.

84+ </p>

85+

86+ <p className="type-ui max-w-prose">

87+ Do you fit that description and want us to come to your university?{" "}

88+ <Link href="/campus#contact" passHref>

89+ <a>Get in touch.</a>

90+ </Link>{" "}

91+ </p>

92+ </div>

93+

94+

95+ <Link href="https://airtable.com/shrmfUVpMskWw145u" passHref>

96+ <a className="button-lg bg-green-400 text-white type-ui max-w-fit">

97+ Get on Urbit

98+ </a>

99+ </Link>

100+

101+

102+ </div>

103+ </Section>

104+

105+ {/*

106+ how to make an in-page link (href to hashtag element id)

107+ <a href="#events"> cheebo </a>

108+ */}

109+

110+

111+

112+ {

113+ //funnel, repurposed from /overview page:

114+ }

115+ <div id="learn"></div>

116+

117+ <Section>

118+

119+ <h2 className="pb-16">Why use Urbit?</h2>

120+

121+ <div className="flex justify-between sidebar md:space-x-8">

122+ <Sidebar search={search}>

123+ {childPages("/campus", posts.pages)}

124+ </Sidebar>

125+ <div className={'markdown max-w-prose ' + data.slug }>

126+

127+ <h2>{ data.title }</h2>

128+ <Markdown.render content={JSON.parse(markdown)} />

129+ </div>

130+ </div>

131+ </Section>

132+

133+

134+

135+ {

136+ //Events

137+ }

138+

139+ <Section className="pb-1">

140+

141+ <br></br>

142+ <div className="mt-6">

143+ <h2 className="mb-8" id="events">Events</h2>

144+ {events.length > 0 ? (

145+ <TwoUp>

146+ <EventPreview event={events[0]} className="mb-8" />

147+ {events[1] ? <EventPreview event={events[1]} className="mb-8" /> : <div />}

148+ </TwoUp>

149+ ) : (

150+ <p className="pb-8">No events yet — check back later.</p>

151+ )}

152+ <Link href="/events?tag=campus">

153+ <a className="bg-wall-600 text-white button-lg w-fit">

154+ View All

155+ </a>

156+ </Link>

157+ </div>

158+ </Section>

159+

160+ <div id="contact"></div>

161+

162+ <Section className="pb-12">

163+

164+ <div className="bg-wall-100 w-full p-4 md:p-8 rounded-3xl flex flex-wrap items-center">

165+

166+ <div className="sm:pl-2 align-middle">

167+ <h2 className=" text-2xl pb-2" >Get in touch</h2 >

168+ <p className="max-w-prose type-ui pb-4">

169+ Not sure how to get started after attending an event? Want to schedule one at your university?

170+ Don't be a stranger. Reach out at the email below, or{" "}

171+ <Link href="https://urbit.org/groups/~tidren-nosryg/campus-outreach" passHref>

172+ <a>find us on Urbit.</a>

173+ </Link>{" "}

174+ </p>

175+ <Link href="mailto:campus@urbit.org">

176+ <a className="button-sm border-2 border-wall-600 text-wall-600 type-sm max-w-fit">

177+ campus@urbit.org

178+ </a>

179+ </Link>

180+ </div>

181+ </div>

182+ </Section>

183+

184+

185+

186+

187+ </SingleColumn>

188+

189+

190+

191+ <Footer />

192+ </Container>

193+ );

194+}

195+

196+const childPages = (thisLink, children, level = 0) => {

197+ const router = useRouter();

198+

199+ const isThisPage = router.asPath === thisLink || router.asPath === `${thisLink}#learn`;

200+

201+ const pageItemClasses = classnames({

202+ "text-base type-ui": level === 0,

203+ "text-wall-400": !isThisPage,

204+ "text-black": isThisPage,

205+ });

206+ return (

207+ <ul className="">

208+ <li className="pb-2">

209+ <Link href="/campus#learn">

210+ <a className={`${pageItemClasses} cursor-pointer`}>Software Developers</a>

211+ </Link>

212+ </li>

213+ {children?.map((child) => (

214+ <li className="pb-2">

215+ {pageTree(join(thisLink, child.slug), child, level)}

216+ </li>

217+ ))}

218+ </ul>

219+ );

220+};

221+

222+const pageTree = (thisLink, tree, level = 0) => {

223+ const router = useRouter();

224+

225+

226+ const isThisPage = router.asPath.includes(thisLink);

227+

228+ const pageItemClasses = classnames({

229+ "text-base type-ui": level === 0,

230+ "text-wall-400": !isThisPage,

231+ "text-black": isThisPage,

232+ });

233+

234+ return (

235+ <>

236+ <Link href={thisLink + "#learn"}>

237+ <a className={`${pageItemClasses} cursor-pointer`}>{tree.title}</a>

238+ </Link>

239+ </>

240+ );

241+};

242+

243+export async function getStaticPaths() {

244+ const posts = campusTree;

245+

246+ const slugs = [];

247+

248+ const allHrefs = (thisLink, tree) => {

249+ slugs.push(thisLink, ...tree.pages.map((e) => join(thisLink, e.slug)));

250+ allHrefsChildren(thisLink, tree.children);

251+ };

252+

253+ const allHrefsChildren = (thisLink, children) => {

254+ Object.entries(children).map(([childSlug, child]) => {

255+ allHrefs(join(thisLink, childSlug), child);

256+ });

257+ };

258+

259+ allHrefs("/campus", posts);

260+

261+ return {

262+ paths: slugs,

263+ fallback: false,

264+ };

265+}

266+

267+export async function getStaticProps({ params }) {

268+ const posts = campusTree;

269+

270+ const { data, content } = getPage(

271+ join(process.cwd(), "content/campus", params.slug?.join("/") || "/")

272+ );

273+ const markdown = JSON.stringify(Markdown.parse({ post: { content } }));

274+

275+ const previousPost =

276+ getPreviousPost(

277+ params.slug?.slice(-1).join("") || "campus",

278+ ["title", "slug", "weight"],

279+ join("campus", params.slug?.slice(0, -1).join("/") || "/"),

280+ "weight"

281+ ) || null;

282+

283+ const nextPost =

284+ getNextPost(

285+ params.slug?.slice(-1).join("") || "campus",

286+ ["title", "slug", "weight"],

287+ join("campus", params.slug?.slice(0, -1).join("/") || "/"),

288+ "weight"

289+ ) || null;

290+

291+ const allEvents = getAllEvents(eventKeys, "events");

292+ const events = allEvents.filter((e) => e?.tags?.includes("campus")) || [];

293+

294+ return { props: { posts, data, markdown, params, previousPost, nextPost, events } };

295+}

296+

297+

298+

299+/* export async function getStaticProps() {

300+

301+

302+ const events = getAllEvents(eventKeys, "events").filter((e) => e?.tags?.includes("campus"));

303+

304+ // const { data, content } = getPage(join(process.cwd(), 'content', 'bitcoin'));

305+

306+ return {

307+ props: {

308+ events

309+ }

310+ }

311+}

312+ */

pages/communities/[slug].jsnew file+87

@@ -0,0 +1,87 @@

1+import BasicPage from "../../components/ecosystem/BasicPage";

2+import {

3+ Markdown,

4+ getAllPosts,

5+ getPostBySlug,

6+ getPostSlugs,

7+} from "@urbit/foundation-design-system";

8+import Link from "next/link";

9+

10+export default function Community({

11+ post,

12+ markdown,

13+ search,

14+ index,

15+ spotlights = [],

16+}) {

17+ return (

18+ <BasicPage

19+ section="Community"

20+ post={post}

21+ markdown={markdown}

22+ search={search}

23+ index={index}

24+ >

25+ {spotlights.length > 0 && (

26+ <p>

27+ Featured in{" "}

28+ {spotlights.map((e, i) => (

29+ <>

30+ {i ? ", " : ""}

31+ <Link href={`/ecosystem/spotlight/${e.slug}`}>{e.title}</Link>

32+ </>

33+ ))}

34+ </p>

35+ )}

36+

37+ <p>––</p>

38+ <p>Interested in starting an Urbit meetup? <a href="/grants/community-meetups">Learn more here</a>.</p>

39+ </BasicPage>

40+ );

41+}

42+

43+export async function getStaticProps({ params }) {

44+ const post = getPostBySlug(

45+ params.slug,

46+ ["title", "description", "slug", "image", "content"],

47+ "communities"

48+ );

49+

50+ const spotlights = getAllPosts(

51+ ["title", "slug", "featured-1", "featured-2", "featured-3"],

52+ "ecosystem/spotlight"

53+ ).filter(

54+ (e) =>

55+ e?.["featured-1"]?.title === post.title ||

56+ e?.["featured-2"]?.title === post.title ||

57+ e?.["featured-3"]?.title === post.title

58+ );

59+

60+ let { index } = post?.extra || { index: null };

61+

62+ if (index === undefined) {

63+ index = null;

64+ }

65+

66+ const markdown = JSON.stringify(Markdown.parse({ post }));

67+ return {

68+ props: { post, markdown, spotlights, index },

69+ };

70+}

71+

72+export async function getStaticPaths() {

73+ const posts = getPostSlugs("communities");

74+

75+ const slugs = posts.map((e) => e.slice(0, -3));

76+

77+ return {

78+ paths: slugs.map((post) => {

79+ return {

80+ params: {

81+ slug: post,

82+ },

83+ };

84+ }),

85+ fallback: false,

86+ };

87+}

pages/community/[[...slug]].jsdeleted−121

@@ -1,121 +0,0 @@

1−import Head from "next/head";

2−import Link from "next/link";

3−import { useRouter } from "next/router";

4−import classnames from "classnames";

5−import { join } from "path";

6−import Meta from "../../components/Meta";

7−import { Markdown, getPage } from "@urbit/foundation-design-system";

8−import ContentArea from "../../components/ContentArea";

9−import Sidebar from "../../components/DocsSidebar";

10−import communityTree from "../../cache/community.json";

11−

12−const breadcrumbs = (posts, paths) => {

13− const results = [

14− <Link href="/">Urbit</Link>,

15− <span className="px-1">/</span>,

16− <Link href="/community">Community</Link>,

17− ];

18− let thisLink = "/community";

19− for (const path of paths) {

20− posts = posts.children[path];

21− thisLink = join(thisLink, path);

22− results.push(

23− <span className="px-1">/</span>,

24− <Link href={thisLink}>{posts.title}</Link>

25− );

26− }

27− return results;

28−};

29−

30−const childPages = (thisLink, children, level = 0) => (

31− <ul className="pl-1">

32− {children?.map((child) => (

33− <li>{pageTree(join(thisLink, child.slug), child, level)}</li>

34− ))}

35− </ul>

36−);

37−

38−const pageTree = (thisLink, tree, level = 0) => {

39− const router = useRouter();

40−

41− const isThisPage = router.asPath === thisLink;

42−

43− const pageItemClasses = classnames({

44− "pl-4 text-wall-600 text-base hover:text-green-400": level === 0,

45− "pl-8 text-wall-600 text-base hover:text-green-400": level === 1,

46− "pl-12 text-wall-600 text-base hover:text-green-400": level === 2,

47− "dot relative": isThisPage,

48− "text-green-400": isThisPage,

49− });

50−

51− return (

52− <>

53− <Link href={thisLink}>

54− <a className={`${pageItemClasses} cursor-pointer`}>{tree.title}</a>

55− </Link>

56− </>

57− );

58−};

59−

60−export default function UsingLayout({ posts, data, markdown, params, search }) {

61− return (

62− <>

63− <Head>

64− <title>{data.title} • Community</title>

65− {Meta(data)}

66− </Head>

67− <div className="flex h-screen min-h-screen w-screen sidebar">

68− <Sidebar search={search}>

69− {childPages("/community", posts.pages)}

70− </Sidebar>

71− <ContentArea

72− breadcrumbs={breadcrumbs(posts, params.slug?.slice(0, -1) || "")}

73− title={data.title}

74− search={search}

75− section={"Community"}

76− params={params}

77− >

78− <div className="markdown">

79− <Markdown.render content={JSON.parse(markdown)} />

80− </div>

81− </ContentArea>

82− </div>

83− </>

84− );

85−}

86−

87−export async function getStaticProps({ params }) {

88− const posts = communityTree;

89−

90− const { data, content } = getPage(

91− join(process.cwd(), "content/community", params.slug?.join("/") || "/")

92− );

93−

94− const markdown = JSON.stringify(Markdown.parse({ post: { content } }));

95−

96− return { props: { posts, data, markdown, params } };

97−}

98−

99−export async function getStaticPaths() {

100− const posts = communityTree;

101−

102− const slugs = [];

103−

104− const allHrefs = (thisLink, tree) => {

105− slugs.push(thisLink, ...tree.pages.map((e) => join(thisLink, e.slug)));

106− allHrefsChildren(thisLink, tree.children);

107− };

108−

109− const allHrefsChildren = (thisLink, children) => {

110− Object.entries(children).map(([childSlug, child]) => {

111− allHrefs(join(thisLink, childSlug), child);

112− });

113− };

114−

115− allHrefs("/community", posts);

116−

117− return {

118− paths: slugs,

119− fallback: false,

120− };

121−}

pages/decentralized-discord.js+3−8

@@ -184,11 +184,11 @@ export default function DiscordLanding({ search, featuredGroups }) {

184 title="Join a Group"

185 description={

186 <p>

187− The easiest way to jump on the network is to download our

187+ The easiest way to jump on the network is to download Urbit

188− desktop application and boot up a comet - a Temporary ID.

188+ and boot up a comet - a Temporary ID.

189 </p>

190 }

191− href="https://urbit.org/getting-started/desktop"

191+ href="https://urbit.org/getting-started"

192 />

193 </TwoUp>

194 <div className="flex items-center space-x-4 w-full">

@@ -281,11 +281,6 @@ export async function getStaticProps() {

281 ["title", "slug", "shortcode", "description", "tile"],

282 "groups/~tirrel"

283 ),

284− getPostBySlug(

285− "group-discovery",

286− ["title", "slug", "shortcode", "description", "tile"],

287− "groups/~rondev"

288− ),

289 getPostBySlug(

284 getPostBySlug(

290 "other-life",

285 "other-life",

291 ["title", "slug", "shortcode", "description", "tile"],

286 ["title", "slug", "shortcode", "description", "tile"],

pages/ecosystem/index.js+200−263

@@ -6,7 +6,6 @@ import {

6 SingleColumn,

7 Section,

8 IntraNav,

9− Markdown,

10 getAllPosts,

9 getAllPosts,

11 generateDisplayDate,

10 generateDisplayDate,

12 formatDate,

11 formatDate,

@@ -14,12 +13,15 @@ import {

14import Header from "../../components/Header";

13import Header from "../../components/Header";

15import Footer from "../../components/Footer";

14import Footer from "../../components/Footer";

16import Sidebar from "../../components/Sidebar";

15import Sidebar from "../../components/Sidebar";

16+import EcosystemSidebar from "../../components/ecosystem/EcosystemSidebar";

17+import SpotlightArchive from "../../components/ecosystem/SpotlightArchive";

17import Post from "../../components/ecosystem/Post";

18import Post from "../../components/ecosystem/Post";

18import classnames from "classnames";

19import classnames from "classnames";

19import Link from "next/link";

20import Link from "next/link";

20import fs from "fs";

21import fs from "fs";

21import path from "path";

22import path from "path";

22import Contact from "../../components/Contact";

23import Contact from "../../components/Contact";

24+import { matchEcosystemPost } from "../../lib/lib";

23

25

24export default function Ecosystem({

26export default function Ecosystem({

25 search,

27 search,

@@ -30,22 +32,34 @@ export default function Ecosystem({

30 marketplaces,

32 marketplaces,

31 organizations,

33 organizations,

32 podcasts,

34 podcasts,

33− articles

35+ articles,

36+ communities

34}) {

37}) {

35 const router = useRouter();

38 const router = useRouter();

36

39

37 const { type } = router.query;

40 const { type } = router.query;

38

41

42+ // Route ?type=archive to below component;

43+ // otherwise, show directory of ecosystem type

44+ // If no param, we show the spotlight for the month

39 if (type === "archive") {

45 if (type === "archive") {

40 return <SpotlightArchive posts={posts} search={search} />;

46 return <SpotlightArchive posts={posts} search={search} />;

41 }

47 }

42

48

49+ const spotlight = type === undefined;

50+

43 let title;

51 let title;

44 if (type) {

52 if (type) {

45 switch (type) {

53 switch (type) {

46 case "applications":

54 case "applications":

47 title = "Applications • Ecosystem";

55 title = "Applications • Ecosystem";

48 break;

56 break;

57+ case "communities":

58+ title = "Communities • Ecosystem";

59+ break;

60+ case "applications":

61+ title = "Groups • Ecosystem";

62+ break;

49 case "marketplaces":

63 case "marketplaces":

50 title = "Marketplaces • Ecosystem";

64 title = "Marketplaces • Ecosystem";

51 break;

65 break;

@@ -88,21 +102,19 @@ export default function Ecosystem({

88 </Sidebar>

102 </Sidebar>

89 <div

103 <div

90 className={classnames("w-full", {

104 className={classnames("w-full", {

91− "max-w-prose": type === undefined,

105+ "max-w-prose": spotlight,

92 })}

106 })}

93 >

107 >

94− {type === undefined && (

108+ {/* Default layout */}

95− <h3>{`Ecosystem Spotlight - ${post.title}`}</h3>

109+ {spotlight && (

96− )}

97− {type === undefined && (

98 <>

110 <>

111+ <h3>{`Ecosystem Spotlight - ${post.title}`}</h3>

99 <Post post={post} />

112 <Post post={post} />

100 <Link href="/ecosystem/?type=archive" passHref>

113 <Link href="/ecosystem/?type=archive" passHref>

101 <a className="button-lg bg-wall-600 text-white w-fit">

114 <a className="button-lg bg-wall-600 text-white w-fit">

102 Spotlight Archive

115 Spotlight Archive

103 </a>

116 </a>

104 </Link>

117 </Link>

105−

106 <div className="pt-36">

118 <div className="pt-36">

107 <h3 className="pb-2">Urbit Monthly</h3>

119 <h3 className="pb-2">Urbit Monthly</h3>

108 <p className="pb-8">

120 <p className="pb-8">

@@ -113,126 +125,38 @@ export default function Ecosystem({

113 </div>

125 </div>

114 </>

126 </>

115 )}

127 )}

116−

128+ {/* Ecosystem type layouts */}

117 <div

129 <div

118 className={classnames("grid gap-12 w-full", {

130 className={classnames("grid gap-12 w-full", {

119− "grid-cols-2 md:grid-cols-3": type == "organizations" || type == "marketplaces",

120 "grid-cols-1": type === "podcasts" || type === "articles",

131 "grid-cols-1": type === "podcasts" || type === "articles",

121 "grid-cols-1 md:grid-cols-1 lg:grid-cols-1 xl:grid-cols-2":

132 "grid-cols-1 md:grid-cols-1 lg:grid-cols-1 xl:grid-cols-2":

122− type === "applications" || type === "groups",

133+ type === "applications" || type === "groups" || type === "communities" || type === "organizations" || type === "marketplaces",

123− hidden: type === undefined,

134+ hidden: spotlight,

124 })}

135 })}

125 >

136 >

126 {type === "organizations" &&

137 {type === "organizations" &&

127− organizations.map((org) => (

128− <Link href={`/organizations/${org.slug}`}>

138+ <Organizations dir={organizations} />

129− <div className="flex flex-col space-y-4 items-center cursor-pointer hover:opacity-90">

130− <img className="w-36 rounded-xl" src={org.image} />

131− <p className="text-center font-bold">{org.title}</p>

132− </div>

133− </Link>

134− ))}

139+ }

135

140

136 {type === "applications" &&

141 {type === "applications" &&

137− applications.map((app) => (

142+ <Applications dir={applications} />

138− <Link href={`/applications/${app.ship}/${app.slug}`}>

143+ }

139− <div className="flex space-x-4 items-center cursor-pointer hover:opacity-90">

144+ {type === "communities" &&

140− <div

145+ <Communities dir={communities} />

141− className="h-36 w-36 rounded-xl items-center justify-center shrink-0 overflow-hidden"

142− style={{

143− backgroundColor: app?.bgColor || "rgba(0,0,0,0)",

144− }}

145− >

146− {app?.image && (

147− <img

148− className="items-center h-36 w-36"

149− src={app.image}

150− />

151− )}

152− </div>

153− <div className="">

154− <p className="text-left font-bold">{app.title}</p>

155− <p className="text-left text-wall-400 font-light">

156− {app.description}

157− </p>

158− </div>

159− </div>

160− </Link>

161− ))}

146+ }

162 {type === "groups" &&

147 {type === "groups" &&

163− groups.map((group) => (

148+ <Groups dir={groups} />

164− <Link href={`/groups/${group.ship}/${group.slug}`}>

165− <div className="flex space-x-4 items-center cursor-pointer hover:opacity-90">

166− <div

167− className="h-36 w-36 rounded-xl items-center justify-center shrink-0 overflow-hidden"

168− style={{

169− backgroundColor: group?.tile?.startsWith("#")

170− ? group?.tile

171− : "rgba(0,0,0,0)",

172− }}

173− >

174− {!group?.tile?.startsWith("#") && (

175− <img

176− className="items-center h-36 w-36"

177− src={group.tile}

178− />

179− )}

180− </div>

181− <div className="">

182− <p className="text-left font-bold">{group.title}</p>

183− <p className="text-left text-wall-400 font-light">

184− {group.description}

185− </p>

186− </div>

187− </div>

188− </Link>

189− ))}

149+ }

190 {type === "marketplaces" &&

150 {type === "marketplaces" &&

191− marketplaces.map((market) => (

192− <Link href={`/marketplaces/${market.slug}`}>

151+ <Marketplaces dir={marketplaces} />

193− <div className="flex flex-col space-y-4 justify-center items-center cursor-pointer hover:opacity-90">

194− <img className="w-36 rounded-xl" src={market.image} />

195− <p className="text-center font-bold">{market.title}</p>

196− </div>

197− </Link>

198− ))}

152+ }

199 {type === "podcasts" &&

153 {type === "podcasts" &&

200− podcasts.map((pod) => (

154+ <Podcasts dir={podcasts} />

201− <Link href={`/podcasts/${pod.slug}`}>

202− <div className="flex cursor-pointer space-x-4 items-center hover:opacity-90">

203− <img className="w-28" src={pod.image} />

204− <div className="flex flex-col space-y-2 min-w-0">

205− <p className="font-bold">{pod.podcast}</p>

206− <p className="min-w-0 min-h-0 leading-5 ">

207− {pod.title}

208− </p>

209− <p className="text-wall-400">

210− {formatDate(generateDisplayDate(pod.date))}

211− </p>

212− </div>

213− </div>

214− </Link>

215− ))}

155+ }

216

156

217 {type === "articles" &&

157 {type === "articles" &&

218− articles.map((article) => (

158+ <Articles dir={articles} />

219− <Link href={`/articles/${article.slug}`}>

159+ }

220− <div className="flex cursor-pointer space-x-4 items-center hover:opacity-90">

221− <img className="w-28" src={article.image} />

222− <div className="flex flex-col space-y-2 min-w-0">

223− <p className="font-bold">{article.publication}</p>

224− <p className="min-w-0 min-h-0 leading-5 ">

225− {article.title}

226− </p>

227− <p className="text-wall-400">

228− {formatDate(generateDisplayDate(article.date))}

229− </p>

230− </div>

231− </div>

232− </Link>

233− ))}

234−

235−

236 </div>

160 </div>

237 </div>

161 </div>

238 </div>

162 </div>

@@ -243,154 +167,186 @@ export default function Ecosystem({

243 );

167 );

244}

168}

245

169

246−function ActiveLink({ children, href, className, currentPath }) {

247− // special casing this behaviour which overloads one nav

248− const archive = Boolean(

249− currentPath === "/ecosystem?type=archive" && href === "/ecosystem"

250− );

251− const activeClassName = classnames({

252− "text-wall-800": currentPath === href || archive,

253− "text-wall-400": currentPath !== href && !archive,

254− });

255

170

171+const Applications = ({ dir }) => {

256− return (

172+ return dir.map((app) => (

257− <Link href={href} passHref>

173+ <Link href={`/applications/${app.ship}/${app.slug}`}>

258− <a className={`${className} ${activeClassName}`}>{children}</a>

174+ <div className="flex space-x-4 items-center cursor-pointer hover:opacity-90">

175+ <div

176+ className="h-36 w-36 rounded-xl items-center justify-center shrink-0 overflow-hidden"

177+ style={{

178+ backgroundColor: app?.bgColor || "rgba(0,0,0,0)",

179+ }}

180+ >

181+ {app?.image && (

182+ <img

183+ className="items-center h-36 w-36"

184+ src={app.image}

185+ />

186+ )}

187+ </div>

188+ <div className="">

189+ <p className="text-left font-bold">{app.title}</p>

190+ <p className="text-left text-wall-400 font-light">

191+ {app.description}

192+ </p>

193+ </div>

194+ </div>

259 </Link>

195 </Link>

260− );

196+ ))

261}

197}

262

198

263−function EcosystemSidebar() {

199+const Groups = ({ dir }) => {

264− const router = useRouter();

265− let currentPath = router.asPath;

266− return (

200+ return dir.map((group) => (

201+ <Link href={`/groups/${group.ship}/${group.slug}`}>

267− <div className="flex flex-col space-y-4 pr-24">

202+ <div className="flex space-x-4 items-center cursor-pointer hover:opacity-90">

268− <ActiveLink

203+ <div

269− currentPath={currentPath}

204+ className="h-36 w-36 rounded-xl items-center justify-center shrink-0 overflow-hidden"

270− className="type-ui"

205+ style={{

271− href="/ecosystem"

206+ backgroundColor: group?.tile?.startsWith("#")

272− >

207+ ? group?.tile

273− Spotlight

208+ : "rgba(0,0,0,0)",

274− </ActiveLink>

209+ }}

275− <ActiveLink

210+ >

276− currentPath={currentPath}

211+ {!group?.tile?.startsWith("#") && (

277− className="type-ui"

212+ <img

278− href="/ecosystem?type=organizations"

279− >

280− Organizations

281− </ActiveLink>

282− <ActiveLink

283− currentPath={currentPath}

284− className="type-ui"

285− href="/ecosystem?type=applications"

286− >

287− Applications

288− </ActiveLink>

289− <ActiveLink

290− currentPath={currentPath}

291− className="type-ui"

213+ className="items-center h-36 w-36"

292− href="/ecosystem?type=groups"

214+ src={group.tile}

293− >

215+ />

294− Groups

216+ )}

295− </ActiveLink>

217+ </div>

296− <ActiveLink

297− currentPath={currentPath}

298− className="type-ui"

218+ <div className="">

299− href="/ecosystem?type=marketplaces"

219+ <p className="text-left font-bold">{group.title}</p>

300− >

220+ <p className="text-left text-wall-400 font-light">

301− Marketplaces

221+ {group.description}

302− </ActiveLink>

303− <ActiveLink

304− currentPath={currentPath}

305− className="mr-5 type-ui"

306− href="/ecosystem?type=podcasts"

307− >

222+ </p>

308− Podcasts

223+ </div>

309− </ActiveLink>

224+ </div>

225+ </Link>

226+ ))

227+}

310

228

311− <ActiveLink

312− currentPath={currentPath}

313− className="mr-5 type-ui"

314− href="/ecosystem?type=articles"

315− >

316− Articles

317− </ActiveLink>

318

229

230+const Podcasts = ({ dir }) => {

231+ return dir.map((pod) => (

232+ <Link href={`/podcasts/${pod.slug}`}>

233+ <div className="flex cursor-pointer space-x-4 items-center hover:opacity-90">

234+ <img className="w-28" src={pod.image} />

235+ <div className="flex flex-col space-y-2 min-w-0">

236+ <p className="font-bold">{pod.podcast}</p>

237+ <p className="min-w-0 min-h-0 leading-5 ">

238+ {pod.title}

239+ </p>

240+ <p className="text-wall-400">

241+ {formatDate(generateDisplayDate(pod.date))}

242+ </p>

243+ </div>

244+ </div>

245+ </Link>

246+ ))

247+}

319

248

249+const Articles = ({ dir }) => {

250+ return dir.map((article) => (

251+ <Link href={`/articles/${article.slug}`}>

252+ <div className="flex cursor-pointer space-x-4 items-center hover:opacity-90">

253+ <img className="w-28" src={article.image} />

254+ <div className="flex flex-col space-y-2 min-w-0">

255+ <p className="font-bold">{article.publication}</p>

256+ <p className="min-w-0 min-h-0 leading-5 ">

257+ {article.title}

258+ </p>

259+ <p className="text-wall-400">

260+ {formatDate(generateDisplayDate(article.date))}

261+ </p>

262+ </div>

320− </div>

263+ </div>

264+ </Link>

321− );

265+ ))

322}

266}

323

267

324−function SpotlightArchive({ posts, search }) {

268+const Communities = ({ dir }) => {

325− const post = {

269+ return dir.map((community) => (

326− title: "Spotlight Archive",

270+ <Link href={`/communities/${community.slug}`}>

327− description: "The archive of ecosystem spotlights.",

271+ <div className="flex space-x-4 items-center cursor-pointer hover:opacity-90">

328− };

272+ <div className="h-36 w-36 rounded-xl items-center justify-center shrink-0 overflow-hidden">

329− return (

273+ <img

330− <Container>

274+ className="items-center h-36 w-36"

331− <Head>

275+ src={community.image}

332− <title>Archive • Spotlight • Urbit</title>

276+ />

333− {Meta(post)}

277+ </div>

334− </Head>

278+ <div className="">

335− <IntraNav ourSite="https://urbit.org" search={search} />

279+ <p className="text-left font-bold">{community.title}</p>

336− <SingleColumn>

280+ <p className="text-left text-wall-400 font-light">

337− <Header search={search} />

281+ {community.description}

338− <Section>

282+ </p>

339− <div className="measure">

283+ </div>

340− <h1>Ecosystem</h1>

341− </div>

284+ </div>

342− </Section>

285+ </Link>

343− <Section className="flex">

286+ ))

344− <Sidebar>

287+}

345− <EcosystemSidebar />

288+

346− </Sidebar>

289+

347− <div>

290+const Marketplaces = ({ dir }) => {

348− <h3 className="mb-12">Spotlight Archive</h3>

291+ return dir.map((market) => (

349− {posts.map((post) => {

292+ <Link href={`/marketplaces/${market.slug}`}>

350− return (

293+ <div className="flex space-x-4 items-center cursor-pointer hover:opacity-90">

351− <div key={post.slug} className="mb-24 cursor-pointer">

294+ <div className="h-36 w-36 rounded-xl items-center justify-center shrink-0 overflow-hidden">

352− <Link href={`/ecosystem/spotlight/${post.slug}`}>

295+ <img

296+ className="items-center h-36 w-36"

297+ src={market.image}

298+ />

299+ </div>

353− <div>

300+ <div className="">

354− <h3 className="text-green-400">{post.title}</h3>

301+ <p className="text-left font-bold">{market.title}</p>

355− <div className="type-ui mt-2">

302+ <p className="text-left text-wall-400 font-light">

356− {["featured-1", "featured-2", "featured-3"].map(

303+ {market.description}

357− (feat, i) => {

304+ </p>

358− if (post?.[feat]) {

305+ </div>

359− return (

306+ </div>

360− <>

307+ </Link>

361− {i ? ", " : ""}

362− <span>{post[feat].title}</span>

363− </>

364− );

365− }

366− }

367− )}

368− </div>

369− </div>

370− </Link>

371− </div>

372− );

373− })}

374− </div>

375− </Section>

376− </SingleColumn>

377− <Footer />

378− </Container>

379− );

308+ ))

380}

309}

381

310

311+const Organizations = ({ dir }) => {

312+ return dir.map((org) => (

313+ <Link href={`/organizations/${org.slug}`}>

314+ <div className="flex space-x-4 items-center cursor-pointer hover:opacity-90">

315+ <div className="h-36 w-36 rounded-xl items-center justify-center shrink-0 overflow-hidden">

316+ <img

317+ className="items-center h-36 w-36"

318+ src={org.image}

319+ />

320+ </div>

321+ <div className="">

322+ <p className="text-left font-bold">{org.title}</p>

323+ <p className="text-left text-wall-400 font-light">

324+ {org.description}

325+ </p>

326+ </div>

327+ </div>

328+ </Link>

329+ ))

330+}

331+

332+

333+

334+

335+

336+

382−export async function getStaticProps({}) {

337+export async function getStaticProps() {

383 const posts = getAllPosts(

338 const posts = getAllPosts(

384 ["title", "date", "slug", "featured-1", "featured-2", "featured-3"],

339 ["title", "date", "slug", "featured-1", "featured-2", "featured-3"],

385 "ecosystem/spotlight",

340 "ecosystem/spotlight",

386 "date"

341 "date"

387 );

342 );

388− let post = getAllPosts(

343+ const post = matchEcosystemPost(getAllPosts(

389 ["title", "date", "featured-1", "featured-2", "featured-3"],

344 ["title", "date", "featured-1", "featured-2", "featured-3"],

390 "ecosystem/spotlight",

345 "ecosystem/spotlight",

391 "date"

346 "date"

392− )[0];

347+ )[0]);

393 const marketplaces = getAllPosts(["title", "image", "slug"], "marketplaces");

348 const marketplaces = getAllPosts(["title", "image", "slug"], "marketplaces");

349+ const communities = getAllPosts(["title", "image", "slug", "description"], "communities");

394 const podcasts = getAllPosts(

350 const podcasts = getAllPosts(

395 ["title", "image", "date", "podcast", "slug"],

351 ["title", "image", "date", "podcast", "slug"],

396 "podcasts",

352 "podcasts",

@@ -444,26 +400,6 @@ export async function getStaticProps({}) {

444 return nameA < nameB ? -1 : 1;

400 return nameA < nameB ? -1 : 1;

445 });

401 });

446

402

447− ["featured-1", "featured-2", "featured-3"].forEach((feat) => {

448− if (post?.[feat]) {

449− const matchedPost = [

450− ...applications.map((e) => ({ ...e, type: "Application" })),

451− ...organizations.map((e) => ({ ...e, type: "Organization" })),

452− ...podcasts.map((e) => ({ ...e, type: "Podcast" })),

453− ...articles.map((e) => ({ ...e, type: "Article" })),

454− ...marketplaces.map((e) => ({ ...e, type: "Marketplace" })),

455− ].filter((e) => e.title === post[feat].title)?.[0];

456− post[feat].image = post[feat]?.image || matchedPost?.image || null;

457− post[feat].type = matchedPost?.type || "Podcast";

458− post[feat].matchedPost = matchedPost || null;

459− post[feat].content = JSON.stringify(

460− Markdown.parse({

461− post: { content: post[feat].content },

462− })

463− );

464− }

465− });

466−

467 return {

403 return {

468 props: {

404 props: {

469 posts,

405 posts,

@@ -473,7 +409,8 @@ export async function getStaticProps({}) {

473 marketplaces,

409 marketplaces,

474 podcasts,

410 podcasts,

475 organizations,

411 organizations,

476− articles

412+ articles,

413+ communities

477 },

414 },

478 };

415 };

479}

416}

pages/ecosystem/spotlight/[slug].js+3−59

@@ -6,7 +6,6 @@ import {

6 Container,

7 SingleColumn,

8 Section,

9− Markdown,

10 IntraNav,

9 IntraNav,

11 getAllPosts,

10 getAllPosts,

12 getPostBySlug,

11 getPostBySlug,

@@ -14,8 +13,7 @@ import {

14import Header from "../../../components/Header";

13import Header from "../../../components/Header";

15import Footer from "../../../components/Footer";

14import Footer from "../../../components/Footer";

16import Post from "../../../components/ecosystem/Post";

15import Post from "../../../components/ecosystem/Post";

17−import fs from "fs";

16+import { matchEcosystemPost } from "../../../lib/lib";

18−import path from "path";

19

17

20export default function BasicPage({ post, markdown, search, index = false }) {

18export default function BasicPage({ post, markdown, search, index = false }) {

21 const router = useRouter();

19 const router = useRouter();

@@ -44,65 +42,11 @@ export default function BasicPage({ post, markdown, search, index = false }) {

44}

42}

45

43

46export async function getStaticProps({ params }) {

44export async function getStaticProps({ params }) {

47− const post = getPostBySlug(

45+ const post = matchEcosystemPost(getPostBySlug(

48 params.slug,

46 params.slug,

49 ["title", "slug", "date", "featured-1", "featured-2", "featured-3"],

47 ["title", "slug", "date", "featured-1", "featured-2", "featured-3"],

50 "ecosystem/spotlight"

48 "ecosystem/spotlight"

51− );

52− const marketplaces = getAllPosts(["title", "image", "slug"], "marketplaces");

53− const podcasts = getAllPosts(

54− ["title", "image", "date", "podcast", "slug"],

55− "podcasts",

56− "date"

57− );

58− const articles = getAllPosts(

59− ["title", "image", "date", "publication", "author", "slug"],

60− "articles",

61− "date"

62− );

63− const organizations = getAllPosts(

64− ["title", "image", "slug"],

65− "organizations"

66− );

67− const applications = fs

68− .readdirSync(path.join(process.cwd(), "content/applications"), {

69− withFileTypes: true,

70− })

71− .filter((f) => f.isDirectory())

72− .map((dir) =>

73− getAllPosts(

74− ["title", "bgColor", "image", "slug", "description"],

75− `applications/${dir.name}`

76− )

77− .map((e) => ({ ...e, ship: dir.name }))

78− .flat()

79− )

80− .flat()

81− .sort((a, b) => {

82− const nameA = a.title.toLowerCase();

83− const nameB = b.title.toLowerCase();

84− return nameA < nameB ? -1 : 1;

85− });

86−

87− ["featured-1", "featured-2", "featured-3"].forEach((feat) => {

88− if (post?.[feat]) {

89− const matchedPost = [

90− ...applications.map((e) => ({ ...e, type: "Application" })),

91− ...organizations.map((e) => ({ ...e, type: "Organization" })),

92− ...podcasts.map((e) => ({ ...e, type: "Podcast" })),

93− ...marketplaces.map((e) => ({ ...e, type: "Marketplace" })),

94− ...articles.map((e) => ({ ...e, type: "Article" })),

95− ].filter((e) => e.title === post[feat].title)?.[0];

96− post[feat].image = post[feat]?.image || matchedPost?.image || null;

97− post[feat].type = matchedPost?.type || "Podcast";

98− post[feat].matchedPost = matchedPost || null;

99− post[feat].content = JSON.stringify(

100− Markdown.parse({

101− post: { content: post[feat].content },

102− })

103− );

104− }

105− });

49+ ));

106

50

107 return {

51 return {

108 props: { post },

52 props: { post },

pages/getting-started/[[...slug]].js+181−183

@@ -22,21 +22,29 @@ export default function UsingLayout({ posts, data, params, search, markdown }) {

22 });

23 };

24

25− let menu = [{ title: "Overview", slug: "", weight: 0 }],

25+ let started = [{ title: "Introduction", slug: "", weight: 0 }],

26− additional = [];

26+ around = [],

27+ selfhost = [],

28+ hostprov = [];

27

29

28 posts.pages.map((post) => {

30 posts.pages.map((post) => {

29− if (post?.tag === "additional") {

31+ if (post?.tag === "around") {

30− additional.push(post);

32+ around.push(post);

31− } else {

33+ } else if (post?.tag === "selfhost") {

34+ selfhost.push(post);

35+ } else if (post?.tag === "hostprov") {

36+ hostprov.push(post);

37+ } else if (post?.tag === "started") {

32− menu.push(post);

38+ started.push(post);

33 }

39 }

34 });

40 });

35

41

42+ started.sort((a, b) => a.weight > b.weight);

43+ selfhost.sort((a, b) => a.weight > b.weight);

36− menu.sort((a, b) => a.weight > b.weight);

44+ hostprov.sort((a, b) => a.weight > b.weight);

37− additional.sort((a, b) => a.weight > b.weight);

45+ around.sort((a, b) => a.weight > b.weight);

38

46

39− const rootClasses = "pl-0 font-semibold text-base hover:text-green-400";

47+ const rootClasses = "pl-0 font-semibold antialiased text-base hover:text-green-400";

40

48

41 return (

49 return (

42 <>

50 <>

@@ -46,11 +54,8 @@ export default function UsingLayout({ posts, data, params, search, markdown }) {

46 </Head>

54 </Head>

47 <div className="flex h-screen min-h-screen w-screen sidebar">

55 <div className="flex h-screen min-h-screen w-screen sidebar">

48 <Sidebar search={search}>

56 <Sidebar search={search}>

49− <p className="uppercase pb-1 font-bold text-xs text-wall-400">

50− Getting Started

51− </p>

52 <ul>

57 <ul>

53− {menu.map((post) => (

58+ {started.map((post) => (

54 <li>

59 <li>

55 <Link href={post.slug} passHref>

60 <Link href={post.slug} passHref>

56 <a className={`relative ${select(post.slug)} ${rootClasses}`}>

61 <a className={`relative ${select(post.slug)} ${rootClasses}`}>

@@ -60,11 +65,39 @@ export default function UsingLayout({ posts, data, params, search, markdown }) {

60 </li>

65 </li>

61 ))}

66 ))}

62 </ul>

67 </ul>

63− <ul className="mt-8">

68+ <ul className="mt-6">

64− <p className="uppercase pb-1 font-bold text-xs text-wall-400">

69+ <p className="uppercase pb-1 font-bold antialiased text-xs text-wall-400">

65− Additional Guides

70+ Run Yourself

66 </p>

71 </p>

72+ {selfhost.map((post) => (

73+ <li>

74+ <Link href={post.slug} passHref>

75+ <a className={`relative ${select(post.slug)} ${rootClasses}`}>

76+ {post.title}

77+ </a>

78+ </Link>

79+ </li>

80+ ))}

81+ </ul>

82+ <ul className="mt-6">

83+ <p className="uppercase pb-1 font-bold antialiased text-xs text-wall-400">

84+ Hosting

85+ </p>

86+ {hostprov.map((post) => (

87+ <li>

88+ <Link href={post.slug} passHref>

89+ <a className={`relative ${select(post.slug)} ${rootClasses}`}>

90+ {post.title}

91+ </a>

92+ </Link>

93+ </li>

94+ ))}

95+ </ul>

96+ <ul className="mt-6">

97+ <p className="uppercase pb-1 font-bold antialiased text-xs text-wall-400">

98+ Getting Around

99+ </p>

67− {additional.map((post) => (

100+ {around.map((post) => (

68 <li>

101 <li>

69 <Link href={post.slug} passHref>

102 <Link href={post.slug} passHref>

70 <a className={`relative ${select(post.slug)} ${rootClasses}`}>

103 <a className={`relative ${select(post.slug)} ${rootClasses}`}>

@@ -87,7 +120,7 @@ export default function UsingLayout({ posts, data, params, search, markdown }) {

87 <div className="markdown">

120 <div className="markdown">

88 <Markdown.render content={JSON.parse(markdown)} />

121 <Markdown.render content={JSON.parse(markdown)} />

89 </div>

122 </div>

90− {!params?.slug && <LaunchCards />}

123+ {/* {!params?.slug && <LaunchCards />} */}

91 </ContentArea>

124 </ContentArea>

92 </div>

125 </div>

93 </>

126 </>

@@ -96,9 +129,7 @@ export default function UsingLayout({ posts, data, params, search, markdown }) {

96

129

97const breadcrumbs = (posts, paths) => {

130const breadcrumbs = (posts, paths) => {

98 const results = [

131 const results = [

99− <Link href="/">Urbit</Link>,

100− <span className="px-1">/</span>,

101− <Link href="/getting-started">Getting Started</Link>,

132+ <Link href="/getting-started">Getting Started</Link>

102 ];

133 ];

103 let thisLink = "/getting-started";

134 let thisLink = "/getting-started";

104 for (const path of paths) {

135 for (const path of paths) {

@@ -112,168 +143,135 @@ const breadcrumbs = (posts, paths) => {

112 return results;

143 return results;

113};

144};

114

145

115−function LaunchCards() {

146+// function LaunchCards() {

116− const info = [

147+// const info = [

117− {

148+// {

118− title: "Hosted urbit",

149+// title: "Hosted urbit",

119− subtitle: "Deploy Urbit on a managed service",

150+// subtitle: "Deploy Urbit on a managed service",

120− points: [

151+// points: [

121− {

152+// {

122− title: "Benefits",

153+// title: "Benefits",

123− content: [

154+// content: [

124− "Accessibility from anywhere",

155+// "Accessibility from anywhere",

125− "Streamlined setup for ownership and identity",

156+// "Streamlined setup for ownership and identity",

126− "No technical proficiency required",

157+// "No technical proficiency required",

127− ],

158+// ],

128− },

159+// },

129− {

160+// {

130− title: "Considerations",

161+// title: "Considerations",

131− content: [

162+// content: [

132− "Requires monthly subscription",

163+// "Requires monthly subscription",

133− "Requires trust in your service provider",

164+// "Requires trust in your service provider",

134− ],

165+// ],

135− },

166+// },

136− ],

167+// ],

137− svg: (

168+// svg: (

138− <svg

169+// <svg

139− width="50"

170+// width="50"

140− height="50"

171+// height="50"

141− viewBox="0 0 50 50"

172+// viewBox="0 0 50 50"

142− fill="none"

173+// fill="none"

143− xmlns="http://www.w3.org/2000/svg"

174+// xmlns="http://www.w3.org/2000/svg"

144− >

175+// >

145− <rect width="50" height="23.1481" rx="10" className="fill-wall-600" />

176+// <rect width="50" height="23.1481" rx="10" className="fill-wall-600" />

146− <rect

177+// <rect

147− y="26.8519"

178+// y="26.8519"

148− width="50"

179+// width="50"

149− height="23.1481"

180+// height="23.1481"

150− rx="10"

181+// rx="10"

151− className="fill-wall-600"

182+// className="fill-wall-600"

152− />

183+// />

153− <ellipse

184+// <ellipse

154− cx="40.4167"

185+// cx="40.4167"

155− cy="11.5741"

186+// cy="11.5741"

156− rx="2.91667"

187+// rx="2.91667"

157− ry="3.24074"

188+// ry="3.24074"

158− className="fill-white"

189+// className="fill-white"

159− />

190+// />

160− <ellipse

191+// <ellipse

161− cx="40.4167"

192+// cx="40.4167"

162− cy="38.4259"

193+// cy="38.4259"

163− rx="2.91667"

194+// rx="2.91667"

164− ry="3.24074"

195+// ry="3.24074"

165− className="fill-white"

196+// className="fill-white"

166− />

197+// />

167− </svg>

198+// </svg>

168− ),

199+// ),

169− href: "https://operators.urbit.org/manual/running/hosting",

200+// href: "/getting-started/hosted",

170− },

201+// },

171− {

202+// {

172− title: "Command line app",

203+// title: "Command line app",

173− subtitle: "Run Urbit from the terminal",

204+// subtitle: "Run Urbit from the terminal",

174− points: [

205+// points: [

175− {

206+// {

176− title: "Benefits",

207+// title: "Benefits",

177− content: ["Greater control", "Reliable", "Smaller footprint"],

208+// content: ["Greater control", "Reliable", "Smaller footprint"],

178− },

209+// },

179− {

210+// {

180− title: "Considerations",

211+// title: "Considerations",

181− content: ["Requires familiarity with the command line"],

212+// content: ["Requires familiarity with the command line"],

182− },

213+// },

183− ],

214+// ],

184− svg: (

215+// svg: (

185− <svg

216+// <svg

186− width="55"

217+// width="55"

187− height="55"

218+// height="55"

188− viewBox="0 0 66 50"

219+// viewBox="0 0 66 50"

189− fill="none"

220+// fill="none"

190− xmlns="http://www.w3.org/2000/svg"

221+// xmlns="http://www.w3.org/2000/svg"

191− >

222+// >

192− <path

223+// <path

193− fill-rule="evenodd"

224+// fill-rule="evenodd"

194− clip-rule="evenodd"

225+// clip-rule="evenodd"

195− d="M52.9288 0.03125H3.07125C1.39393 0.03125 0.03125 1.39393 0.03125 3.07125V52.9288C0.03125 53.7333 0.351879 54.5081 0.921894 55.0781C1.49191 55.6481 2.26671 55.9688 3.07125 55.9688H52.9288C53.7333 55.9688 54.5081 55.6481 55.0781 55.0781C55.6481 54.5081 55.9688 53.7333 55.9688 52.9288V3.07125C55.9688 2.26671 55.6481 1.49189 55.0781 0.921894C54.5081 0.351894 53.7333 0.03125 52.9288 0.03125V0.03125ZM12.8 38.7912L20.78 30.7368L12.8 22.7568L17.1314 18.4254L27.2402 28.6079C27.8191 29.1779 28.1456 29.9586 28.1456 30.7721C28.1456 31.5885 27.8191 32.3693 27.2402 32.9393L17.0577 43.0481L12.8 38.7912ZM38.9425 43.1226H27.0113V37.0426H38.8688L38.9425 43.1226Z"

226+// d="M52.9288 0.03125H3.07125C1.39393 0.03125 0.03125 1.39393 0.03125 3.07125V52.9288C0.03125 53.7333 0.351879 54.5081 0.921894 55.0781C1.49191 55.6481 2.26671 55.9688 3.07125 55.9688H52.9288C53.7333 55.9688 54.5081 55.6481 55.0781 55.0781C55.6481 54.5081 55.9688 53.7333 55.9688 52.9288V3.07125C55.9688 2.26671 55.6481 1.49189 55.0781 0.921894C54.5081 0.351894 53.7333 0.03125 52.9288 0.03125V0.03125ZM12.8 38.7912L20.78 30.7368L12.8 22.7568L17.1314 18.4254L27.2402 28.6079C27.8191 29.1779 28.1456 29.9586 28.1456 30.7721C28.1456 31.5885 27.8191 32.3693 27.2402 32.9393L17.0577 43.0481L12.8 38.7912ZM38.9425 43.1226H27.0113V37.0426H38.8688L38.9425 43.1226Z"

196− className="fill-wall-600"

227+// className="fill-wall-600"

197− />

228+// />

198− </svg>

229+// </svg>

199− ),

230+// ),

200− href: "/getting-started/cli",

231+// href: "/getting-started/cli",

201− },

232+// }

202− {

203− title: "Desktop app",

204− subtitle: "Deploy Urbit on your local system",

205− points: [

206− {

207− title: "Benefits",

208− content: ["Free", "Set up in minutes"],

209− },

210− {

211− title: "Considerations",

212− content: ["Limited functionality with certain applications"],

213− },

214− ],

215− svg: (

216− <svg

217− width="35"

218− height="49"

219− viewBox="0 0 35 49"

220− fill="none"

221− xmlns="http://www.w3.org/2000/svg"

222− >

223− <path

224− d="M7.43609 18.2477H10.856V2.43515C10.8608 1.09 11.9608 1.65662e-05 13.3153 1.65662e-05H21.4235C22.0767 -0.00236832 22.7012 0.252829 23.1623 0.71078C23.6234 1.16632 23.8828 1.7888 23.8828 2.43515V18.2477H27.3123C28.3714 18.2453 29.3393 18.8535 29.7883 19.8075C30.2399 20.7639 30.091 21.8896 29.4089 22.6982L19.4734 34.5206C18.9523 35.1359 18.1837 35.4937 17.3744 35.4937C16.565 35.4937 15.7965 35.136 15.2753 34.5206L5.3325 22.6982C4.64802 21.8896 4.50151 20.7591 4.95304 19.8051C5.40457 18.8511 6.37481 18.2429 7.43635 18.2477H7.43609Z"

225− className="fill-wall-600"

226− />

227− <path

228− d="M0 46.4217V44.5866C0.00657627 43.5411 0.854839 42.6928 1.90369 42.6928H32.8365C33.8853 42.6928 34.7336 43.5411 34.7402 44.5866V46.4217C34.7402 47.4738 33.8886 48.3287 32.8365 48.3352H1.90369C0.851556 48.3286 0 47.4738 0 46.4217Z"

229− className="fill-wall-600"

230− />

231− </svg>

232− ),

233− href: "/getting-started/desktop",

234− },

235− ];

233+// ];

236− return (

234+// return (

237− <div className="flex flex-col space-y-8 mt-8">

235+// <div className="flex flex-col space-y-8 mt-8">

238− {info.map((e) => {

236+// {info.map((e) => {

239− return (

237+// return (

240− <div className="p-8 bg-wall-100 rounded-xl max-w-screen-md flex flex-col">

238+// <div className="p-8 bg-wall-100 rounded-xl max-w-screen-md flex flex-col">

241− <div className="flex">

239+// <div className="flex">

242− <div className="pl-4 pr-8 justify-center items-center flex">

240+// <div className="pl-4 pr-8 justify-center items-center flex">

243− {e.svg}

241+// {e.svg}

244− </div>

242+// </div>

245− <div className="flex flex-col">

243+// <div className="flex flex-col">

246− <h4 className="text-2xl">{e.title}</h4>

244+// <h4 className="text-2xl">{e.title}</h4>

247− <p className="font-light text-lg">{e.subtitle}</p>

245+// <p className="font-light text-lg">{e.subtitle}</p>

248− </div>

246+// </div>

249− </div>

247+// </div>

250− <div className="flex mt-8 border-b-neutral-300 pt-2 pb-5 ">

248+// <div className="flex mt-8 border-b-neutral-300 pt-2 pb-5 ">

251− {e.points.map((section) => {

249+// {e.points.map((section) => {

252− return (

250+// return (

253− <div className="basis-1/2">

251+// <div className="basis-1/2">

254− <p className="uppercase font-bold text-sm text-black">

252+// <p className="uppercase font-bold text-sm text-black">

255− {section.title}

253+// {section.title}

256− </p>

254+// </p>

257− <ul className="mx-8 my-2 list-disc text-sm flex flex-col space-y-2">

255+// <ul className="mx-8 my-2 list-disc text-sm flex flex-col space-y-2">

258− {section.content.map((point) => (

256+// {section.content.map((point) => (

259− <li>{point}</li>

257+// <li>{point}</li>

260− ))}

258+// ))}

261− </ul>

259+// </ul>

262− </div>

260+// </div>

263− );

261+// );

264− })}

262+// })}

265− </div>

263+// </div>

266− <Link href={e.href} passHref>

264+// <Link href={e.href} passHref>

267− <a className="button-lg max-w-fit text-white mt-4 bg-green-400">

265+// <a className="button-lg max-w-fit text-white mt-4 bg-green-400">

268− Get Started

266+// Get Started

269− </a>

267+// </a>

270− </Link>

268+// </Link>

271− </div>

269+// </div>

272− );

270+// );

273− })}

271+// })}

274− </div>

272+// </div>

275− );

273+// );

276−}

274+// }

277

275

278export async function getStaticProps({ params }) {

276export async function getStaticProps({ params }) {

279 let posts = GettingStartedTree;

277 let posts = GettingStartedTree;

pages/grants.js+69−54

@@ -33,7 +33,7 @@ export default function Grants({ posts, categories, types, search }) {

33 const router = useRouter();

34 let { status, type, category } = router.query;

35 if (status === undefined) {

36− status = "open";

36+ status = ["open", "wip"];

37 }

38

39 function push(toQuery) {

@@ -82,8 +82,8 @@ export default function Grants({ posts, categories, types, search }) {

82 const byStatus = (post) => {

83 return (

84 (isOrIsIn("open", status) ? post.status === "open" : false) ||

85− (isOrIsIn("complete", status) ? post.status === "completed" : false) ||

85+ (isOrIsIn("complete", status) ? post.status === "completed" : false) ||

86− (isOrIsIn("wip", status) ? post.status === "wip" : false)

86+ (isOrIsIn("wip", status) ? post.status === "wip" : false)

87 );

88 };

89

@@ -91,10 +91,10 @@ export default function Grants({ posts, categories, types, search }) {

91

92 const filteredPosts = postsByStatus.filter((post) => {

93 const hasCategory = category

94− ? isArray(category)

94+ ? isArray(category)

95− ? post.taxonomies.grant_category.some((cat) => category.includes(cat))

95+ ? post.taxonomies.grant_category.some((cat) => category.includes(cat))

96− : post.taxonomies.grant_category.includes(category)

96+ : post.taxonomies.grant_category.includes(category)

97− : true;

97+ : true;

98

99 const notCanceled = !post.extra.canceled;

100 const hasType = type ? post.taxonomies.grant_type.includes(type) : true;

@@ -107,6 +107,9 @@ export default function Grants({ posts, categories, types, search }) {

107 Bounty: postsByStatus.filter((post) =>

108 post.taxonomies.grant_type.includes("Bounty")

109 ).length,

110+ RFP: postsByStatus.filter((post) =>

111+ post.taxonomies.grant_type.includes("RFP")

112+ ).length,

110 Apprenticeship: postsByStatus.filter((post) =>

113 Apprenticeship: postsByStatus.filter((post) =>

111 post.taxonomies.grant_type.includes("Apprenticeship")

114 post.taxonomies.grant_type.includes("Apprenticeship")

112 ).length,

115 ).length,

@@ -122,7 +125,7 @@ export default function Grants({ posts, categories, types, search }) {

122 {Meta({

125 {Meta({

123 title: "Grants",

126 title: "Grants",

124 description:

127 description:

125− "Contribute to the Urbit project while earning address space.",

128+ "Contribute to the Urbit project while earning address space.",

126 })}

129 })}

127 </Head>

130 </Head>

128 <IntraNav ourSite="https://urbit.org" search={search} />

131 <IntraNav ourSite="https://urbit.org" search={search} />

@@ -157,11 +160,18 @@ export default function Grants({ posts, categories, types, search }) {

157 fund all kinds projects, not strictly technical ones, so don't

160 fund all kinds projects, not strictly technical ones, so don't

158 hesitate to pitch your idea!

161 hesitate to pitch your idea!

159 </p>

162 </p>

163+ <div className="flex flex-wrap mb-8">

160− <Link href="/grants/proposals" passHref>

164+ <Link href="/grants/proposals" passHref>

161− <a className="button-sm bg-blue-400 text-white mb-8 max-w-fit">

165+ <a className="button-sm bg-blue-400 text-white mb-8 max-w-fit mr-2">

162− Submit a Proposal

166+ Submit a Proposal

163− </a>

167+ </a>

168+ </Link>

169+ <Link href="/grants?program=rfps&type=RFP#view-grants" passHref>

170+ <a className="button-sm bg-purple text-white mb-8 max-w-fit">

171+ Get Ideas

172+ </a>

164− </Link>

173+ </Link>

174+ </div>

165

175

166 {/* Apprenticeships */}

176 {/* Apprenticeships */}

167 <h3>Apprenticeships</h3>

177 <h3>Apprenticeships</h3>

@@ -185,7 +195,7 @@ export default function Grants({ posts, categories, types, search }) {

185 Bounties are contracts for work provided by either the Urbit

195 Bounties are contracts for work provided by either the Urbit

186 Foundation or from trusted partners in our ecosystem.

196 Foundation or from trusted partners in our ecosystem.

187 </p>

197 </p>

188− <div className="flex flex-wrap">

198+ <div className="flex flex-wrap mb-8">

189 <Link href="/grants/bounties#post-a-bounty" passHref>

199 <Link href="/grants/bounties#post-a-bounty" passHref>

190 <a className="button-sm bg-yellow-300 text-black mr-2 max-w-fit">

200 <a className="button-sm bg-yellow-300 text-black mr-2 max-w-fit">

191 Post a Bounty

201 Post a Bounty

@@ -227,6 +237,12 @@ export default function Grants({ posts, categories, types, search }) {

227 by those that post them.

237 by those that post them.

228 </p>

238 </p>

229 </li>

239 </li>

240+ <li className="mb-2">

241+ <p>

242+ <Link href="/grants/rfps">RFPs</Link>{" "}

243+ are suitable for people experienced with hoon development but who need some ideas on what to work on.

244+ </p>

245+ </li>

230 <li className="mb-2">

246 <li className="mb-2">

231 <p>

247 <p>

232 <Link href="/grants/apprenticeships">Apprenticeships</Link>{" "}

248 <Link href="/grants/apprenticeships">Apprenticeships</Link>{" "}

@@ -240,19 +256,15 @@ export default function Grants({ posts, categories, types, search }) {

240 <div className="md:basis-1/2">

256 <div className="md:basis-1/2">

241 <p className="mb-8">

257 <p className="mb-8">

242 Whether you're gearing up to submit your proposal or just

258 Whether you're gearing up to submit your proposal or just

243− thinking about it, the best way to get started is to join the

259+ thinking about it, the best way to get started is to join the <Link href="/groups/~halbex-palheb/uf-public">Urbit Foundation</Link> group, ask questions there or come find our grants office hours in the group.

244− Foundation group on Urbit:

245 </p>

260 </p>

246−

247− <JoinGroup

248− emphasize

249− className="mb-8"

261+ <p className="mb-8">

250− groupName="~wolref-podlex/foundation"

262+ Feel free to contact <a href="/ids/~poldec-tonteg">~poldec-tonteg</a> with general questions or <a href="/ids/~marfun-pacpet">~marfun-pacpet</a> regarding administrative matters.

251− />

263+ </p>

252−

264+ <p className="mb-8">

253− <p>

265+ <h4>Approval</h4>

254− If you're not on the network, check out our{" "}

266+ </p>

255− <Link href="/getting-started">Getting Started</Link> guide.

267+ <p className="mb-8">Grant applications and proposals are approved on a bi-weekly basis on the second and fourth Wednesday of the month.

256 </p>

268 </p>

257 </div>

269 </div>

258 </div>

270 </div>

@@ -275,17 +287,20 @@ export default function Grants({ posts, categories, types, search }) {

275 {types.map((each) => {

287 {types.map((each) => {

276 let activeBg;

288 let activeBg;

277 switch (each) {

289 switch (each) {

278− case "Proposal":

290+ case "Proposal":

279− activeBg = "bg-blue-400 text-white";

291+ activeBg = "bg-blue-400 text-white";

280− break;

292+ break;

281− case "Bounty":

293+ case "Bounty":

282− activeBg = "bg-yellow-300 text-white";

294+ activeBg = "bg-yellow-300 text-white";

283− break;

295+ break;

296+ case "RFP":

297+ activeBg = "bg-purple-400 text-white";

298+ break;

284− case "Apprenticeship":

299+ case "Apprenticeship":

285− activeBg = "bg-green-400 text-white";

300+ activeBg = "bg-green-400 text-white";

286− break;

301+ break;

287− default:

302+ default:

288− activeBg = "bg-black";

303+ activeBg = "bg-black";

289 }

304 }

290 return (

305 return (

291 <a

306 <a

@@ -305,8 +320,8 @@ export default function Grants({ posts, categories, types, search }) {

305 <div className="flex flex-wrap mb-12">

320 <div className="flex flex-wrap mb-12">

306 {categories.map((each) => {

321 {categories.map((each) => {

307 const active = isOrIsIn(each, category)

322 const active = isOrIsIn(each, category)

308− ? "bg-green-400 text-white"

323+ ? "bg-green-400 text-white"

309− : "bg-wall-100 text-wall-500";

324+ : "bg-wall-100 text-wall-500";

310 const categoryQuery = pushOrDropQuery("category", category, each);

325 const categoryQuery = pushOrDropQuery("category", category, each);

311 return (

326 return (

312 <button

327 <button

@@ -322,20 +337,20 @@ export default function Grants({ posts, categories, types, search }) {

322 {["open", "complete", "wip"].map((each) => {

337 {["open", "complete", "wip"].map((each) => {

323 let title;

338 let title;

324 switch (each) {

339 switch (each) {

325− case "open":

340+ case "open":

326− title = isOrIsIn(each, status)

341+ title = isOrIsIn(each, status)

327− ? "Exclude Open"

342+ ? "Exclude Open"

328− : "Include Open";

343+ : "Include Open";

329− break;

344+ break;

330− case "complete":

345+ case "complete":

331− title = isOrIsIn(each, status)

346+ title = isOrIsIn(each, status)

332− ? "Exclude Completed"

347+ ? "Exclude Completed"

333− : "Include Completed";

348+ : "Include Completed";

334− break;

349+ break;

335− case "wip":

350+ case "wip":

336− title = isOrIsIn(each, status)

351+ title = isOrIsIn(each, status)

337− ? "Exclude In Progress"

352+ ? "Exclude In Progress"

338− : "Include In Progress";

353+ : "Include In Progress";

339 }

354 }

340 const statusQuery = pushOrDropQuery("status", status, each);

355 const statusQuery = pushOrDropQuery("status", status, each);

341 return (

356 return (

@@ -374,7 +389,7 @@ export async function getStaticProps() {

374 "date"

389 "date"

375 )

390 )

376 }).flat()

391 }).flat()

377− .sort((a, b) => new Date(b.date) - new Date(a.date));

392+ .sort((a, b) => new Date(b.date) - new Date(a.date));

378

393

379 return {

394 return {

380 props: {

395 props: {

pages/grants/[slug].js+67−50

@@ -35,39 +35,39 @@ export default function Grant({ post, markdown, match, search }) {

35 const assignee = post?.extra?.assignee;

36 const mentor = post.extra.mentor || post.extra.champion;

37 const assigneeLink =

38− assignee &&

38+ assignee &&

39− assignee.map((each, index) => {

39+ assignee.map((each, index) => {

40− return ob.isValidPatp(each) ? (

40+ return ob.isValidPatp(each) ? (

41− <>

41+ <>

42− {index ? ", " : ""}

42+ {index ? ", " : ""}

43− <Link href={`/ids/${each}`} passHref>

43+ <Link href={`/ids/${each}`} passHref>

44− <a className="text-green-400">{each}</a>

44+ <a className="text-green-400">{each}</a>

45− </Link>

45+ </Link>

46− </>

46+ </>

47− ) : (

47+ ) : (

48− <>

48+ <>

49− {index ? ", " : ""}

49+ {index ? ", " : ""}

50− {each}

50+ {each}

51− </>

51+ </>

52− );

52+ );

53− });

53+ });

54 const mentorLink =

55− mentor &&

55+ mentor &&

56− mentor.map((each, index) => {

56+ mentor.map((each, index) => {

57− return ob.isValidPatp(each) ? (

57+ return ob.isValidPatp(each) ? (

58− <>

58+ <>

59− {index ? ", " : ""}

59+ {index ? ", " : ""}

60− <Link href={`/ids/${each}`} passHref>

60+ <Link href={`/ids/${each}`} passHref>

61− <a className="text-green-400">{each}</a>

61+ <a className="text-green-400">{each}</a>

62− </Link>

62+ </Link>

63− </>

63+ </>

64− ) : (

64+ ) : (

65− <>

65+ <>

66− {index ? ", " : ""}

66+ {index ? ", " : ""}

67− {each}

67+ {each}

68− </>

68+ </>

69− );

69+ );

70− });

70+ });

71

72 let status = "";

73 if (isOpen) {

@@ -85,21 +85,21 @@ export default function Grant({ post, markdown, match, search }) {

85 "bg-green-400 text-white": status === "Completed" || status === "Open",

86 "bg-wall-300": status === "In Progress",

87 })}>

88− {status}

88+ {status}

89− </div>;

89+ </div>;

90

91 let deliverable = null;

92 if (post.extra.deliverable) {

93 if (match) {

94 deliverable = <ResourceCard

95− title={match.data.title}

95+ title={match.data.title}

96− image={match.data.image}

96+ image={match.data.image}

97− color={match.data.bgColor || "#000000"}

97+ color={match.data.bgColor || "#000000"}

98− description={match.data?.description || ""}

98+ description={match.data?.description || ""}

99− type="application"

99+ type="application"

100− shortcode={post.extra.deliverable}

100+ shortcode={post.extra.deliverable}

101− full

101+ full

102− />

102+/>

103 }

104 else if (post.extra.deliverable.startsWith("~")) {

105 deliverable = <JoinGroup emphasize groupName={post.extra.deliverable} />

@@ -111,6 +111,13 @@ export default function Grant({ post, markdown, match, search }) {

111 const metaPost = Object.assign({}, post);

112 metaPost.title = `${post.title} - Grant`;

113

114+ const isRFP = post.taxonomies.grant_type.filter((category) => {

115+ return category === "RFP";

116+ }).length > 0;

117+

118+ const hasChampion = post.extra.champion && post.extra.champion[0] !== "";

119+ const hasAssignee = post.extra.assignee && post.extra.assignee[0] !== "";

120+

114 return (

121 return (

115 <Container>

122 <Container>

116 <Head>

123 <Head>

@@ -126,6 +133,7 @@ export default function Grant({ post, markdown, match, search }) {

126 {statusBadge}

133 {statusBadge}

127 {post.taxonomies.grant_type.map((category) => {

134 {post.taxonomies.grant_type.map((category) => {

128 const className = classnames({

135 const className = classnames({

136+ "bg-purple-400 text-white": category === "RFP",

129 "bg-blue-400 text-white": category === "Proposal",

137 "bg-blue-400 text-white": category === "Proposal",

130 "bg-green-400 text-white": category === "Apprenticeship",

138 "bg-green-400 text-white": category === "Apprenticeship",

131 "bg-yellow-300": category === "Bounty",

139 "bg-yellow-300": category === "Bounty",

@@ -161,13 +169,13 @@ export default function Grant({ post, markdown, match, search }) {

161 content={mentorLink}

169 content={mentorLink}

162 />

170 />

163 ) : null}

171 ) : null}

164− {post.extra.champion ? (

172+ {hasChampion ? (

165 <MetadataBlock

173 <MetadataBlock

166 title="Champion"

174 title="Champion"

167 content={mentorLink}

175 content={mentorLink}

168 />

176 />

169 ) : null}

177 ) : null}

170− {post.extra.assignee ? (

178+ {hasAssignee ? (

171 <MetadataBlock

179 <MetadataBlock

172 title="Grantee(s)"

180 title="Grantee(s)"

173 content={assigneeLink}

181 content={assigneeLink}

@@ -175,17 +183,26 @@ export default function Grant({ post, markdown, match, search }) {

175 ) : null}

183 ) : null}

176 </div>

184 </div>

177 {post?.extra?.link?.startsWith("~") && <div className="flex flex-col my-4 space-y-2">

185 {post?.extra?.link?.startsWith("~") && <div className="flex flex-col my-4 space-y-2">

178− <p className="text-wall-400 font-semibold">Group</p>

186+ <p className="text-wall-400 font-semibold">Group</p>

179− <JoinGroup emphasize groupName={post.extra.link} />

187+ <JoinGroup emphasize groupName={post.extra.link} />

180− </div>}

188+ </div>}

181 {deliverable && <div className="flex flex-col my-4 space-y-2">

189 {deliverable && <div className="flex flex-col my-4 space-y-2">

182− <p className="text-wall-400 font-semibold">Deliverable</p>

190+ <p className="text-wall-400 font-semibold">Deliverable</p>

183− {deliverable}

191+ {deliverable}

184− </div>}

192+ </div>}

185 </Section>

193 </Section>

186 <Section narrow className="markdown">

194 <Section narrow className="markdown">

187 <Markdown.render content={JSON.parse(markdown)} />

195 <Markdown.render content={JSON.parse(markdown)} />

188 </Section>

196 </Section>

197+ {isRFP && (

198+ <a

199+ className="bg-green-400 text-white button-lg"

200+ href="/grants/rfps"

201+ target="_blank"

202+ >

203+ Learn More

204+ </a>

205+ )}

189 {canApply && (

206 {canApply && (

190 <a

207 <a

191 className="bg-green-400 text-white button-lg"

208 className="bg-green-400 text-white button-lg"

pages/grants/apprenticeships.js+1−1

@@ -8,7 +8,7 @@ export default function Post({ post, markdown, search }) {

8 post={post}

9 markdown={markdown}

10 search={search}

11− actionText="View Apprenticeships"

11+ actionText="View Requests"

12 actionLink="/grants?program=apprenticeship&completed=true#view-grants"

13 />

14 );

pages/grants/rfps.jsnew file+29

@@ -0,0 +1,29 @@

1+import GrantProgramOverview from "../../components/GrantProgramOverview";

2+import { Markdown, getPostBySlug } from "@urbit/foundation-design-system";

3+

4+export default function Post({ post, markdown, search }) {

5+ return (

6+ <GrantProgramOverview

7+ program="rfps"

8+ post={post}

9+ markdown={markdown}

10+ search={search}

11+ actionText="View RFPs"

12+ actionLink="/grants?program=rfps#view-grants"

13+ />

14+ );

15+}

16+

17+export async function getStaticProps() {

18+ const post = getPostBySlug(

19+ "/rfps",

20+ ["title", "date", "slug", "content"],

21+ "/"

22+ );

23+

24+ const markdown = JSON.stringify(Markdown.parse({ post }));

25+

26+ return {

27+ props: { post, markdown },

28+ };

29+}

pages/groups/[[...group]].js+1−1

@@ -84,7 +84,7 @@ const GroupPage = ({ data, markdown, params, search }) => {

84 Urbit is a clean-slate, peer-to-peer operating system and network.

85 </h3>

86 <div className="flex flex-col space-y-4">

87− <Link href="/guides/joining-groups" passHref>

87+ <Link href="/getting-started/joining-groups" passHref>

88 <a className="button-lg max-w-xs bg-green-400 text-white">

89 How to Join an Urbit Group

90 </a>

pages/ids/[id].js+1−1

@@ -140,7 +140,7 @@ const IdPage = ({ data, markdown, applications, groups, network, params }) => {

140 Urbit is a clean-slate, peer-to-peer operating system and network.

141 </h3>

142 <div className="flex flex-col space-y-4">

143− <Link href="/guides/getting-an-urbit-id">

143+ <Link href="/getting-started/get-id">

144 <button className="button-lg max-w-xs bg-green-400 text-white">

145 Learn how to get an Urbit ID

146 </button>

pages/ids/submit.js+3−3

@@ -3,10 +3,10 @@ import {

3 Container,

4 SingleColumn,

5 Section,

6+ Sigil

6} from "@urbit/foundation-design-system";

7} from "@urbit/foundation-design-system";

7import { useInputChange } from "../../lib/hooks";

8import { useInputChange } from "../../lib/hooks";

8import ob from "urbit-ob";

9import ob from "urbit-ob";

9−import Sigil from "../../components/Sigil";

10import Head from "next/head";

11import Meta from "../../components/Meta";

12

@@ -56,8 +56,8 @@ ${form?.description || ""}`

56 </p>

57 <p>

58 Then, to validate that you own that ID, send a DM to{" "}

59− <Link href="/ids/~haddef-sigwen" passHref>

59+ <Link href="/ids/~battus-datsun" passHref>

60− <a>~haddef-sigwen</a>

60+ <a>~battus-datsun</a>

61 </Link>{" "}

62 from your <code>@p</code> with a link to the pull request on

63 GitHub. We’ll approve the pull request and your page will be

pages/index.js+98−115

@@ -19,12 +19,15 @@ import PostPreview from "../components/PostPreview";

19import EventPreview from "../components/EventPreview";

20import { eventKeys } from "../lib/constants";

21import IndexCard from "../components/ecosystem/IndexCard";

22+import HighlightCard from "../components/HighlightCard";

22import fs from "fs";

23import fs from "fs";

23import path from "path";

24import path from "path";

24import Meta from "../components/Meta";

25import Meta from "../components/Meta";

26+import { matchEcosystemPost } from "../lib/lib";

25

27

26export default function Home({

28export default function Home({

27 posts,

29 posts,

30+ highlights,

28 ecosystem,

31 ecosystem,

29 events,

32 events,

30 grantNumbers,

33 grantNumbers,

@@ -33,12 +36,13 @@ export default function Home({

33 const post = {

36 const post = {

34 title: "Urbit",

37 title: "Urbit",

35 description: "A clean-slate OS and network for the 21st century.",

38 description: "A clean-slate OS and network for the 21st century.",

39+ image: "https://storage.googleapis.com/media.urbit.org/site/opengraph/urbit.png"

36 };

40 };

37 return (

41 return (

38 <Container>

42 <Container>

39 <Head>

43 <Head>

40 <title>Urbit</title>

44 <title>Urbit</title>

41− {Meta(post)}

45+ {Meta(post, false, true)}

42 </Head>

46 </Head>

43 <IntraNav ourSite="https://urbit.org" search={search} />

47 <IntraNav ourSite="https://urbit.org" search={search} />

44 <SingleColumn>

48 <SingleColumn>

@@ -49,34 +53,27 @@ export default function Home({

49 <Section className="pb-36">

53 <Section className="pb-36">

50 <div className="space-y-8">

54 <div className="space-y-8">

51 <h1>A clean-slate OS and network for the 21st century.</h1>

55 <h1>A clean-slate OS and network for the 21st century.</h1>

52− <Link href="/trial" passHref><a className="bg-green-400 text-white button-lg max-w-fit">Explore the Network</a></Link>

56+ <Link href="/getting-started" passHref><a className="bg-green-400 text-white button-lg max-w-fit">Get Started</a></Link>

53 </div>

57 </div>

54 </Section>

58 </Section>

55 {

59 {

56 // Hero

60 // Hero

57 }

61 }

58

62

63+ {

64+ // Highlights

65+ }

59 <Section className="pb-12">

66 <Section className="pb-12">

60− <div className="bg-wall-100 w-full p-4 md:p-8 rounded-3xl flex flex-wrap items-center">

67+ <div className="flex flex-col space-y-4 md:space-y-0 md:flex-row md:space-x-4">

61−

68+ <HighlightCard highlight={highlights[0]} key={highlights[0].slug} />

62− <div className="basis-full sm:basis-1/3 pb-4 sm:pb-0">

69+ <HighlightCard highlight={highlights[1]} key={highlights[1].slug} />

63− <img className="rounded-xl w-72" src="https://storage.googleapis.com/media.urbit.org/assembly/assembly-thumb2.jpg"/>

70+ <HighlightCard highlight={highlights[2]} key={highlights[2].slug} />

64− </div>

65− <div className="sm:basis-2/3 sm:pl-6 align-middle">

66− <h2 className="text-2xl pb-2">Assembly 2022</h2 >

67− <p className="max-w-prose pb-4">

68− Select talks and panels are being released from the second annual Urbit confluence in Miami.

69− </p>

70− <Link href="https://assembly.urbit.org" passHref>

71− <a className="button-sm border-2 border-wall-600 text-wall-600 type-sm max-w-fit">

72− Watch Now

73− </a>

74− </Link>

75− </div>

76 </div>

71 </div>

77 </Section>

72 </Section>

78

73

79

74

75+

76+

80 <Section narrow className="space-y-8">

77 <Section narrow className="space-y-8">

81

78

82 <div className="w-full space-y-8 max-w-prose">

79 <div className="w-full space-y-8 max-w-prose">

@@ -137,6 +134,53 @@ export default function Home({

137 </Link>

134 </Link>

138 </div>

135 </div>

139 </Section>

136 </Section>

137+

138+ {

139+ // Build on Urbit Developer CTA

140+ }

141+ <Section narrow>

142+ <h2 className="pb-8">Build on Urbit</h2>

143+ <h4 className="pb-6">

144+ Urbit is a personal OS designed from scratch to run peer-to-peer

145+ applications.

146+ </h4>

147+ <p className="pb-6">

148+ It solves the hard problems of implementing a peer-to-peer network

149+ (including identity, NAT traversal, and exactly-once delivery) in

150+ the kernel so app developers can focus on business logic.

151+ </p>

152+ <p className="pb-6">

153+ The entire OS is a{" "}

154+ <Link href="https://urbit.org/docs/nock/definition/" passHref>

155+ <a>single pure function</a>

156+ </Link>{" "}

157+ that provides application developers with strong guarantees:

158+ automated persistence and memory management, repeatable builds, and

159+ support for hot code reloading.

160+ </p>

161+ <p className="pb-10">

162+ You can get started learning how to{" "}

163+ <Link href="https://urbit.org/docs/development/develop/" passHref>

164+ <a>contribute to the project</a>

165+ </Link>

166+ , or view a variety of{" "}

167+ <Link

168+ href="https://github.com/urbit/awesome-urbit#http-apis-airlock"

169+ passHref

170+ >

171+ <a>libraries</a>

172+ </Link>{" "}

173+ for building on Urbit using the languages you already know.

174+ </p>

175+ <Link href="https://developers.urbit.org" passHref>

176+ <a className="button-lg type-ui text-white bg-green-400 max-w-fit">

177+ Visit Urbit Developers

178+ </a>

179+ </Link>

180+ </Section>

181+

182+

183+

140 {

184 {

141 // Grants

185 // Grants

142 }

186 }

@@ -186,49 +230,6 @@ export default function Home({

186 </div>

230 </div>

187 </Section>

231 </Section>

188

232

189− {

190− // Build on Urbit Developer CTA

191− }

192− <Section narrow>

193− <h2 className="pb-8">Build on Urbit</h2>

194− <h4 className="pb-6">

195− Urbit is a personal OS designed from scratch to run peer-to-peer

196− applications.

197− </h4>

198− <p className="pb-6">

199− It solves the hard problems of implementing a peer-to-peer network

200− (including identity, NAT traversal, and exactly-once delivery) in

201− the kernel so app developers can focus on business logic.

202− </p>

203− <p className="pb-6">

204− The entire OS is a{" "}

205− <Link href="https://urbit.org/docs/nock/definition/" passHref>

206− <a>single pure function</a>

207− </Link>{" "}

208− that provides application developers with strong guarantees:

209− automated persistence and memory management, repeatable builds, and

210− support for hot code reloading.

211− </p>

212− <p className="pb-10">

213− You can get started learning how to{" "}

214− <Link href="https://urbit.org/docs/development/develop/" passHref>

215− <a>contribute to the project</a>

216− </Link>

217− , or view a variety of{" "}

218− <Link

219− href="https://github.com/urbit/awesome-urbit#http-apis-airlock"

220− passHref

221− >

222− <a>libraries</a>

223− </Link>{" "}

224− for building on Urbit using the languages you already know.

225− </p>

226− <Link href="https://developers.urbit.org" passHref>

227− <a className="button-lg type-ui text-white bg-green-400 max-w-fit">

228− Visit Urbit Developers

229− </a>

230− </Link>

231− </Section>

232

233

233 {

234 {

234 // Blog Posts

235 // Blog Posts

@@ -270,6 +271,26 @@ export default function Home({

270 </Link>

271 </Link>

271 </Section>

272 </Section>

272

273

274+ <Section className="pb-12">

275+ <div className="bg-wall-100 w-full p-4 md:p-8 rounded-3xl flex flex-wrap items-center">

276+

277+ <div className="basis-full sm:basis-1/3 pb-4 sm:pb-0">

278+ <img className="rounded-xl w-72" src="https://storage.googleapis.com/media.urbit.org/assembly/assembly-thumb2.jpg" />

279+ </div>

280+ <div className="sm:basis-2/3 sm:pl-6 align-middle">

281+ <h2 className="text-2xl pb-2">Assembly 2022</h2 >

282+ <p className="max-w-prose pb-4">

283+ Watch talks and panels from last year's confluence in Miami.

284+ </p>

285+ <Link href="https://assembly.urbit.org" passHref>

286+ <a className="button-sm border-2 border-wall-600 text-wall-600 type-sm max-w-fit">

287+ Watch Now

288+ </a>

289+ </Link>

290+ </div>

291+ </div>

292+ </Section>

293+

273 <Section narrow>

294 <Section narrow>

274 <h2 className="pb-2">Urbit Monthly</h2>

295 <h2 className="pb-2">Urbit Monthly</h2>

275 <p className="pb-8">Get monthly email updates on all things Urbit.</p>

296 <p className="pb-8">Get monthly email updates on all things Urbit.</p>

@@ -277,6 +298,9 @@ export default function Home({

277 <Contact emphasize />

298 <Contact emphasize />

278 </Section>

299 </Section>

279

300

301+

302+

303+

280 <Section narrow>

304 <Section narrow>

281 <h2 className="pb-8">Social Media</h2>

305 <h2 className="pb-8">Social Media</h2>

282 <p className="pb-2">

306 <p className="pb-2">

@@ -308,6 +332,8 @@ export default function Home({

308 );

332 );

309}

333}

310

334

335+

336+

311export async function getStaticProps() {

337export async function getStaticProps() {

312 // Latest blog posts

338 // Latest blog posts

313 const posts = getAllPosts(

339 const posts = getAllPosts(

@@ -316,64 +342,20 @@ export async function getStaticProps() {

316 "date"

342 "date"

317 );

343 );

318

344

319− // Pull all latest ecosystem information

320− const ecosystem = getAllPosts(

321− ["date", "featured-1", "featured-2", "featured-3"],

322− "ecosystem/spotlight",

323− "date"

324− )[0];

325

345

346+ // Highlights

326− const articles = getAllPosts(

347+ const highlights = getAllPosts(

327− ["title", "image", "date", "podcast", "slug"],

348+ ["title", "slug", "image", "url", "description"],

328− "articles",

349+ "highlights"

329− "date"

330 );

350 );

331

351

332− const marketplaces = getAllPosts(["title", "image", "slug"], "marketplaces");

333− const podcasts = getAllPosts(

334− ["title", "image", "date", "podcast", "slug"],

335− "podcasts",

336− "date"

337− );

338− const organizations = getAllPosts(

339− ["title", "image", "slug"],

340− "organizations"

341− );

342− const applications = fs

343− .readdirSync(path.join(process.cwd(), "content/applications"), {

344− withFileTypes: true,

345− })

346− .filter((f) => f.isDirectory())

347− .map((dir) =>

348− getAllPosts(

349− ["title", "bgColor", "image", "slug", "description"],

350− `applications/${dir.name}`

351− )

352− .map((e) => ({ ...e, ship: dir.name }))

353− .flat()

354− )

355− .flat()

356− .sort((a, b) => {

357− const nameA = a.title.toLowerCase();

358− const nameB = b.title.toLowerCase();

359− return nameA < nameB ? -1 : 1;

360− });

361

352

353+ // Latest ecosystem report with matched post metadata

354+ const ecosystem = matchEcosystemPost(getAllPosts(

362− ["featured-1", "featured-2", "featured-3"].forEach((feat) => {

355+ ["date", "featured-1", "featured-2", "featured-3"],

363− if (ecosystem?.[feat]) {

356+ "ecosystem/spotlight",

364− const matchedPost = [

357+ "date"

365− ...articles.map((e) => ({ ...e, type: "Article" })),

366− ...applications.map((e) => ({ ...e, type: "Application" })),

367− ...organizations.map((e) => ({ ...e, type: "Organization" })),

368− ...podcasts.map((e) => ({ ...e, type: "Podcast" })),

369− ...marketplaces.map((e) => ({ ...e, type: "Marketplace" })),

370− ].filter((e) => e.title === ecosystem[feat].title)?.[0];

371− ecosystem[feat].image =

372− ecosystem[feat].image || matchedPost?.image || null;

373− ecosystem[feat].type = matchedPost?.type || "Podcast";

374− ecosystem[feat].matchedPost = matchedPost || null;

375− }

376− });

358+ )[0]);

377

359

378 // Latest grants

360 // Latest grants

379 const basePath = path.join(process.cwd(), 'content/grants')

361 const basePath = path.join(process.cwd(), 'content/grants')

@@ -439,6 +421,7 @@ export async function getStaticProps() {

439 return {

421 return {

440 props: {

422 props: {

441 posts,

423 posts,

424+ highlights,

442 ecosystem,

425 ecosystem,

443 grantNumbers,

426 grantNumbers,

444 events: happeningNow.concat(futureEvents).concat(pastEvents),

427 events: happeningNow.concat(futureEvents).concat(pastEvents),

pages/organizations/[slug].js+3−2

@@ -40,7 +40,7 @@ export default function Organization({

40 {applications.length > 0 && (

41 <>

42 <h3>Applications</h3>

43− <div className="grid grid-cols-2 md:grid-cols-4 gap-8 h-full w-full">

43+ <div className="grid grid-cols-2 md:grid-cols-4 gap-8 w-full">

44 {applications.map((app) => (

45 <Link href={`/applications/${app.ship}/${app.slug}`}>

46 <div className="flex flex-col h-full w-full space-y-4 cursor-pointer">

@@ -103,6 +103,7 @@ export async function getStaticProps({ params }) {

103 "slug",

104 "description",

105 "URL",

106+ "twitter",

106 "image",

107 "image",

107 "ships",

108 "ships",

108 "group",

109 "group",

@@ -112,7 +113,7 @@ export async function getStaticProps({ params }) {

112 );

113 );

113

114

114 const spotlights = getAllPosts(

115 const spotlights = getAllPosts(

115− ["title", "slug", "featured-1", "featured-2", "featured-3"],

116+ ["title", "heading", "slug", "featured-1", "featured-2", "featured-3"],

116 "ecosystem/spotlight"

117 "ecosystem/spotlight"

117 ).filter(

118 ).filter(

118 (e) =>

119 (e) =>

public/images/android-chrome-192x192.pngnew file

Binary file not shown.

public/images/android-chrome-512x512.pngnew file

Binary file not shown.

public/images/apple-touch-icon.pngnew file

Binary file not shown.

public/images/developers-guide-logo.pngdeleted

Binary file not shown.

public/images/favicon-16x16.pngnew file

Binary file not shown.

public/images/favicon-32x32.pngnew file

Binary file not shown.

public/images/favicon.ico

Binary file not shown.

public/images/network-explorer-logo.pngdeleted

Binary file not shown.

public/images/operators-guide-logo.pngdeleted

Binary file not shown.

public/images/star-market-logo.pngdeleted

Binary file not shown.

vercel.json+49−19

@@ -4,24 +4,45 @@

4 },

5 "redirects": [

6 {

7− "source": "/docs/getting-started",

7+ "source": "/sponsordeck",

8− "destination": "/getting-started"

8+ "destination": "https://tinyurl.com/urbitsponsordeck",

9+ "permanent": true

9 },

10 },

10 {

11 {

11− "source": "/getinvolved",

12+ "source": "/uf-public",

12− "destination": "https://developers.urbit.org/blog/get-involved"

13+ "destination": "https://tlon.network/lure/~halbex-palheb/uf-public",

14+ "permanent": false

13 },

15 },

14 {

16 {

15− "source": "/getting-started/server",

17+ "source": "/groups/~wolref-podlex/foundation",

16− "destination": "/getting-started/cli"

18+ "destination": "/groups/~halbex-palheb/uf-public"

17 },

19 },

18 {

20 {

19− "source": "/applications",

21+ "source": "/getting-around",

20− "destination": "/ecosystem?type=applications"

22+ "destination": "/getting-started/getting-around"

23+ },

24+ {"source": "/getting-started/get-planet",

25+ "destination": "/getting-started/get-id"

21 },

26 },

22 {

27 {

28+ "source": "/docs/getting-started",

29+ "destination": "/getting-started"

30+ },

31+ {

32+ "source": "/getinvolved",

33+ "destination": "https://developers.urbit.org/blog/get-involved"

34+ },

35+ {

36+ "source": "/getting-started/server",

37+ "destination": "/getting-started/cli"

38+ },

39+ {

40+ "source": "/applications",

41+ "destination": "/ecosystem?type=applications"

42+ },

43+ {

23− "source": "/understanding-urbit/:path*",

44+ "source": "/understanding-urbit/:path*",

24− "destination": "/overview/:path*"

45+ "destination": "/overview/:path*"

25 },

46 },

26 {

47 {

27 "source": "/blog/layer-2-guides",

48 "source": "/blog/layer-2-guides",

@@ -31,9 +52,13 @@

31 "source": "/grants/Faux",

52 "source": "/grants/Faux",

32 "destination": "/grants/faux"

53 "destination": "/grants/faux"

33 },

54 },

55+ {

56+ "source": "/using/id/layer-2-for-planets",

57+ "destination": "https://operators.urbit.org/manual/id/layer-2-for-planets"

58+ },

34 {

59 {

35 "source": "/getting-started/layer-2-for-planets",

60 "source": "/getting-started/layer-2-for-planets",

36− "destination": "/using/id/layer-2-for-planets"

61+ "destination": "https://operators.urbit.org/manual/id/layer-2-for-planets"

37 },

62 },

38 {

63 {

39 "source": "/guides/getting-an-urbit-id",

64 "source": "/guides/getting-an-urbit-id",

@@ -82,29 +107,34 @@

82 "destination": "/getting-started",

107 "destination": "/getting-started",

83 "permanent": true

108 "permanent": true

84 },

109 },

110+ {

111+ "source": "/using/install",

112+ "destination": "/getting-started/cli",

113+ "permanent": true

114+ },

85 {

115 {

86 "source": "/using/:path*",

116 "source": "/using/:path*",

87 "destination": "https://operators.urbit.org/manual/:path",

117 "destination": "https://operators.urbit.org/manual/:path",

88 "permanent": true

118 "permanent": true

89 },

119 },

90 {

120 {

91− "source": "/install/mac/latest",

121+ "source": "/install/linux-aarch64/latest",

92− "destination": "https://github.com/urbit/urbit/releases/latest/download/darwin.tgz",

122+ "destination": "https://github.com/urbit/vere/releases/latest/download/linux-aarch64.tgz",

93 "permanent": true

123 "permanent": true

94 },

124 },

95 {

125 {

96− "source": "/install/linux64/latest",

126+ "source": "/install/linux-x86_64/latest",

97− "destination": "https://github.com/urbit/urbit/releases/latest/download/linux64.tgz",

127+ "destination": "https://github.com/urbit/vere/releases/latest/download/linux-x86_64.tgz",

98 "permanent": true

128 "permanent": true

99 },

129 },

100 {

130 {

101− "source": "/install/linux-aarch64/latest",

131+ "source": "/install/macos-aarch64/latest",

102− "destination": "https://github.com/urbit/urbit/releases/latest/download/linux-aarch64.tgz",

132+ "destination": "https://github.com/urbit/vere/releases/latest/download/macos-aarch64.tgz",

103 "permanent": true

133 "permanent": true

104 },

134 },

105 {

135 {

106− "source": "/install/windows/latest",

136+ "source": "/install/macos-x86_64/latest",

107− "destination": "http://github.com/urbit/urbit/releases/latest/download/windows.tgz",

137+ "destination": "https://github.com/urbit/vere/releases/latest/download/macos-x86_64.tgz",

108 "permanent": true

138 "permanent": true

109 },

139 },

110 {

140 {