feat(site): prerender every locale and publish structured data, llms.txt and sitemaps

Crawlers received an empty client-rendered shell (107 characters of text); most AI crawlers do not run JavaScript, so the product was invisible to them. - Build renders each locale to static HTML (/ for Korean, /en/ … /vi/) with src/entry-server.tsx + scripts/prerender.mjs; the browser hydrates the same locale. The language menu links to those pages instead of switching in place. - Per-locale head: title, description, canonical, hreflang (+ x-default /en/), Open Graph and X cards with a per-locale 1200x630 image. - JSON-LD graph: Organization, WebSite, WebPage, SoftwareApplication (KRW offers, version, release date, download URL from the canonical sources), HowTo and FAQPage. No invented ratings. - robots.txt (search, ai-input and ai-train allowed; /app, /api, invites excluded), sitemap.xml with language alternates, llms.txt and llms-full.txt generated from the same translations and canonical values. - IndexNow key and a post-deploy ping (Bing, Naver, Yandex). - A factual "at a glance" section and two FAQ answers (recognised languages, where data is stored) in all 10 languages. - Icons, apple-touch-icon and web manifest; asset base is now absolute so sub-path pages load the same bundle. Verified: 3.6k-7.7k characters of text per page, no hydration warnings, no overflow at 320/1440 in six locales, axe 0, Lighthouse mobile SEO, accessibility and best practices 100.
2026-09-27 10:45:05 +09:00 · 2026-09-27 10:45:05 +09:00 · a0abda7a5c
commit a0abda7a5c
parent 52e364e578
45 changed files with 852 additions and 79 deletions
--- a/site/scripts/prerender.mjs
+++ b/site/scripts/prerender.mjs
@ -0,0 +1,40 @@
+// site/scripts/prerender.mjs
+// `vite build`(브라우저용)와 `vite build --ssr`(서버용) 뒤에 실행한다.
+// 언어마다 본문이 채워진 HTML(dist/index.html, dist/<lang>/index.html)과
+// sitemap.xml, robots.txt, llms.txt, llms-full.txt 를 만든다.
+// 크롤러(검색·AI)는 JavaScript 를 실행하지 않아도 전체 내용을 읽을 수 있다.
+
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const siteRoot = join(dirname(fileURLToPath(import.meta.url)), '..')
+const dist = join(siteRoot, 'dist')
+const ssrDir = join(siteRoot, 'dist-ssr')
+
+const server = await import(pathToFileURL(join(ssrDir, 'entry-server.js')).href)
+const template = readFileSync(join(dist, 'index.html'), 'utf8')
+
+for (const marker of ['<!--app-head-->', '<!--app-html-->', '<html lang="ko">']) {
+  if (!template.includes(marker)) throw new Error(`prerender: index.html 에 ${marker} 가 없다`)
+}
+
+for (const { code } of server.LOCALES) {
+  const html = template
+    .replace('<html lang="ko">', `<html lang="${code}">`)
+    .replace('<!--app-head-->', server.buildHead(code))
+    .replace('<!--app-html-->', server.render(code))
+  const out = join(dist, server.localePath(code), 'index.html')
+  mkdirSync(dirname(out), { recursive: true })
+  writeFileSync(out, html)
+}
+
+const lastmod = new Date().toISOString().slice(0, 10)
+writeFileSync(join(dist, 'sitemap.xml'), server.buildSitemap(lastmod))
+writeFileSync(join(dist, 'robots.txt'), server.buildRobots())
+writeFileSync(join(dist, 'llms.txt'), server.buildLlms())
+writeFileSync(join(dist, 'llms-full.txt'), server.buildLlmsFull())
+writeFileSync(join(dist, 'indexnow-urls.json'), JSON.stringify(server.sitemapUrls(), null, 2))
+
+rmSync(ssrDir, { recursive: true, force: true })
+console.log(`[prerender] ${server.LOCALES.length} locales + sitemap.xml, robots.txt, llms.txt, llms-full.txt`)