TanStack Start — apuntes de setup
Notas cortas después de montar este sitio con TanStack Start, MDX y Tailwind v4. Lo que funcionó, lo que costó, lo que dejé anotado para no repetir.
Enrutado por archivos
El router lee src/routes/. Un index.tsx en un directorio corresponde
al índice de esa ruta; $slug.tsx captura parámetros dinámicos con
$, no con corchetes al estilo Next.
MDX con frontmatter
@mdx-js/rollup no parsea frontmatter por defecto. Hay que enchufar
remark-frontmatter para reconocer el bloque YAML y
remark-mdx-frontmatter para exponerlo como export nombrado. Luego
import.meta.glob(..., { eager: true }) da acceso al componente y a
los metadatos en un solo objeto.
Fuentes
Cargar Google Fonts con <link rel="preconnect"> antes del
stylesheet. Sin eso, el primer paint parpadea con la fallback y el
tracking wide de los títulos se ve mal.
Lo que no probé
- SSR streaming con datos remotos.
- Deploy a Cloudflare Workers vía nitro.
- Cache de rutas con
defaultPreloadStaleTimedistinto de cero.