# Examples

Small ones here, run offline by their tests; real applications in their own repos.

## In this repo

| example | what | try it |
|---|---|---|
| `examples/rust/hello` | count an account's records (public reads) | `atlibs run examples/rust/hello count '{"did":"…","collection":"…"}'` |
| `examples/web/hello` | a page: count signed out, set your status signed in | [Run modules in a page](browser/run-modules.md) |
| `examples/rust/statusphere` | set or clear an `xyz.statusphere.status` (writes, `anyRecords`, fan-out) | `atlibs run examples/rust/statusphere set_status '{"status":"🦋"}' --as you` |
| `examples/rust/vibescrobble` | post a `com.vibescrobble.scrobble` | `atlibs run examples/rust/vibescrobble scrobble '{"text":"🚀 shipped"}' --as you` |
| `examples/rust/echo` | every event kind: a relay subscription, timers, input, an iroh session | [Calls](modules/calls.md#subscriptions-timers-and-input) |
| `examples/rust/compose` | a composition (`compose.ts` writes `composition.json`): routed calls, a callback, a policy, a handler | [Compositions](compositions.md) |
| `examples/rust-compose` | the same composition in Rust (`atlibs-compose`) | [Compositions](compositions.md#in-rust) |
| `examples/node-hono` | an existing Node server (Hono) serving staged modules with sign-in | [Node servers](server/node.md#a-hono-server) |
| `examples/rust-host` | a Rust program running a module with `atlibs-host` (by git, pinned) | [Use in Rust](start/rust.md) |

Every module's tests:

```bash run
node --test examples/rust/{hello,statusphere,vibescrobble,echo}/test.mjs examples/web/hello/*.test.mjs 2>&1 | grep -E '^ℹ fail'
```

```output
ℹ fail 0
```

## In their own repos

| repo | what |
|---|---|
| [atlibs-fedproxy](knotless://johnandersen777.bsky.social/atlibs-fedproxy) | SSH keys for fedproxy.com: the module, a page, the same page as a web tile, and serving XRPC from a module through the `xrpc.fedproxy.com` ingress relay |
| [atlibs-socialweb-computer-requester](knotless://johnandersen777.bsky.social/atlibs-socialweb-computer-requester) | the socialweb.computer compute-market requester (RFPs, bids, accept, release), its policy modules, and a page for compute |
| [atlibs-agents](knotless://johnandersen777.bsky.social/atlibs-agents) | launching agents on won VMs: a service on the Rust host with service-auth, and its page; the atirc chat module and page |
| [atlibs-iroh](knotless://johnandersen777.bsky.social/atlibs-iroh) | the iroh transport ([Transports](transports.md)) |
| [atlibs-webrtc](knotless://johnandersen777.bsky.social/atlibs-webrtc) | the WebRTC transport and a browser shell to a VM ([Transports](transports.md)) |

Previous: [Transports](transports.md) | Next: [Reference: lexicons](reference/lexicons.md)