Stack y organización
El sitio utiliza Next.js con App Router, React, TypeScript y Bootstrap 5, complementado con una hoja de estilos propia de BI3LYX. Las páginas editoriales se generan a partir de datos tipados en el repositorio.
- app/
- Rutas, diseños, metadatos, sitemap, feed RSS y ruta de estado.
- components/
- Componentes de interfaz reutilizables, incluida la navegación, las tarjetas y el explorador.
- lib/
- Datos editoriales tipados, configuración del sitio y modelos de la futura API.
- tests/
- Pruebas de contenido, navegación, componentes y renderizado de páginas.
Comandos locales
- npm install — instalar las dependencias.
- npm run dev — iniciar el servidor de desarrollo.
- npm run typecheck — verificar TypeScript sin generar archivos.
- npm run lint — analizar el código con ESLint.
- npm test — ejecutar la suite de pruebas.
- npm run build — generar la compilación de producción.
- npm start — iniciar la compilación de Next.js.
Publicar contenido
Las páginas de documentación y las noticias se describen mediante bloques tipados. Cada nueva publicación debe proporcionar un slug único, un título, una descripción, una fecha y un cuerpo redactado sin datos no confirmados.
- Verificar los enlaces internos y los metadatos.
- Indicar claramente la información en preparación.
- Nunca publicar estadísticas inventadas ni capturas simuladas.
- Hacer revisar las afirmaciones técnicas antes de la publicación.
Reglas de integración de la API
- Mantener una capa de acceso de servidor distinta de los componentes de visualización.
- Configurar la URL de la API únicamente mediante variable de entorno.
- Prever un tiempo de espera y un estado de error explícito.
- Validar los esquemas de respuesta antes de mostrarlos.
- Nunca exponer una URL RPC, un secreto o un dato del wallet.
Contribución y validación
- Ninguna modificación directa de la infraestructura de producción desde el repositorio del sitio.
- Cualquier evolución debe superar el tipado, el lint, las pruebas y la compilación.
- Los commits y despliegues requieren la autorización del responsable del proyecto.
- Los binarios nunca se publican desde el sitio sin verificación y firma.