How to publish a static website on IPFS
Prepare a portable build, identify the release, arrange retention, and test the gateway before changing your public entry point.
Compare delivery models around a complete website release. Keep availability, update authority, data retention, and domain control in the decision.
Inventory HTML, styles, scripts, images, and external requests. A site described as static may still rely on an API for navigation or content. Decide which dependencies are essential and which can be removed by publishing a more complete artifact.
For a documentation site, create a production folder that another host can serve without the original build environment. Test nested routes directly. An export that only works through the homepage may still rely on server behavior that has not travelled with the files.
A conventional static host can serve a reviewed artifact at a familiar hostname. IPFS adds a content-addressed distribution model, but retaining and serving the content still requires an operating plan. IPFS’s persistence documentation explains why a content identifier alone does not guarantee continuing availability.
Evaluate both approaches against the same requirements: who may publish, how versions are identified, what readers use as the entry point, and how the previous release is restored. A hybrid publication can be useful when its additional responsibilities are understood.
Include retained versions, traffic, monitoring, build review, and recovery effort. Do not compare only a small advertised storage allowance. Media, social previews, and previous releases can have a different growth pattern from article text.
Keep canonical URLs and social metadata aligned with the preferred public hostname. Verify that a mirror can deliver assets and deep links, then document the release sequence. An alternative is valuable when a maintainer can actually use it during a disruption.
Reference pointIPFS: persistence and pinning. The checks here are a proposed review framework; verify your own operating environment.
No. Retention, browser gateway delivery, naming, editorial publishing, and monitoring are separate responsibilities that still need an explicit design.
Yes. Publish a directory containing an index document for each route, then use ordinary links to those directories on a host that serves directory indexes.