appview/pages: seo improvements, sitemap, schemae and more

Signed-off-by: Anirudh Oppiliappan <[e-mail]>

appview/pages/repoinfo/repoinfo.go

···
 package repoinfo
 
 import (
+	"encoding/json"
 	"fmt"
 	"path"
 	"slices"
···
 func (r RolesInRepo) IsPushAllowed() bool {
 	return slices.Contains(r.Roles, "repo:push")
 }
+
+// PrimaryLanguage returns the first (most used) language from a list, or empty string if none
+func PrimaryLanguage(languages []interface{}) string {
+	if len(languages) == 0 {
+		return ""
+	}
+
+	// Languages are already sorted by percentage in descending order
+	// Just get the first one
+	if firstLang, ok := languages[0].(map[string]interface{}); ok {
+		if name, ok := firstLang["Name"].(string); ok {
+			return name
+		}
+	}
+
+	return ""
+}
+
+// StructuredData generates Schema.org JSON-LD structured data for the repository
+func (r RepoInfo) StructuredData(primaryLanguage string) string {
+	data := map[string]interface{}{
+		"@context":       "https://schema.org",
+		"@type":          "SoftwareSourceCode",
+		"name":           r.Name,
+		"description":    r.Description,
+		"codeRepository": "https://tangled.org/" + r.FullName(),
+		"url":            "https://tangled.org/" + r.FullName(),
+		"author": map[string]interface{}{
+			"@type": "Person",
+			"name":  r.owner(),
+			"url":   "https://tangled.org/" + r.owner(),
+		},
+	}
+
+	// Add programming language if available
+	if primaryLanguage != "" {
+		data["programmingLanguage"] = primaryLanguage
+	}
+
+	jsonBytes, err := json.Marshal(data)
+	if err != nil {
+		return "{}"
+	}
+	return string(jsonBytes)
+}

appview/pages/templates/fragments/breadcrumb.html

···
+{{ define "fragments/breadcrumb" }}
+    {{ $items := . }}
+    {{ if gt (len $items) 0 }}
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "BreadcrumbList",
+      "itemListElement": [
+        {{ range $idx, $item := $items }}
+        {{ if gt $idx 0 }},{{ end }}
+        {
+          "@type": "ListItem",
+          "position": {{ add $idx 1 }},
+          "name": "{{ index $item 0 }}",
+          "item": "{{ index $item 1 }}"
+        }
+        {{ end }}
+      ]
+    }
+    </script>
+    {{ end }}
+{{ end }}

appview/pages/templates/goodfirstissues/index.html

···
 {{ define "title" }}good first issues{{ end }}
 
 {{ define "extrameta" }}
+    <meta name="description" content="Discover beginner-friendly good first issues across open source projects on Tangled. Perfect for new contributors looking to get started with open source development." />
+    <meta name="keywords" content="good first issues, beginner issues, open source contribution, first time contributor, beginner friendly, open source projects" />
+
     <meta property="og:title" content="good first issues · tangled" />
-    <meta property="og:type" content="object" />
+    <meta property="og:type" content="website" />
     <meta property="og:url" content="https://tangled.org/goodfirstissues" />
-    <meta property="og:description" content="Find good first issues to contribute to open source projects" />
+    <meta property="og:description" content="Find beginner-friendly issues across all repositories to get started with open source contributions on Tangled." />
+
+    <meta name="twitter:card" content="summary" />
+    <meta name="twitter:title" content="good first issues · tangled" />
+    <meta name="twitter:description" content="Find beginner-friendly issues to get started with open source contributions." />
+
+    <!-- structured data for good first issues page -->
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "CollectionPage",
+      "name": "Good First Issues",
+      "description": "A curated collection of beginner-friendly issues across open source projects",
+      "url": "https://tangled.org/goodfirstissues",
+      "isPartOf": {
+        "@type": "WebSite",
+        "name": "Tangled",
+        "url": "https://tangled.org"
+      }
+    }
+    </script>
 {{ end }}
+
+{{ define "canonical" }}https://tangled.org/goodfirstissues{{ end }}
 
 {{ define "content" }}
 <div class="grid grid-cols-10">

appview/pages/templates/layouts/base.html

···
         <head>
             <meta charset="UTF-8" />
             <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
-            <meta name="description" content="Social coding, but for real this time!"/>
+            <meta name="description" content="tightly-knit social coding"/>
+            <meta name="keywords" content="git hosting, social coding, version control, pull requests, CI/CD, code collaboration, open source, decentralized"/>
             <meta name="htmx-config" content='{"includeIndicatorStyles": false}'>
+            <meta name="author" content="Tangled"/>
+
+            <!-- Canonical URL -->
+            <link rel="canonical" href="{{ block "canonical" . }}https://tangled.org{{ .Request.URL.Path }}{{ end }}" />
 
             <script defer src="/static/htmx.min.js"></script>
             <script defer src="/static/htmx-ext-ws.min.js"></script>
···
             <link rel="preconnect" href="https://avatar.tangled.sh" />
             <link rel="preconnect" href="https://camo.tangled.sh" />
 
+            <!-- RSS Feed Discovery -->
+            {{ block "rss" . }}{{ end }}
+
             <!-- pwa manifest -->
             <link rel="manifest" href="/pwa-manifest.json" />
 
···
             <link rel="preload" href="/static/fonts/InterVariable.woff2" as="font" type="font/woff2" crossorigin />
 
             <link rel="stylesheet" href="/static/tw.css?{{ cssContentHash }}" type="text/css" />
-            <title>{{ block "title" . }}{{ end }} · tangled</title>
+            <title>{{ block "title" . }}{{ end }}</title>
+
+            <!-- Structured Data -->
+            {{ block "structuredData" . }}
+            <script type="application/ld+json">
+            {
+              "@context": "https://schema.org",
+              "@type": "Organization",
+              "name": "Tangled",
+              "url": "https://tangled.org",
+              "logo": "https://tangled.org/favicon.svg",
+              "description": "tightly-knit social coding",
+              "sameAs": []
+            }
+            </script>
+            {{ end }}
+
             {{ block "extrameta" . }}{{ end }}
         </head>
         <body class="min-h-screen flex flex-col gap-4 bg-slate-100 dark:bg-gray-900 dark:text-white transition-colors duration-200">

appview/pages/templates/layouts/profilebase.html

···
     <meta property="og:image" content="{{ $avatarUrl }}" />
     <meta property="og:image:width" content="512" />
     <meta property="og:image:height" content="512" />
-    
+
     <meta name="twitter:card" content="summary" />
     <meta name="twitter:title" content="{{ $handle }}" />
     <meta name="twitter:description" content="{{ or .Card.Profile.Description $handle }}" />
     <meta name="twitter:image" content="{{ $avatarUrl }}" />
+
+    <!-- structured data for user profile -->
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "Person",
+      "name": "{{ or .Card.Profile.DisplayName .Card.UserHandle .Card.UserDid }}",
+      "url": "https://tangled.org/{{ or .Card.UserHandle .Card.UserDid }}",
+      "image": "{{ $avatarUrl }}",
+      "description": "{{ .Card.Profile.Description }}"{{ if .Card.UserHandle }},
+      "identifier": "{{ .Card.UserHandle }}"{{ end }}
+    }
+    </script>
+{{ end }}
+
+{{ define "canonical" }}https://tangled.org/{{ or .Card.UserHandle .Card.UserDid }}{{ end }}
+
+{{ define "rss" }}
+    <link rel="alternate" type="application/atom+xml" title="{{ or .Card.UserHandle .Card.UserDid }} Activity Feed" href="https://tangled.org/{{ or .Card.UserHandle .Card.UserDid }}/feed.atom" />
 {{ end }}
 
 {{ define "content" }}

appview/pages/templates/repo/index.html

···
     {{ template "repo/fragments/meta" . }}
 
     {{ template "repo/fragments/og" (dict "RepoInfo" .RepoInfo) }}
+    
+    <!-- Structured Data for Repository -->
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "SoftwareSourceCode",
+      "name": "{{ .RepoInfo.Name }}",
+      "description": "{{ .RepoInfo.Description }}",
+      "codeRepository": "https://tangled.org/{{ .RepoInfo.FullName }}",
+      "programmingLanguage": {{ if .Languages }}{{ range $idx, $lang := .Languages }}{{ if eq $idx 0 }}"{{ $lang.Name }}"{{ end }}{{ end }}{{ else }}"Unknown"{{ end }},
+      "url": "https://tangled.org/{{ .RepoInfo.FullName }}",
+      "author": {
+        "@type": "Person",
+        "name": "{{ .RepoInfo.OwnerWithAt }}",
+        "url": "https://tangled.org/{{ .RepoInfo.OwnerWithAt }}"
+      }{{ if .RepoInfo.Source }},
+      "isBasedOn": {
+        "@type": "SoftwareSourceCode",
+        "name": "{{ .RepoInfo.Source.Name }}",
+        "url": "https://tangled.org/{{ didOrHandle .RepoInfo.Source.Did .RepoInfo.SourceHandle }}/{{ .RepoInfo.Source.Name }}"
+      }{{ end }}
+    }
+    </script>
+    
+    <!-- Breadcrumb Navigation -->
+    {{ template "fragments/breadcrumb" (list
+        (list "Home" "https://tangled.org")
+        (list .RepoInfo.OwnerWithAt (printf "https://tangled.org/%s" .RepoInfo.OwnerWithAt))
+        (list .RepoInfo.Name (printf "https://tangled.org/%s" .RepoInfo.FullName))
+    ) }}
+{{ end }}
+
+{{ define "canonical" }}https://tangled.org/{{ .RepoInfo.FullName }}{{ end }}
+
+{{ define "rss" }}
+    <link rel="alternate" type="application/atom+xml" title="{{ .RepoInfo.FullName }} Activity Feed" href="https://tangled.org/{{ .RepoInfo.FullName }}/feed.atom" />
 {{ end }}
 
 {{ define "repoContent" }}

appview/pages/templates/repo/issues/fragments/og.html

···
-{{ define "repo/issues/fragments/og" }}
-    {{ $title := printf "%s #%d" .Issue.Title .Issue.IssueId }}
-    {{ $description := or .Issue.Body .RepoInfo.Description }}
-    {{ $url := printf "https://tangled.org/%s/issues/%d" .RepoInfo.FullName .Issue.IssueId }}
-    {{ $imageUrl := printf "https://tangled.org/%s/issues/%d/opengraph" .RepoInfo.FullName .Issue.IssueId }}
-
-    <meta property="og:title" content="{{ unescapeHtml $title }}" />
-    <meta property="og:type" content="object" />
-    <meta property="og:url" content="{{ $url }}" />
-    <meta property="og:description" content="{{ $description }}" />
-    <meta property="og:image" content="{{ $imageUrl }}" />
-    <meta property="og:image:width" content="1200" />
-    <meta property="og:image:height" content="600" />
-
-    <meta name="twitter:card" content="summary_large_image" />
-    <meta name="twitter:title" content="{{ unescapeHtml $title }}" />
-    <meta name="twitter:description" content="{{ $description }}" />
-    <meta name="twitter:image" content="{{ $imageUrl }}" />
-{{ end }}

appview/pages/templates/repo/pulls/fragments/og.html

···
-{{ define "repo/pulls/fragments/og" }}
-    {{ $title := printf "%s #%d" .Pull.Title .Pull.PullId }}
-    {{ $description := or .Pull.Body .RepoInfo.Description }}
-    {{ $url := printf "https://tangled.org/%s/pulls/%d" .RepoInfo.FullName .Pull.PullId }}
-    {{ $imageUrl := printf "https://tangled.org/%s/pulls/%d/opengraph" .RepoInfo.FullName .Pull.PullId }}
+ {{ define "pulls/fragments/og" }}
+     {{ $title := printf "%s #%d" .Pull.Title .Pull.PullId }}
+     {{ $description := or .Pull.Body .RepoInfo.Description }}
+     {{ $url := printf "https://tangled.org/%s/pulls/%d" .RepoInfo.FullName .Pull.PullId }}
+     {{ $imageUrl := printf "https://tangled.org/%s/pulls/%d/opengraph" .RepoInfo.FullName .Pull.PullId }}
 
-    <meta property="og:title" content="{{ unescapeHtml $title }}" />
-    <meta property="og:type" content="object" />
-    <meta property="og:url" content="{{ $url }}" />
-    <meta property="og:description" content="{{ $description }}" />
-    <meta property="og:image" content="{{ $imageUrl }}" />
-    <meta property="og:image:width" content="1200" />
-    <meta property="og:image:height" content="600" />
+     <meta property="og:title" content="{{ unescapeHtml $title }}" />
+     <meta property="og:type" content="object" />
+     <meta property="og:url" content="{{ $url }}" />
+     <meta property="og:description" content="{{ $description }}" />
+     <meta property="og:image" content="{{ $imageUrl }}" />
+     <meta property="og:image:width" content="1200" />
+     <meta property="og:image:height" content="600" />
 
-    <meta name="twitter:card" content="summary_large_image" />
-    <meta name="twitter:title" content="{{ unescapeHtml $title }}" />
-    <meta name="twitter:description" content="{{ $description }}" />
-    <meta name="twitter:image" content="{{ $imageUrl }}" />
+     <meta name="twitter:card" content="summary_large_image" />
+     <meta name="twitter:title" content="{{ unescapeHtml $title }}" />
+     <meta name="twitter:description" content="{{ $description }}" />
+     <meta name="twitter:image" content="{{ $imageUrl }}" />
 {{ end }}

appview/pages/templates/timeline/home.html

···
 {{ define "title" }}tangled · tightly-knit social coding{{ end }}
 
 {{ define "extrameta" }}
-    <meta property="og:title" content="timeline · tangled" />
-    <meta property="og:type" content="object" />
+    {{ $desc := "Collaborate on code with decentralized git hosting, modern contribution and review workflows, and lightweight CI/CD pipelines." }}
+    {{ $title = "tangled · tightly-knit social coding" }}
+
+    <meta name="description" content="{{ $desc }}" />
+    <meta property="og:title" content="{{ $title }}" />
+    <meta property="og:type" content="website" />
     <meta property="og:url" content="https://tangled.org" />
-    <meta property="og:description" content="tightly-knit social coding" />
+    <meta property="og:description" content="Decentralized git hosting with improved pull requests and lightweight CI/CD. Host repositories on your own infrastructure." />
+    <meta property="og:image" content="https://assets.tangled.network/tangled_og.png" />
+    <meta property="og:image:width" content="1200" />
+    <meta property="og:image:height" content="630" />
+
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:title" content="{{ $title }}" />
+    <meta name="twitter:description" content="{{ $desc }}" />
+    <meta name="twitter:image" content="https://assets.tangled.network/tangled_og.png" />
+
+    <!-- Enhanced Structured Data for Homepage -->
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "WebSite",
+      "name": "Tangled",
+      "alternateName": "Tangled",
+      "url": "https://tangled.org",
+      "description": "{{ $desc }}",
+      "potentialAction": {
+        "@type": "SearchAction",
+        "target": "https://tangled.org/?q={search_term_string}",
+        "query-input": "required name=search_term_string"
+      }
+    }
+    </script>
+    <script type="application/ld+json">
+    {
+      "@context": "https://schema.org",
+      "@type": "SoftwareApplication",
+      "name": "Tangled",
+      "applicationCategory": "DeveloperTool",
+      "offers": {
+        "@type": "Offer",
+        "price": "0",
+        "priceCurrency": "USD"
+      },
+      "operatingSystem": "Web",
+      "description": "{{ $desc }}"
+    }
+    </script>
 {{ end }}
+
+{{ define "canonical" }}https://tangled.org{{ end }}
 
 
 {{ define "content" }}

appview/state/router.go

···
 
 	router.Get("/pwa-manifest.json", s.WebAppManifest)
 	router.Get("/robots.txt", s.RobotsTxt)
+	router.Get("/sitemap.xml", s.Sitemap)
 
 	userRouter := s.UserRouter(&middleware)
 	standardRouter := s.StandardRouter(&middleware)

appview/state/state.go

···
 
 	robotsTxt := `User-agent: *
 Allow: /
+Disallow: /settings
+Disallow: /notifications
+Disallow: /login
+Disallow: /logout
+Disallow: /signup
+Disallow: /oauth
+Disallow: */settings$
+Disallow: */settings/*
+
+Crawl-delay: 1
+
+Sitemap: https://tangled.org/sitemap.xml
 `
 	w.Write([]byte(robotsTxt))
+}
+
+func (s *State) Sitemap(w http.ResponseWriter, r *http.Request) {
+	w.Header().Set("Content-Type", "application/xml; charset=utf-8")
+	w.Header().Set("Cache-Control", "public, max-age=3600")
+
+	// basic sitemap with static pages
+	sitemap := `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://tangled.org</loc>
+    <changefreq>daily</changefreq>
+    <priority>1.0</priority>
+  </url>
+  <url>
+    <loc>https://tangled.org/timeline</loc>
+    <changefreq>hourly</changefreq>
+    <priority>0.9</priority>
+  </url>
+  <url>
+    <loc>https://tangled.org/goodfirstissues</loc>
+    <changefreq>daily</changefreq>
+    <priority>0.8</priority>
+  </url>
+  <url>
+    <loc>https://tangled.org/terms</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.3</priority>
+  </url>
+  <url>
+    <loc>https://tangled.org/privacy</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.3</priority>
+  </url>
+  <url>
+    <loc>https://tangled.org/brand</loc>
+    <changefreq>monthly</changefreq>
+    <priority>0.5</priority>
+  </url>
+</urlset>`
+	w.Write([]byte(sitemap))
+}
+
+// https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Manifest
+const manifestJson = `{
+  "name": "tangled",
+  "description": "tightly-knit social coding.",
+  "icons": [
+    {
+      "src": "/favicon.svg",
+      "sizes": "144x144"
+    }
+  ],
+  "start_url": "/",
+  "id": "org.tangled",
+
+  "display": "standalone",
+  "background_color": "#111827",
+  "theme_color": "#111827"
+}`
+
+func (p *State) PWAManifest(w http.ResponseWriter, r *http.Request) {
+	w.Header().Set("Content-Type", "application/json")
+	w.Write([]byte(manifestJson))
 }
 
 func (s *State) TermsOfService(w http.ResponseWriter, r *http.Request) {