Skip to content

nanoolabs/webrings

Repository files navigation

Nanoo Webrings [⌐■_■]

Circular webring registry and redirect service for the Nanoo Federation. Server render on Cloudflare workers via Astro.

Astro Cloudflare Workers Typescript CSS

Overview

SSoT for Nanoo Federation node registry. each member site connects in a circular webring - navigate forward or backward via redirect endpoints. Adding a site mean adding a JSON file to content collection.

Architecture & Tech Stack

  • Runtime: Cloudflare Workers (Edge SSR)
  • Framework: Astro v6 (SSR, server render)
  • Content: Astro content collections with zod validation
  • Styling: Plain CSS, Geist Mono

Quickstart

git clone https://github.com/nanoolabs/webrings.git
cd webrings
pnpm install
pnpm dev

Project Structure

src/
├── pages/          Routes (index.astro, next.ts, prev.ts)
├── content/rings/  Ring member data (JSON files per site)
├── components/     Astro component (RingNav.astro)
├── util/           Handshake renderer, protocol helper
└── consts.ts       Site & registry metadata

Adding a site

Create src/content/rings/<ring>/<id>.json:

{ "name": "Site Name", "id": "your-id", "url": "https://example.dev" }

Submit a PR.

Development & Ops

  • Dev: pnpm dev
  • Build: pnpm build
  • Deploy: pnpm deploy

Nanoo Labs Ecosystem

Part of nanoolabs.dev.

Contributing

  1. Checkout feat/your-feature.
  2. Conventional Commits.
  3. Submit a PR.

License

Proprietary — Nanoo Labs © 2026.

Based on astro-webrings repository by Louis Escher (@louisescher). Refactored and extended by Nanoo Labs.

About

Nanoo Federation Registry. Mapping the nodes of Nanoo. Sovereign engineering for decentralized discover

Topics

Resources

License

Code of conduct

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors