vaibring

A curated webring for sites on a similar wavelength.

Still open to anyone, if Vaibhav vibes with your site, you’re in.

Join the ring GitHub ↗
01

The ring

Members appear in ring order, as defined in sites.json (the list wraps from last back to first).

02

Widget preview

Preview of the embeddable navigation bar. Available themes:

retro
dark
light
03

Embed the widget

Add a single script element to your page, for example:

<!-- vaibring widget --> <script src="https://v8v88v8v88.github.io/vaibring/webring/widget.js" data-ring="https://cdn.jsdelivr.net/gh/v8v88v8v88/vaibring@main/webring/sites.json" data-theme="retro" async ></script>

Set data-theme to retro or dark, or omit it for the default light theme. Use data-label to change the text shown for the ring name.

data-ring: point at the jsDelivr URL above (same file as in the repo, works with fetch() from any site). You do not need to host sites.json yourself. Omit data-ring and the script uses that URL by default.

04

Custom links

To use your own layout and styles, add three anchor elements and include minimal.js. The script loads the ring data and sets each link’s destination; you supply the markup and CSS.

<!-- your markup --> <a data-vaibring="prev" href="#">←</a> <a data-vaibring="random" href="#">random</a> <a data-vaibring="next" href="#">→</a> <script src="https://v8v88v8v88.github.io/vaibring/webring/minimal.js" data-ring="https://cdn.jsdelivr.net/gh/v8v88v8v88/vaibring@main/webring/sites.json" async ></script>

Troubleshooting: if prev/next/random stay href="#", the ring JSON did not load (often CORS). Use the jsDelivr data-ring URL above; GitHub Pages alone does not send CORS headers on static JSON.

05

Join the ring

Complete each step in order. Pull requests are reviewed before merge.

  1. Fork the vaibring repository on GitHub.
  2. In your fork, edit webring/sites.json and append an object for your site using this shape:
    { "name": "your site", "url": "https://yoursite.com", "description": "a short description" }
  3. On your live site, add webring navigation: either the widget or custom links via minimal.js, before your pull request is merged.
  4. Open a pull request against the upstream repository. Continuous integration validates sites.json and related checks.
  5. After your pull request is merged, your site appears in the member list below.
Membership is curated. Not every pull request is merged.
06

About

A webring is just a circle of websites. Everyone in the list links to who is “before” and “after” them (and usually a random pick). You move around the ring with those links — no feed, no score, only the order people agreed on. It is a simple way to stumble from one personal site to the next.

vaibring is a webring run by V8. He has always liked webrings, so he set this one up for friends and for like-minded people who want the same small-web vibe.

Member sites are listed in webring/sites.json; the hub and widget are static files on GitHub Pages. Source on GitHub →