Skip to content

Repository files navigation

xscriptor.com

Sitio web de Xscriptor: una plataforma literaria y criptográfica. El proyecto es una aplicación web estática multilingüe construida con Next.js (App Router), exportada a HTML puro y con un fuerte componente artístico en cada página.

Stack

  • Next.js 16 (App Router) con output: "export" (sitio 100% estático).
  • React 19 + TypeScript.
  • Tailwind CSS 4 con temas claro/oscuro vía variables CSS.
  • i18n: español, inglés, alemán, italiano y francés.
  • Remark / Rehype: contenido en Markdown y MDX (GFM, matemáticas KaTeX, resaltado de sintaxis).
  • Framer Motion para transiciones y animaciones.
  • Lenis para el scroll suave.
  • Componentes propios en src/app/components/xcomponents (copia local del paquete @xscriptor/xcomponents).

Requisitos

  • Node.js 18 o superior.
  • npm.

Comandos

npm install        # Instala las dependencias
npm run dev        # Servidor de desarrollo (http://localhost:3000)
npm run build      # Build de producción + sitemap (postbuild)
npm run start      # Sirve el build de producción
npm run lint       # ESLint (prueba la configuración de Next.js)

Nota: el comando lint puede no funcionar en todas las versiones de Next.js 16; el proyecto valida con tsc --noEmit.

Estructura

  • src/app/ — código de la aplicación (rutas, componentes, estilos, contenido).
  • messages/ — traducciones de la interfaz por idioma.
  • public/ — assets públicos (imágenes, fuentes, firma SVG).
  • docs/ — documentación del proyecto.

Documentación detallada de la estructura: docs/STRUCTURE.md.

Multilingüe

Cada página existe por idioma bajo la ruta /[locale] (es, en, de, it, fr). El contenido de los libros se guarda como MDX por idioma en src/app/content/ y los artículos del blog en src/app/content/articulos/<locale>/.

Tema claro y oscuro

El tema se aplica sobre <html> mediante data-theme y se persiste en localStorage. Un script en el head lo aplica antes del renderizado para evitar parpadeos. Ver docs/STRUCTURE.md para más detalle.

Notas sobre xcomponents

src/app/components/xcomponents/ es una copia local del paquete @xscriptor/xcomponents. Los parches aplicados sobre esa copia están documentados en docs/xcomponents-fixes.md para poder re-aplicarlos al actualizar el paquete.

Contribuir

Consulta CONTRIBUTING.md para las pautas de contribución.

Contacto

Consulta CONTACT.md para los canales de contacto.

Licencia

Ver LICENSE.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages