Update documentation assets and enhance SEO; replace logo, adjust navigation links, add sitemap plugin, and create robots.txt

Author: xentixar

docs/.vitepress/config.js

@@ -1,21 +1,61 @@
 import { defineConfig } from 'vitepress'
+import { sitemapPlugin } from './plugins/sitemap.js'
 
 export default defineConfig({
   title: 'Diffyne',
   description: 'Blazing-fast, server-driven UI framework for PHP powered by a lightweight Virtual DOM + Diff Engine',
 
   base: '/',
 
-  // Ignore dead links during build
-  ignoreDeadLinks: true,
+  // Plugins
+  vite: {
+    plugins: [sitemapPlugin()]
+  },
 
   head: [
-    ['link', { rel: 'icon', href: '/favicon.ico' }],
-    ['meta', { name: 'theme-color', content: '#3eaf7c' }]
+    // Favicon
+    ['link', { rel: 'icon', href: '/logo.png', type: 'image/png' }],
+    ['link', { rel: 'apple-touch-icon', href: '/logo.png' }],
+    
+    // Theme
+    ['meta', { name: 'theme-color', content: '#3eaf7c' }],
+    
+    // Open Graph / Facebook
+    ['meta', { property: 'og:type', content: 'website' }],
+    ['meta', { property: 'og:url', content: 'https://diffyne.github.io/' }],
+    ['meta', { property: 'og:title', content: 'Diffyne - Server-Driven UI for PHP' }],
+    ['meta', { property: 'og:description', content: 'Blazing-fast, server-driven UI framework for PHP powered by a lightweight Virtual DOM + Diff Engine' }],
+    ['meta', { property: 'og:image', content: 'https://diffyne.github.io/logo.png' }],
+    ['meta', { property: 'og:image:width', content: '1200' }],
+    ['meta', { property: 'og:image:height', content: '630' }],
+    ['meta', { property: 'og:image:alt', content: 'Diffyne Logo' }],
+    ['meta', { property: 'og:site_name', content: 'Diffyne' }],
+    ['meta', { property: 'og:locale', content: 'en_US' }],
+    
+    // Twitter Card
+    ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
+    ['meta', { name: 'twitter:url', content: 'https://diffyne.github.io/' }],
+    ['meta', { name: 'twitter:title', content: 'Diffyne - Server-Driven UI for PHP' }],
+    ['meta', { name: 'twitter:description', content: 'Blazing-fast, server-driven UI framework for PHP powered by a lightweight Virtual DOM + Diff Engine' }],
+    ['meta', { name: 'twitter:image', content: 'https://diffyne.github.io/logo.png' }],
+    ['meta', { name: 'twitter:image:alt', content: 'Diffyne Logo' }],
+    ['meta', { name: 'twitter:creator', content: '@diffyne' }],
+    ['meta', { name: 'twitter:site', content: '@diffyne' }],
+    
+    // Additional SEO
+    ['meta', { name: 'author', content: 'Diffyne' }],
+    ['meta', { name: 'keywords', content: 'PHP, Laravel, Server-Driven UI, Virtual DOM, Reactive Components, Livewire Alternative, PHP Framework' }],
+    ['meta', { name: 'robots', content: 'index, follow' }],
+    ['meta', { name: 'language', content: 'English' }],
+    ['meta', { name: 'revisit-after', content: '7 days' }],
+    
+    // Additional meta
+    ['meta', { name: 'viewport', content: 'width=device-width, initial-scale=1.0' }],
+    ['meta', { 'http-equiv': 'X-UA-Compatible', content: 'IE=edge' }]
   ],
 
   themeConfig: {
-    logo: '/logo.svg',
+    logo: '/logo.png',
 
     nav: [
       { text: 'Home', link: '/' },

docs/.vitepress/plugins/sitemap.js

@@ -0,0 +1,107 @@
+import { writeFileSync, readdirSync, existsSync } from 'fs'
+import { join, extname, dirname, resolve } from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+function getMarkdownFiles(dir, basePath = '') {
+    const files = []
+
+    if (!existsSync(dir)) {
+        return files
+    }
+
+    const entries = readdirSync(dir, { withFileTypes: true })
+
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name)
+        const relativePath = join(basePath, entry.name)
+
+        if (entry.isDirectory()) {
+            if (entry.name !== '.vitepress' && entry.name !== 'node_modules' && entry.name !== 'public') {
+                files.push(...getMarkdownFiles(fullPath, relativePath))
+            }
+        } else if (entry.isFile() && extname(entry.name) === '.md') {
+            let urlPath = '/' + relativePath.replace(/\.md$/, '').replace(/\\/g, '/')
+            if (urlPath.endsWith('/index')) {
+                urlPath = urlPath.replace(/\/index$/, '')
+            }
+            if (urlPath.endsWith('/README')) {
+                urlPath = urlPath.replace(/\/README$/, '')
+            }
+            if (urlPath === '/index' || urlPath === '/README') {
+                urlPath = '/'
+            }
+            files.push(urlPath)
+        }
+    }
+
+    return files
+}
+
+export function sitemapPlugin() {
+    let outDir = ''
+    let base = '/'
+
+    return {
+        name: 'sitemap-plugin',
+        configResolved(config) {
+            const relativeOutDir = config.build.outDir || '.vitepress/dist'
+            outDir = resolve(process.cwd(), 'docs', relativeOutDir)
+            base = config.base || '/'
+        },
+        closeBundle() {
+            const baseUrl = 'https://diffyne.github.io'
+            const lastmod = new Date().toISOString().split('T')[0]
+
+            const pages = []
+
+            const homeUrl = baseUrl + (base === '/' ? '' : base.replace(/\/$/, ''))
+            pages.push({
+                loc: homeUrl || baseUrl,
+                lastmod,
+                changefreq: 'daily',
+                priority: '1.0'
+            })
+
+            const docsDir = join(__dirname, '..', '..')
+            const markdownFiles = getMarkdownFiles(docsDir)
+
+            console.log(`Found ${markdownFiles.length} markdown files in ${docsDir}`)
+
+            const uniqueFiles = [...new Set(markdownFiles)].sort()
+
+            uniqueFiles.forEach(path => {
+                if (path === '/' || path === '') return
+
+                const fullPath = baseUrl + (base === '/' ? '' : base.replace(/\/$/, '')) + path
+                const priority = path.startsWith('/getting-started') ? '0.9' :
+                    path.startsWith('/features') ? '0.8' :
+                        path.startsWith('/advanced') ? '0.7' : '0.6'
+
+                pages.push({
+                    loc: fullPath,
+                    lastmod,
+                    changefreq: 'weekly',
+                    priority
+                })
+            })
+
+            const sitemap = `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${pages.map(page => `  <url>
+    <loc>${page.loc}</loc>
+    <lastmod>${page.lastmod}</lastmod>
+    <changefreq>${page.changefreq}</changefreq>
+    <priority>${page.priority}</priority>
+  </url>`).join('\n')}
+</urlset>`
+
+            const sitemapPath = join(outDir, 'sitemap.xml')
+            writeFileSync(sitemapPath, sitemap, 'utf-8')
+            console.log(`✓ Generated sitemap.xml with ${pages.length} pages`)
+        }
+    }
+}
+

docs/index.md

@@ -6,12 +6,12 @@ hero:
   text: Server-Driven UI for PHP
   tagline: Blazing-fast, reactive components powered by Virtual DOM
   image:
-    src: /logo.svg
+    src: /logo.png
     alt: Diffyne
   actions:
     - theme: brand
       text: Get Started
-      link: /guide/
+      link: /getting-started/installation
     - theme: alt
       text: View on GitHub
       link: https://github.com/diffyne/diffyne

docs/public/logo.png

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