Estructura del monorepo
El repositorio principal de xtask agrupa los paquetes del runtime y las aplicaciones de ejemplo en un mismo workspace para que APIs, adaptadores, decoradores e integraciones evolucionen juntos.
Documentación
Un solo lugar para la arquitectura, los paquetes, los decoradores, las integraciones y los ejemplos de xtaskjs.
Empieza por la visión general y después pasa a las páginas dedicadas a arquitectura del runtime, referencia de paquetes, referencia de decoradores y las aplicaciones de ejemplo oficiales publicadas en el monorepo xtask.
21 paquetes documentados + 114 decoradores + 25 ejemplos de referencia
Ecosystem repositories
The xtaskjs domain currently coordinates four public repositories: xtask (runtime + samples), xtask-cli (console tooling), typescript-starter (project template), and xtaskjs.io (documentation website).
Diseño guiado por decoradores
Los controladores, hooks del ciclo de vida, guards, reglas de seguridad, enlaces de persistencia y entrega de correo se expresan mediante decoradores y se resuelven en tiempo de ejecución a través del kernel y el contenedor.
Portabilidad entre adaptadores e integraciones
La lógica de negocio se mantiene estable mientras node-http, Express, Fastify, TypeORM, security y mailer cambian cómo se entrega y amplía la aplicación.
Inicio rápido
Arranca la aplicación xtask más pequeña útil
Instalación
npm install @xtaskjs/core @xtaskjs/common reflect-metadataArranque
import "reflect-metadata";
import { CreateApplication } from "@xtaskjs/core";
await CreateApplication({
adapter: "node-http",
autoListen: true,
server: { host: "127.0.0.1", port: 3000 },
});Flujo CLI
De scaffold a operaciones con xtask-cli
Usa esta secuencia para crear un proyecto, generar artefactos, instalar módulos runtime e inspeccionar caché desde el CLI.
Scaffold
1. Crear proyecto
Genera una app nueva desde el starter oficial con tu package manager preferido.
xtask create my-api --package-manager pnpmCodegen
2. Generar feature
Crea un recurso CRUD con soporte DTO para partir de una base orientada a producción.
xtask generate resource users --path src/modules --crud --with-dtoModules
3. Añadir módulos
Instala módulos runtime oficiales, incluyendo seguridad, caché, MCP y soporte de bots.
xtask add security cache mcp botsOps
4. Inspeccionar caché
Consulta la política efectiva de caché HTTP de una ruta en la aplicación en ejecución.
xtask cache http-route --method GET --path /usersSecciones
Recorre la documentación por tema
Documentación
Arquitectura
Ciclo de arranque, canalización de peticiones y diagramas del flujo de seguridad.
Abrir ArquitecturaDocumentación
Paquetes
Detailed reference for core, common, config, validation, testing, adapters, TypeORM, security, mailer, internationalization, scheduler, cache, queues, value objects, socket-io, throttler, and bots.
Abrir PaquetesDocumentación
CLI
Instalación del cliente de consola, referencia de comandos y flujo de generación.
Abrir CLIDocumentación
Decoradores
Catálogo de decoradores organizado por tipo y paquete, con ejemplos.
Abrir DecoradoresDocumentación
Ejemplos
Aplicaciones de ejemplo oficiales y cómo utilizarlas.
Abrir Ejemplos
Puntos clave
En qué se centra esta documentación
Puntos clave
En qué se centra esta documentación
Estructura del monorepo
El repositorio principal de xtask agrupa los paquetes del runtime y las aplicaciones de ejemplo en un mismo workspace para que APIs, adaptadores, decoradores e integraciones evolucionen juntos.
Ecosystem repositories
The xtaskjs domain currently coordinates four public repositories: xtask (runtime + samples), xtask-cli (console tooling), typescript-starter (project template), and xtaskjs.io (documentation website).
Diseño guiado por decoradores
Los controladores, hooks del ciclo de vida, guards, reglas de seguridad, enlaces de persistencia y entrega de correo se expresan mediante decoradores y se resuelven en tiempo de ejecución a través del kernel y el contenedor.
Portabilidad entre adaptadores e integraciones
La lógica de negocio se mantiene estable mientras node-http, Express, Fastify, TypeORM, security y mailer cambian cómo se entrega y amplía la aplicación.