seo

Author: gildesmarais

.github/copilot-instructions.md

@@ -47,6 +47,7 @@ Create comprehensive, user-friendly documentation that showcases html2rss capabi
 - Use consistent terminology
 - Ensure the Site Navigation is assembled in a logical and user-friendly manner.
 - Prevent adding (and remove existing) "technical clutter" content.
+- follow AIDA-model to craft ensure content is engaging and SEO-friendly
 
 ## Performance & SEO
 

assets/images/site.webmanifest

@@ -1,6 +1,9 @@
 {
-  "name": "",
-  "short_name": "",
+  "name": "html2rss - Turn Any Website Into RSS",
+  "short_name": "html2rss",
+  "description": "Create RSS feeds from any website - no coding required. Turn blogs, news sites, and forums into RSS feeds you can follow in your favorite reader.",
+  "start_url": "/",
+  "scope": "/",
   "icons": [
     {
       "src": "/assets/images/android-chrome-192x192.png",

astro.config.mjs

@@ -1,6 +1,7 @@
 // @ts-check
 import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
+import sitemap from "@astrojs/sitemap";
 
 // https://astro.build/config
 export default defineConfig({
@@ -9,14 +10,44 @@ export default defineConfig({
   redirects: {
     // Only redirect actual old Jekyll URLs that need to be redirected
   },
+  build: {
+    inlineStylesheets: "auto",
+  },
+  image: {
+    domains: ["html2rss.github.io"],
+    remotePatterns: [
+      {
+        protocol: "https",
+        hostname: "html2rss.github.io",
+      },
+    ],
+  },
+  vite: {
+    build: {
+      rollupOptions: {
+        output: {
+          manualChunks: {
+            vendor: ["@astrojs/starlight"],
+          },
+        },
+      },
+    },
+  },
   integrations: [
+    sitemap({
+      filter: (page) => {
+        // Simple path-based exclusion for known noindex pages
+        return !page.includes("/feed-directory/");
+      },
+    }),
     starlight({
       title: "html2rss",
       description:
         "html2rss brings back RSS. It's an open source project with decentralised instances. These instances generate RSS feeds for websites which do not offer them.",
       logo: {
         src: "./src/assets/logo.png",
         replacesTitle: true,
+        alt: "html2rss logo - Turn any website into RSS",
       },
       head: [
         {
@@ -54,6 +85,49 @@ export default defineConfig({
             content: "#111111",
           },
         },
+        {
+          tag: "meta",
+          attrs: {
+            name: "keywords",
+            content:
+              "RSS, feed, web scraping, automation, open source, Ruby, Astro, Starlight, html2rss, RSS generator, website to RSS",
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            name: "author",
+            content: "html2rss team",
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            name: "robots",
+            content: "index, follow, max-image-preview:large, max-snippet:-1, max-video-preview:-1",
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            property: "og:type",
+            content: "website",
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            property: "og:site_name",
+            content: "html2rss",
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            property: "og:locale",
+            content: "en_US",
+          },
+        },
         {
           tag: "link",
           attrs: {
@@ -102,6 +176,15 @@ export default defineConfig({
             href: "/assets/images/favicon.ico",
           },
         },
+        {
+          tag: "link",
+          attrs: {
+            rel: "preload",
+            href: "/assets/images/logo.png",
+            as: "image",
+            type: "image/png",
+          },
+        },
         {
           tag: "script",
           attrs: {
@@ -110,6 +193,44 @@ export default defineConfig({
             src: "//gc.zgo.at/count.js",
           },
         },
+        {
+          tag: "script",
+          attrs: {
+            type: "application/ld+json",
+          },
+          content: JSON.stringify({
+            "@context": "https://schema.org",
+            "@type": "SoftwareApplication",
+            name: "html2rss",
+            description:
+              "html2rss brings back RSS. It's an open source project with decentralised instances. These instances generate RSS feeds for websites which do not offer them.",
+            url: "https://html2rss.github.io",
+            applicationCategory: "DeveloperApplication",
+            operatingSystem: "Web",
+            offers: {
+              "@type": "Offer",
+              price: "0",
+              priceCurrency: "USD",
+            },
+            author: {
+              "@type": "Organization",
+              name: "html2rss",
+              url: "https://github.com/html2rss",
+            },
+            license: "https://github.com/html2rss/html2rss/blob/main/LICENSE",
+            codeRepository: "https://github.com/html2rss/html2rss",
+            programmingLanguage: "Ruby",
+            keywords: "RSS, feed, web scraping, automation, open source, Ruby, Astro, Starlight",
+            featureList: [
+              "Create RSS feeds from any website",
+              "No coding required",
+              "Open source",
+              "Decentralized instances",
+              "Web application interface",
+              "Ruby gem for developers",
+            ],
+          }),
+        },
       ],
       social: [
         {
@@ -175,12 +296,12 @@ export default defineConfig({
           ],
         },
         {
-          label: "About",
-          link: "/about",
+          label: "Write Your Own Feed Configs",
+          link: "/html2rss-configs",
         },
         {
-          label: "Creating Custom Feeds",
-          link: "/html2rss-configs",
+          label: "About",
+          link: "/about",
         },
         {
           label: "Get Involved",

package-lock.json

@@ -14,6 +14,7 @@
     "lintfix": "prettier --write ."
   },
   "dependencies": {
+    "@astrojs/sitemap": "^3.6.0",
     "@astrojs/starlight": "^0.35.3",
     "astro": "^5.6.1",
     "sharp": "^0.34.2"

package.json

@@ -1,6 +1,9 @@
 {
-  "name": "",
-  "short_name": "",
+  "name": "html2rss - Turn Any Website Into RSS",
+  "short_name": "html2rss",
+  "description": "Create RSS feeds from any website - no coding required. Turn blogs, news sites, and forums into RSS feeds you can follow in your favorite reader.",
+  "start_url": "/",
+  "scope": "/",
   "icons": [
     {
       "src": "/assets/images/android-chrome-192x192.png",

public/assets/site.webmanifest

@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+Disallow: /feed-directory/
+
+Sitemap: https://html2rss.github.io/sitemap.xml

public/robots.txt

@@ -35,7 +35,7 @@ const staticFeedUrls = configs.map((config) => ({
 <div class="container">
   <!-- Progressive Enhancement: Works without JavaScript -->
   <div class="filters">
-    <label for="instance-url-input"> Instance URL </label>
+    <label for="instance-url-input">Instance URL</label>
     <input
       type="text"
       name="instance"
@@ -45,7 +45,7 @@ const staticFeedUrls = configs.map((config) => ({
       placeholder="https://your-instance.com"
     />
 
-    <label for="search-input"> Search Feeds </label>
+    <label for="search-input">Search Feeds</label>
     <input
       type="search"
       name="search"
@@ -197,6 +197,8 @@ const staticFeedUrls = configs.map((config) => ({
 
   .input {
     width: 100%;
+    padding: 0.125rem 0.5rem;
+    font-family: monospace;
   }
 
   /* List Layout */
@@ -222,6 +224,10 @@ const staticFeedUrls = configs.map((config) => ({
     font-weight: 600;
     color: hsl(var(--sl-color-text));
     line-height: 1.3;
+  }
+
+  .feed-title,
+  .feed-title > span {
     user-select: all;
     white-space: nowrap;
   }
@@ -246,6 +252,7 @@ const staticFeedUrls = configs.map((config) => ({
 
   .source-url {
     margin-top: 0.25rem;
+    display: none;
   }
 
   .source-link {
@@ -337,7 +344,7 @@ const staticFeedUrls = configs.map((config) => ({
     display: flex;
     flex-direction: column;
     background: hsl(var(--sl-color-bg));
-    padding: 1rem;
+    padding: 0.5rem;
     transition: all 0.2s ease;
     border-bottom: 1px solid hsl(var(--sl-color-gray-4));
   }
@@ -349,7 +356,6 @@ const staticFeedUrls = configs.map((config) => ({
   .feed-main {
     display: flex;
     flex-direction: column;
-    gap: 1rem;
   }
 
   .feed-info {
@@ -360,7 +366,7 @@ const staticFeedUrls = configs.map((config) => ({
     order: 2;
     display: flex;
     flex-direction: row;
-    gap: 0.5rem;
+    gap: 0.25rem;
     width: 100%;
     justify-content: flex-start;
     align-items: center;
@@ -428,14 +434,13 @@ const staticFeedUrls = configs.map((config) => ({
     }
 
     .feed-item {
-      padding: 0.75rem 1rem;
+      padding: 0;
     }
 
     .feed-main {
       flex-direction: row;
       justify-content: space-between;
       align-items: center;
-      gap: 1rem;
     }
 
     .feed-info {
@@ -447,7 +452,6 @@ const staticFeedUrls = configs.map((config) => ({
     .actions {
       order: 2;
       flex-direction: row;
-      gap: 0.5rem;
       width: auto;
       flex-shrink: 0;
       align-items: center;
@@ -456,7 +460,6 @@ const staticFeedUrls = configs.map((config) => ({
     .action-button {
       width: auto;
       height: 32px;
-      padding: 0.25rem 0.75rem;
       font-size: 0.75rem;
       border-radius: 0.25rem;
     }