From c8e02b48654d794e92239c608c56aff32ffe3877 Mon Sep 17 00:00:00 2001
From: Suryansh Prajapati <58465650+drk1rd@users.noreply.github.com>
Date: Sun, 11 Oct 2026 01:10:54 +0530
Subject: [PATCH] Site SEO: robots.txt, sitemap, a real 404 page, and
 structured data

---
 pages/404.html    | 33 +++++++++++++++++++++++++++++++++
 pages/index.html  |  2 ++
 pages/robots.txt  |  5 +++++
 pages/sitemap.xml | 15 +++++++++++++++
 4 files changed, 55 insertions(+)
 create mode 100644 pages/404.html
 create mode 100644 pages/robots.txt
 create mode 100644 pages/sitemap.xml

diff --git a/pages/404.html b/pages/404.html
new file mode 100644
index 00000000..87dd4064
--- /dev/null
+++ b/pages/404.html
@@ -0,0 +1,33 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Page not found · HomeCloud</title>
+<meta name="robots" content="noindex">
+<link rel="icon" href="/favicon.svg" type="image/svg+xml">
+<link rel="stylesheet" href="/site.css">
+<style>
+  .nf { min-height: 100vh; display: grid; place-items: center; padding: 24px 16px; text-align: center; }
+  .nf h1 { font-size: clamp(2rem, 6vw, 3.25rem); letter-spacing: -0.03em; margin: 12px 0 8px; }
+  .nf p { color: var(--muted, #a1a1aa); margin: 0 0 24px; }
+  .nf .links { display: flex; gap: 12px; justify-content: center; flex-wrap: wrap; }
+  .nf a.btn { display: inline-block; padding: 10px 16px; border-radius: 10px; border: 1px solid var(--border, rgba(255,255,255,.12)); text-decoration: none; color: inherit; }
+  .nf code { font-family: var(--mono, ui-monospace, monospace); opacity: .7; }
+</style>
+</head>
+<body>
+<main class="nf">
+  <div>
+    <img src="/favicon.svg" width="44" height="44" alt="HomeCloud">
+    <h1>Page not found</h1>
+    <p><code>404</code> · This page doesn't exist.</p>
+    <div class="links">
+      <a class="btn" href="/">HomeCloud home</a>
+      <a class="btn" href="/demo/">Demo console</a>
+      <a class="btn" href="https://github.com/solinode/homecloud">GitHub</a>
+    </div>
+  </div>
+</main>
+</body>
+</html>
diff --git a/pages/index.html b/pages/index.html
index 227d56c2..8d3bc2ae 100644
--- a/pages/index.html
+++ b/pages/index.html
@@ -6,6 +6,7 @@
 <title>HomeCloud: an AWS-compatible cloud you run yourself</title>
 <meta name="description" content="HomeCloud is an open-source, self-hosted cloud that speaks the AWS APIs. Point Terraform, the AWS CLI and the SDKs at it; Lambda, RDS, EC2 and about 30 other services run as real containers and VMs on your own machine.">
 <link rel="canonical" href="https://homecloud.pages.dev/">
+<link rel="sitemap" type="application/xml" href="/sitemap.xml">
 <meta property="og:type" content="website">
 <meta property="og:site_name" content="HomeCloud">
 <meta property="og:url" content="https://homecloud.pages.dev/">
@@ -34,6 +35,7 @@
   gtag('js', new Date());
   gtag('config', 'G-SW07QRM18M');
 </script>
+<script type="application/ld+json">{"@context":"https://schema.org","@type":"SoftwareApplication","name":"HomeCloud","description":"An open-source, self-hosted cloud that speaks the AWS APIs. Point Terraform, the AWS CLI and the SDKs at it; Lambda, RDS, EC2 and about 30 other services run as real containers and VMs on your own machine.","url":"https://homecloud.pages.dev/","applicationCategory":"DeveloperApplication","operatingSystem":"Linux, macOS, Windows","softwareVersion":"0.4.0","license":"https://www.gnu.org/licenses/agpl-3.0.html","downloadUrl":"https://github.com/solinode/homecloud/releases/latest","codeRepository":"https://github.com/solinode/homecloud","image":"https://homecloud.pages.dev/images/og.png","offers":{"@type":"Offer","price":"0","priceCurrency":"USD"},"author":{"@type":"Organization","name":"Solinode","url":"https://github.com/solinode"}}</script>
 </head>
 <body>
 <a class="skip" href="#main">Skip to content</a>
diff --git a/pages/robots.txt b/pages/robots.txt
new file mode 100644
index 00000000..fab04604
--- /dev/null
+++ b/pages/robots.txt
@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+Disallow: /files/
+
+Sitemap: https://homecloud.pages.dev/sitemap.xml
diff --git a/pages/sitemap.xml b/pages/sitemap.xml
new file mode 100644
index 00000000..efbfa12d
--- /dev/null
+++ b/pages/sitemap.xml
@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://homecloud.pages.dev/</loc>
+    <lastmod>2026-10-11</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://homecloud.pages.dev/demo/</loc>
+    <lastmod>2026-10-11</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>0.8</priority>
+  </url>
+</urlset>