wren/lost-property Public Public: anyone can read this; nobody can change it.

workbenchthis machine

Files b0d27a78fe6cdb336ab222039fe082a1a5eb9ce6

23 lines · 1.3 KB · ~321 tok

Raw History

# lost-property

A museum of lost things. Someone describes something they lost; the museum accessions it — a catalogue number, a vitrine, a plaque written in the flat voice of a museum label — and other visitors can leave a note on any case saying they saw one like it, or that they have the other half.

This is an app: the forge runs it. Production follows the default branch;
every open pull gets a preview at its own address with its own copy of the
data. Everything the app keeps lives under `FORGE_APP_DATA`, which is what
makes "production data" and "preview data" two different things.

```sh
PORT=8080 FORGE_APP_DATA=./data bun run src/server.ts   # run it here
bun test                                                # the check every pull runs
FORGE_APP_DATA=./data bun run src/tty.ts                # the terminal interface
```

It also has a terminal: the exact command is in `FORGE_APP_SSH` when the app
runs (`ssh -p 2222 <name>@<forge>` — the app is the login name, the forge is
the host; `<name>--<pull>@<forge>` for a preview's). It opens `src/tty.ts` on
a real pty over the same data.

The forge sets `PORT`, `FORGE_APP_DATA`, `FORGE_APP_ENV`
(`production` or `preview`), `FORGE_APP_URL` and `FORGE_APP_COMMIT`
when it starts the app. `forge.json` says how.

1	# lost-property
2
3	A museum of lost things. Someone describes something they lost; the museum accessions it — a catalogue number, a vitrine, a plaque written in the flat voice of a museum label — and other visitors can leave a note on any case saying they saw one like it, or that they have the other half.
4
5	This is an app: the forge runs it. Production follows the default branch;
6	every open pull gets a preview at its own address with its own copy of the
7	data. Everything the app keeps lives under `FORGE_APP_DATA`, which is what
8	makes "production data" and "preview data" two different things.
9
10	```sh
11	PORT=8080 FORGE_APP_DATA=./data bun run src/server.ts # run it here
12	bun test # the check every pull runs
13	FORGE_APP_DATA=./data bun run src/tty.ts # the terminal interface
14	```
15
16	It also has a terminal: the exact command is in `FORGE_APP_SSH` when the app
17	runs (`ssh -p 2222 <name>@<forge>` — the app is the login name, the forge is
18	the host; `<name>--<pull>@<forge>` for a preview's). It opens `src/tty.ts` on
19	a real pty over the same data.
20
21	The forge sets `PORT`, `FORGE_APP_DATA`, `FORGE_APP_ENV`
22	(`production` or `preview`), `FORGE_APP_URL` and `FORGE_APP_COMMIT`
23	when it starts the app. `forge.json` says how.