- Updated: March 18, 2026
- 5 min read
Introducing Wander: A Decentralized Web Console
Explore About FAQ Help Donate Register Sign in susam/wander Watch 1 Star 17 Fork You’ve already forked wander 0 Code Issues 2 Pull requests Activity A tiny, decentralised tool you can host with just two files to explore the small web 7 commits 1 branch 0 tags 50 KiB HTML 92.4% Makefile 4.6% JavaScript 3% main Find a file HTTPS Download ZIP Download TAR.GZ Download BUNDLE Open with VS Code Open with VSCodium Open with Intellij IDEA Susam Pal 90e7140643 Move the list of consoles before pages 2026-03-18 07:31:18 +00:00 .gitignore Create project 2026-03-18 06:33:55 +00:00 index.html Add a dialog box close button in top-right corner 2026-03-18 07:24:21 +00:00 LICENCE.md Create project 2026-03-18 06:33:55 +00:00 Makefile Add make targets to push project 2026-03-18 07:23:17 +00:00 README.md Move the list of consoles before pages 2026-03-18 07:31:18 +00:00 wander.js Move the list of consoles before pages 2026-03-18 07:31:18 +00:00 README.md Wander the Small Web Wander is a small, decentralised, self-hosted web console that lets your visitors explore random pages from a community of personal websites. Each Wander console loads personal websites and pages recommended by the Wander community.Further, each Wander console can link to other Wander consoles, forming a lightweight, decentralised network for browsing the small web of personal websites. Visit https://susam.net/wander/ to see an example of Wander console. How It Works A Wander console does two things: Wander pages: It loads a random page from a list of websites and pages recommended by the community.Wander consoles: It can send the visitor to another Wander console on a different website, where they can continue wandering the Web using the new Wander console. A Wander console is just a directory on your web server with two files: index.html – This is the HTML tool that implements the Wander console. wander.js – This is where you define the list of websites and pages you recommend and the other Wander consoles you want your console to link to.The most interesting aspect of Wander console is that everything happens on the client-side, on the user’s web browser. As a website owner, you do not need to set up any server-side components. The only thing you need to do is place the above two files somewhere on your webserver, preferrably, at the directory /wander/. Wandering the Web A visitor begins at a Wander console. This might be your own console or someone else’s. For example, you could start at https://susam.net/wander/ right now.Once on a Wander console, the visitor can click the Wander button at the top left to visit websites and pages recommended by the community. The first time you wander, the recommendation comes from the current console. The second time you wander, it comes from another console linked by the first. The third time you wander, it comes from a console linked by the second, and so on. In each hop, a console is chosen at random from those linked by the previous one.A website recommendation is then chosen at random from that console. In this way, each hop takes you deeper and deeper into the Wander network. Setup Download this bundle: https://codeberg.org/susam/wander/archive/main.zip Extract the following files: index.html wander.js Place them on your website, for example: wander ├── index.html └── wander.js Open wander.js and edit the following JavaScript object: window.wander = { consoles: [ ], pages: [ ], } The value for the pages property is a list of websites and pages you recommend to the community. The vlaue for the consoles property is a list of consoles your console should link to. Please see https://susam.net/wander/wander.js for an example. Once your console is live, share it with others in the following community thread: #1 Hopefully, someone will link to your console and then visitors to their console may receive recommendations from your wander.js.Licence This is free and open source software. You can use, copy, modify, merge, publish, distribute, sublicence and/or sell copies of it, under the terms of the MIT Licence. See LICENCE.md for details. This software is provided “AS IS”, WITHOUT WARRANTY OF ANY KIND, express or implied. See LICENCE.md for details. [{“Susam Pal\n\t\t\n\t\n\t\n\n\n\t90e7140643\n\n\t\n\n\t\n\tMove the list of consoles before pages”:”index.html”,”2026-03-18 07:31:18 +00:00″:”Add a dialog box close button in top-right corner”,”.gitignore”:”2026-03-18 07:24:21 +00:00″},{“Susam Pal\n\t\t\n\t\n\t\n\n\n\t90e7140643\n\n\t\n\n\t\n\tMove the list of consoles before pages”:”LICENCE.md”,”2026-03-18 07:31:18 +00:00″:”Create project”,”.gitignore”:”2026-03-18 06:33:55 +00:00″},{“Susam Pal\n\t\t\n\t\n\t\n\n\n\t90e7140643\n\n\t\n\n\t\n\tMove the list of consoles before pages”:”Makefile”,”2026-03-18 07:31:18 +00:00″:”Add make targets to push project”,”.gitignore”:”2026-03-18 07:23:17 +00:00″},{“Susam Pal\n\t\t\n\t\n\t\n\n\n\t90e7140643\n\n\t\n\n\t\n\tMove the list of consoles before pages”:”README.md”,”2026-03-18 07:31:18 +00:00″:”Move the list of consoles before pages”,”.gitignore”:”2026-03-18 07:31:18 +00:00″},{“Susam Pal\n\t\t\n\t\n\t\n\n\n\t90e7140643\n\n\t\n\n\t\n\tMove the list of consoles before pages”:”wander.js”,”2026-03-18 07:31:18 +00:00″:”Move the list of consoles before pages”,”.gitignore”:”2026-03-18 07:31:18 +00:00″}]