fix: static routes (#2)

* fix: static routes

* chore: tweaks

* chore: up

* chore: up

* chore: up

Author: tmm

.github/workflows/pull_request.yml

@@ -96,6 +96,7 @@ jobs:
         run: pnpm build
         env:
           CLOUDFLARE_ENV: preview
+          GIT_SHA: ${{ github.event.pull_request.head.sha }}
 
       - name: Deploy preview
         uses: cloudflare/wrangler-action@da0e0dfe58b7a431659754fdf3f186c529afbe65 # v3.14.1

.github/workflows/verify.yml

@@ -21,8 +21,13 @@ jobs:
       - name: Lint
         run: pnpm check
 
+      - name: Run migrations
+        run: pnpm exec wrangler d1 migrations apply DB --local
+
       - name: Generate types
-        run: pnpm gen:types
+        run: |
+          pnpm gen:types
+          pnpm db:codegen
 
       - name: Check types
         run: pnpm check:types

AGENTS.md

@@ -51,3 +51,4 @@ App runs in Docker via `docker compose up`. Use these to debug:
 
 - **Tailwind CSS v4** - Use `@import "tailwindcss"` in CSS; utility classes in components
   - Use logical properties for RTL/LTR support (e.g. `ms-4`/`me-4` instead of `ml-4`/`mr-4`, `start-2`/`end-2` instead of `left-2`/`right-2`)
+  - Do NOT concatenate class names for conditional styles. Use `data-*` attributes with Tailwind's `data-[...]` variant instead (e.g., `data-[active]:bg-blue9` + `data-active={cond ? '' : undefined}`)

src/lib/db.gen.ts

@@ -11,7 +11,7 @@ type request = {
   country: string | null
   created_at: k.Generated<string>
   hostname: string
-  id: string
+  id: k.Generated<string>
   path: string
   query: string | null
   url: string

src/lib/known-md-sites.ts

@@ -76,10 +76,28 @@ function appendMdWithIndex(url: URL): URL {
   return mdUrl
 }
 
+const githubDocsLangs = new Set([
+  'cn',
+  'de',
+  'en',
+  'es',
+  'fr',
+  'ja',
+  'ko',
+  'pt',
+  'ru',
+  'zh',
+])
+
 function githubDocsArticle(url: URL): MdUrlResult {
   const mdUrl = new URL(url.href)
   mdUrl.pathname = '/api/article'
-  mdUrl.searchParams.set('pathname', url.pathname)
+  const firstSegment = url.pathname.split('/')[1]
+  const pathname =
+    firstSegment && githubDocsLangs.has(firstSegment)
+      ? url.pathname
+      : `/en${url.pathname}`
+  mdUrl.searchParams.set('pathname', pathname)
   return {
     url: mdUrl,
     parse: (content) => {

src/routeTree.gen.ts

@@ -9,11 +9,17 @@
 // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
 
 import { Route as rootRouteImport } from './routes/__root'
+import { Route as SkillsRouteImport } from './routes/skills'
 import { Route as McpRouteImport } from './routes/mcp'
 import { Route as LlmsDottxtRouteImport } from './routes/llms[.]txt'
 import { Route as SplatRouteImport } from './routes/$'
 import { Route as IndexRouteImport } from './routes/index'
 
+const SkillsRoute = SkillsRouteImport.update({
+  id: '/skills',
+  path: '/skills',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const McpRoute = McpRouteImport.update({
   id: '/mcp',
   path: '/mcp',
@@ -40,37 +46,48 @@ export interface FileRoutesByFullPath {
   '/$': typeof SplatRoute
   '/llms.txt': typeof LlmsDottxtRoute
   '/mcp': typeof McpRoute
+  '/skills': typeof SkillsRoute
 }
 export interface FileRoutesByTo {
   '/': typeof IndexRoute
   '/$': typeof SplatRoute
   '/llms.txt': typeof LlmsDottxtRoute
   '/mcp': typeof McpRoute
+  '/skills': typeof SkillsRoute
 }
 export interface FileRoutesById {
   __root__: typeof rootRouteImport
   '/': typeof IndexRoute
   '/$': typeof SplatRoute
   '/llms.txt': typeof LlmsDottxtRoute
   '/mcp': typeof McpRoute
+  '/skills': typeof SkillsRoute
 }
 export interface FileRouteTypes {
   fileRoutesByFullPath: FileRoutesByFullPath
-  fullPaths: '/' | '/$' | '/llms.txt' | '/mcp'
+  fullPaths: '/' | '/$' | '/llms.txt' | '/mcp' | '/skills'
   fileRoutesByTo: FileRoutesByTo
-  to: '/' | '/$' | '/llms.txt' | '/mcp'
-  id: '__root__' | '/' | '/$' | '/llms.txt' | '/mcp'
+  to: '/' | '/$' | '/llms.txt' | '/mcp' | '/skills'
+  id: '__root__' | '/' | '/$' | '/llms.txt' | '/mcp' | '/skills'
   fileRoutesById: FileRoutesById
 }
 export interface RootRouteChildren {
   IndexRoute: typeof IndexRoute
   SplatRoute: typeof SplatRoute
   LlmsDottxtRoute: typeof LlmsDottxtRoute
   McpRoute: typeof McpRoute
+  SkillsRoute: typeof SkillsRoute
 }
 
 declare module '@tanstack/react-router' {
   interface FileRoutesByPath {
+    '/skills': {
+      id: '/skills'
+      path: '/skills'
+      fullPath: '/skills'
+      preLoaderRoute: typeof SkillsRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/mcp': {
       id: '/mcp'
       path: '/mcp'
@@ -107,6 +124,7 @@ const rootRouteChildren: RootRouteChildren = {
   SplatRoute: SplatRoute,
   LlmsDottxtRoute: LlmsDottxtRoute,
   McpRoute: McpRoute,
+  SkillsRoute: SkillsRoute,
 }
 export const routeTree = rootRouteImport
   ._addFileChildren(rootRouteChildren)

src/routes/__root.tsx

@@ -49,23 +49,40 @@ function RootComponent() {
             {theme}
           </button>
         )}
+        {prNumber(__HOST__) && (
+          <a
+            className="hover:text-gray10"
+            href={`https://github.com/wevm/curl.md/pull/${prNumber(__HOST__)}`}
+            rel="noopener noreferrer"
+            target="_blank"
+          >
+            #{prNumber(__HOST__)}
+          </a>
+        )}
         <a
           className="hover:text-gray10"
-          href={
-            __GIT_SHA__ === 'dev'
-              ? 'https://github.com/wevm/curl.md'
-              : `https://github.com/wevm/curl.md/commit/${__GIT_SHA__}`
-          }
+          href={commitHref(__GIT_SHA__)}
           rel="noopener noreferrer"
           target="_blank"
         >
-          {__GIT_SHA__}
+          {__GIT_SHA__.slice(0, 7)}
         </a>
       </div>
     </>
   )
 }
 
+function commitHref(sha: string) {
+  if (sha === 'dev') return 'https://github.com/wevm/curl.md'
+  const pr = prNumber(__HOST__)
+  if (pr) return `https://github.com/wevm/curl.md/pull/${pr}/commits/${sha}`
+  return `https://github.com/wevm/curl.md/commit/${sha}`
+}
+
+function prNumber(host: string) {
+  return host.match(/^pr(\d+)\./)?.[1]
+}
+
 function RootDocument(props: React.PropsWithChildren) {
   const { children } = props
   return (

src/routes/index.tsx

@@ -20,10 +20,8 @@ function Home() {
   return (
     <>
       <header className="mb-10">
-        <h1 className="text-base">
-          <span className="font-bold">curl.md</span>
-          <span className="ms-2 text-gray6">Fetch any URL as markdown</span>
-        </h1>
+        <h1 className="text-base font-bold">curl.md</h1>
+        <p className="mt-1 text-base text-gray6">Fetch any URL as markdown</p>
       </header>
 
       <h2 className="text-sm text-gray10">
@@ -38,14 +36,14 @@ function Home() {
         </CopyableCommand>
         <span className="block mt-3 text-gray8"># Focus output with query</span>
         <CopyableCommand
-          command={`curl ${__HOST__}/react.dev?q=fullstack+support`}
+          command={`curl ${__HOST__}/react.dev?q=fullstack+framework+support`}
         >
           curl {__HOST__}
           <span className="text-blue9">/react.dev</span>
           <span className="text-purple9">
             ?q=
             <wbr />
-            fullstack+support
+            fullstack+framework+support
           </span>
         </CopyableCommand>
       </pre>
@@ -77,10 +75,10 @@ function Home() {
 }
 
 const examples = [
-  ['react.dev', 'fullstack support'],
-  ['developer.mozilla.org/en-US/docs/Web/API/Fetch_API'],
-  ['en.wikipedia.org/wiki/Linux', 'kernel history'],
-  ['docs.github.com/en/rest', 'rate limiting'],
+  ['react.dev', 'fullstack framework support'],
+  ['developer.mozilla.org/docs/Web/API/Fetch_API', 'Response'],
+  ['wikipedia.org/wiki/Linux', 'kernel history'],
+  ['docs.github.com/en/actions', 'workflow syntax'],
 ] as const
 
 function Playground() {
@@ -189,9 +187,12 @@ function Playground() {
         <div className="bg-bg2">
           <div className="flex items-center gap-2 px-3 py-2 text-xs text-gray8">
             <span>{pending ? pendingDisplayUrl : result?.fetchedUrl}</span>
-            {result && (
+            {result && (!pending || refreshingRef.current) && (
               <button
-                className={`hover:text-gray11 ${pending && refreshingRef.current ? 'animate-spin' : ''}`}
+                className="hover:text-gray11 data-[spinning]:animate-spin"
+                data-spinning={
+                  pending && refreshingRef.current ? '' : undefined
+                }
                 disabled={pending}
                 onClick={() => {
                   freshRef.current = true
@@ -221,7 +222,7 @@ function Playground() {
         <div className="mt-2 grid grid-cols-1 gap-1.5 text-xs sm:grid-cols-2">
           {examples.map(([url, q]) => (
             <button
-              className="bg-bg2 px-3 py-2 text-start opacity-50 grayscale hover:opacity-100 hover:grayscale-0 focus:opacity-100 focus:grayscale-0"
+              className="bg-bg2 px-3 py-2 text-start opacity-75 grayscale hover:opacity-100 hover:grayscale-0 focus:opacity-100 focus:grayscale-0 sm:opacity-50"
               key={`${url}${q ?? ''}`}
               onClick={() => {
                 flushSync(() => {
@@ -234,20 +235,19 @@ function Playground() {
             >
               <span className="block truncate text-gray10">
                 {url.split('/')[0]}
-                {q && url.includes('/') && (
-                  <span className="text-blue9">
-                    /{url.split('/').slice(1).join('/')}
-                  </span>
-                )}
               </span>
-              {!q && url.includes('/') && (
-                <span className="block truncate text-blue9">
-                  /{url.split('/').slice(1).join('/')}
-                </span>
-              )}
-              {q && (
-                <span className="block truncate text-purple9">
-                  ?q={q.replace(/ /g, '+')}
+              {(url.includes('/') || q) && (
+                <span className="block truncate">
+                  {url.includes('/') && (
+                    <span className="text-blue9">
+                      /{url.split('/').slice(1).join('/')}
+                    </span>
+                  )}
+                  {q && (
+                    <span className="text-purple9">
+                      ?q={q.replace(/ /g, '+')}
+                    </span>
+                  )}
                 </span>
               )}
             </button>

src/routes/skills.ts

@@ -0,0 +1,14 @@
+import { createFileRoute } from '@tanstack/react-router'
+
+export const Route = createFileRoute('/skills')({
+  server: {
+    handlers: {
+      GET: async (options) => {
+        return Response.redirect(
+          new URL('/skills/index.json', options.request.url).href,
+          301,
+        )
+      },
+    },
+  },
+})

src/worker-configuration.d.ts

@@ -1,9 +1,10 @@
 /* eslint-disable */
-// Generated by Wrangler by running `wrangler types src/worker-configuration.d.ts` (hash: d073ec20d62ef5917bc18501cc3fe4b4)
+// Generated by Wrangler by running `wrangler types src/worker-configuration.d.ts` (hash: d1210e4b995e995fd23441c43fe4c292)
 // Runtime types generated with workerd@1.20260212.0 2026-02-12 nodejs_compat
 declare namespace Cloudflare {
 	interface ProductionEnv {
 		KV: KVNamespace;
+		DB: D1Database;
 		AI: Ai;
 		HOST: "curl.md";
 		CLOUDFLARE_ACCOUNT_ID: string;
@@ -12,6 +13,7 @@ declare namespace Cloudflare {
 	}
 	interface PreviewEnv {
 		KV: KVNamespace;
+		DB: D1Database;
 		AI: Ai;
 		HOST: "__PREVIEW_APEX__.curl.md";
 		CLOUDFLARE_ACCOUNT_ID: string;
@@ -23,9 +25,9 @@ declare namespace Cloudflare {
 		CLOUDFLARE_API_TOKEN: string;
 		WRANGLER_SEND_METRICS: string;
 		KV: KVNamespace;
+		DB: D1Database;
 		AI: Ai;
 		HOST: "curl.md" | "__PREVIEW_APEX__.curl.md" | "curl.local";
-		DB?: D1Database;
 	}
 }
 interface Env extends Cloudflare.Env {}