{"id":29042527,"url":"https://github.com/mystenlabs/walrus-sites","last_synced_at":"2026-02-09T14:04:16.626Z","repository":{"id":244968248,"uuid":"714043074","full_name":"MystenLabs/walrus-sites","owner":"MystenLabs","description":"Walrus Sites: Decentralized Websites using Sui and Walrus.","archived":false,"fork":false,"pushed_at":"2025-06-25T14:23:07.000Z","size":4934,"stargazers_count":145,"open_issues_count":10,"forks_count":56,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-06-25T14:29:05.055Z","etag":null,"topics":["blockchain","sui","walrus","website"],"latest_commit_sha":null,"homepage":"https://wal.app","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MystenLabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-11-03T19:37:09.000Z","updated_at":"2025-06-24T15:39:07.000Z","dependencies_parsed_at":"2024-07-22T10:44:24.612Z","dependency_job_id":"d1845e86-40d6-44e6-988e-61938eb918fb","html_url":"https://github.com/MystenLabs/walrus-sites","commit_stats":null,"previous_names":["mystenlabs/walrus-sites"],"tags_count":168,"template":false,"template_full_name":null,"purl":"pkg:github/MystenLabs/walrus-sites","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MystenLabs%2Fwalrus-sites","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MystenLabs%2Fwalrus-sites/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MystenLabs%2Fwalrus-sites/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MystenLabs%2Fwalrus-sites/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MystenLabs","download_url":"https://codeload.github.com/MystenLabs/walrus-sites/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MystenLabs%2Fwalrus-sites/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262095238,"owners_count":23258120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","sui","walrus","website"],"created_at":"2025-06-26T15:34:35.774Z","updated_at":"2026-01-29T16:08:28.761Z","avatar_url":"https://github.com/MystenLabs.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Walrus Sites!\n\n[![License](https://img.shields.io/github/license/MystenLabs/walrus-sites)](https://github.com/MystenLabs/walrus-sites/blob/main/LICENSE)\n\nWalrus Sites are \"web\"-sites built using decentralized tech such as [Walrus][walrus-link]\na decentralized storage network, and the [Sui blockchain][sui-link].\n\nThis means that there is no central authority hosting the sites. Only the owner of the site is in\ncharge of the site's content and updates.\n\n[Use cases][use-cases] can span from censorship resistant sites to decentralized applications.\n\n## Overview\n\nAt a high level, Walrus is used to store the files of the site (your CSS, JS, HTML etc.),\nwhile a Sui smart contract is used to manage the metadata and ownership of the site.\n\nOnce you publish a site using the  `site-builder` CLI tool, you can access a site using a `portal`.\nPortals are centralized services that provide a way to gather the site resources and serve them to the user.\n\n\u003e Anyone can host their own portal and access Walrus Sites freely!\n\nTo browse walrus sites, you can either host your own local portal or access a third-party deployment\non the internet like https://wal.app.\n\nDomain resolution of Walrus Sites is done with a combination of traditional wildcard domains (e.g. `*.wal.app`)\nand the use of subdomains that correspond to [SuiNS domains][suisns].\n\nFor example, let's analyze the following site: https://stake-wal.wal.app\n\n1. We are provided with a third-party portal: https://wal.app.\n2. The site SuiNS domain is `stake`, so we need to use it as a subdomain of wal.app: `stake-wal.wal.app`.\n3. Therefore, we can access the site with standard HTTPS at `https://stake-wal.wal.app`.\n\nDocumentation of Walrus and Walrus Sites is available at [docs.wal.app][walrus-sites-docs].\n\n\u003e Fun fact: the documentation is itself a Walrus Site!\n\n## Quick Start\n\nWalrus Sites undergo a lot of changes, so the best way to avoid confusion with deprecated features\nplease start by following the guide [here](https://docs.wal.app/walrus-sites/intro.html).\n\n## File structure\n\nThis repository contains the various components of a working Walrus Site.\nTo navigate the repository, these are the crucial directories you should know about:\n\n- The [`site-builder`](./site-builder/) is a Rust CLI tool to create and edit your Walrus Sites, starting from the\n  output of a standard website building tool (i.e., a directory containing html/css/js, like `dist/` or `build/`).\n- [`portal`](./portal/) contains the implementations of the portals to access Walrus Sites.\n  - [`server`](./portal/server/) contains the implementation of an HTTP server portal. When in doubt, deploy this one.\n  - [`worker`](./portal/worker/) contains the implementation of a [service-worker][service-worker] portal.\n- In [`examples`](./examples/) there is a handy collection of websites to test the functions of the Walrus\n  Sites.\n- [`move`](./move/) contains the smart contract for creating and updating Walrus Sites on chain.\n- In [`c4`](./c4/) there is the C4 model depicting the architecture of the project.\n\n## Star History\n\nWalrus Sites is open source! Here is a graph showing the star history over time.\n\n[![Star History Chart](https://api.star-history.com/svg?repos=MystenLabs/walrus-sites\u0026type=Date)](https://star-history.com/#MystenLabs/walrus-sites\u0026Date)\n\n[walrus-link]: https://www.walrus.xyz/\n[sui-link]: https://docs.sui.io/\n[use-cases]: https://docs.wal.app/design/objectives_use_cases.html#use-cases\n[walrus-sites-docs]: https://docs.wal.app/walrus-sites/intro.html\n[service-worker]: https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API\n[suins]: https://suins.io/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmystenlabs%2Fwalrus-sites","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmystenlabs%2Fwalrus-sites","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmystenlabs%2Fwalrus-sites/lists"}