The world is weaving itself.
Worldloom is a persistent living tapestry woven in real time from Wikimedia edits, Bluesky activity, RIPE routing motion, Solana slot progression, drand rounds, earthquakes, global weather, and three small anonymous visitor gestures. All seven public sources start enabled and remain independently bounded. The present lives at the luminous right edge; move left to revisit earlier UTC chapters.
Worldloom is currently available as public source and a local experience. A hosted demo link will appear here only after public infrastructure is configured and verified.
It is an artistic aggregate—not an alerting, forecasting, operational, social, cryptographic-verification, financial, or scientific analysis service. Upstream activity is best-effort and may be delayed, revised, incomplete, or unavailable.
There are no accounts, names, chat messages, uploads, or visitor profiles. Every formation is stored before it is broadcast, so two connected browsers see the same committed artifact and a restart reconstructs it from PostgreSQL.
- Watch seven public signals become distinct strands, fans, forks, beads, crystals, rupture rings, and atmospheric shifts.
- Move between 1m, 5m, and 15m UTC scales. Now stays pinned at the live edge, while panned history and selected chapters keep their center as the scale changes.
- Add a visitor gesture in two steps: touch or adjust the vertical lane, then press Tug, Knot, or Illuminate.
- Inspect a formation with pointer, touch, or keyboard and share its permanent link.
- Browse earlier UTC chapters without changing their history.
- Use reduced motion and the screen-reader formation summary without losing controls.
flowchart LR
W[Wikimedia SSE] --> N[Normalize and bound]
U[USGS GeoJSON] --> N
M[Open-Meteo] --> N
DQ[drand Quicknet] --> N
BJ[Bluesky Jetstream] --> N
RR[RIPE RIS Live] --> N
SS[Solana slots] --> N
V[Visitor gesture] --> P[Gesture policy]
N --> BUF[Bounded signal buffer]
BUF --> C[Single loom coordinator]
P --> C
C -->|transaction| D[(PostgreSQL)]
D -->|commit succeeds| C
C -->|Phoenix PubSub| L[LiveView clients]
L --> R[Deterministic Canvas 2D renderer]
The browser draws compact, versioned instructions; it never receives raw upstream payloads. See ARCHITECTURE.md for invariants, recovery, bounds, and the deliberately single-instance v1 design.
All seven public sources run by default. Their independent environment switches are
operator circuit breakers: setting one to false removes only that source owner and
its upstream connection while the rest of the world keeps weaving.
| Source | Default | Public freshness | Recovery posture |
|---|---|---|---|
| Wikimedia | On | Quiet after 20 seconds | At most 60 seconds from a durable event ID |
| USGS | On | Quiet after 3 minutes | Idempotent rolling-feed polling with a private ETag |
| Open-Meteo | On | Stale after 30 minutes | Keep the last ambient state; retry locally |
| drand Quicknet | On | Stale after 12 seconds | At most 20 exact rounds; report a larger gap |
| Bluesky legacy Jetstream | On | Quiet after 20 seconds | Five-second overlap within a 60-second horizon |
| RIPE RIS Live | On | Quiet after 20 seconds | Rejoin the live edge; never claim replay |
| Solana slot progression | On | Quiet after 20 seconds | Rejoin the live edge; preserve observed gaps |
WORLDLOOM_FEEDS_ENABLED=false overrides every source for offline operation. The
independent circuit breakers are WORLDLOOM_DRAND_ENABLED,
WORLDLOOM_BLUESKY_ENABLED, WORLDLOOM_RIPE_ENABLED, and
WORLDLOOM_SOLANA_ENABLED. WORLDLOOM_SOLANA_URL can replace the checked-in secure
public endpoint. Exact isolation and recovery gates are in
docs/operations.md.
| Component | Version |
|---|---|
| Elixir | 1.20.2 on OTP 29.0.4 |
| Phoenix | 1.8.9 |
| Phoenix LiveView | 1.2.8 |
| Ecto SQL | 3.14.0 |
| Node.js | 24.18.0 |
| PostgreSQL | 14 or newer |
| Browser renderer | Canvas 2D, tested with Playwright Chromium |
The language runtimes are pinned in .tool-versions. PostgreSQL
must be running locally with a postgres role/password matching config/dev.exs,
or those development settings can be adapted for your machine.
git clone https://github.com/romankhadka/worldloom.git
cd worldloom
mix setup
npm ci
mix phx.serverOpen http://localhost:4000. Development connects to all seven public sources by default.
For a repeatable offline canvas, disable the feed workers and seed one deterministic hour before starting Phoenix:
WORLDLOOM_FEEDS_ENABLED=false mix worldloom.seed_demo
WORLDLOOM_FEEDS_ENABLED=false mix phx.serverThe seed task is idempotent: rerunning it does not duplicate its 120 demo signals.
mix precommit
npm test
npm run test:e2eThe gates cover source normalization, transactional persistence, retry and checkpoint
behavior, bounded and balanced timeline projection, trusted chapter-anchor preservation,
LiveView interaction, deterministic rendering, keyboard operation, real mobile tap and
touch-drag submission, overlay scrolling, reduced motion, two-browser convergence, and
reload reconstruction. The browser suite uses an isolated worldloom_e2e database and
deterministic feed-disabled data.
The explicit launch-capacity proof adds 100 independent Chromium contexts, real
LiveView snapshot progress, WebSocket stability, aggregate Presence cleanup, and one
server-owned connection/subscription set per streaming source. It is intentionally
heavier than pull-request CI; follow load/README.md for the
deterministic harness and exact npm run test:browser-100 and k6 commands.
Worldloom uses Wikimedia EventStreams, the USGS real-time GeoJSON feed, Open-Meteo, drand Quicknet, Bluesky legacy Jetstream, and RIPE RIS Live. A Solana slot subscription uses Solana's rate-limited public mainnet endpoint by default; Solana documents that public endpoints have no SLA and are unsuitable for production applications. The public Open-Meteo endpoint used here is a non-commercial tier; commercial deployment requires a fresh licensing and API-plan review. Full field-level handling and attribution are in docs/data-sources.md.
Anonymous browser and network values exist only long enough to enforce contribution limits; they are not written to loom events or public output. Read the exact behavior in docs/privacy.md.
Every pointer interaction has a focus or tap equivalent. The app includes semantic controls, visible focus, a textual live summary, non-color signal shapes, responsive touch targets, and a reduced-motion renderer.
A production release requires DATABASE_URL, SECRET_KEY_BASE, PHX_HOST, and
WORLDLOOM_RATE_LIMIT_SALT. Set PHX_SERVER=true to serve HTTP and use
WORLDLOOM_FEEDS_ENABLED=false for a feed-free environment. Deployment, health,
recovery, metrics, and incident procedures live in docs/operations.md.
Worldloom is available under the MIT License.