Conceptos
El @aws/nx-plugin es un plugin de Nx que proporciona un conjunto de herramientas para construir e implementar aplicaciones full-stack en AWS. Te ofrece una colección de Generadores que generan código de aplicación listo para producción y la infraestructura para desplegarlo — type-safe, ejecutable localmente y listo para enviar.
En lugar de comenzar desde una página en blanco, tú (o tu agente de IA) eliges los componentes que necesitas — APIs, sitios web, autenticación, agentes de IA, infraestructura — proporcionas algunas opciones de configuración, y el plugin genera código inicial siguiendo las mejores prácticas. Incluso conecta proyectos entre sí (incluyendo la actualización de archivos existentes mediante transformaciones AST) para producir clientes type-safe entre tu frontend y backend.
Construido sobre Nx y sus generadores
Sección titulada «Construido sobre Nx y sus generadores»Nx es un framework de construcción inteligente para gestionar monorepos. Es agnóstico del lenguaje, permitiendo que TypeScript, Python, infraestructura y más convivan y se construyan juntos en un único workspace. Su sistema de construcción utiliza caché y análisis de gráficos de dependencias para reconstruir solo lo que cambió y ejecutar tareas en paralelo, manteniendo el testing, linting y construcción rápidos a medida que tu workspace crece.
Cada pieza de funcionalidad en el @aws/nx-plugin se entrega como un Generador de Nx — scaffolding automatizado que produce estructuras de código consistentes a partir de plantillas predefinidas. Los generadores pueden invocarse mediante la CLI de Nx, el plugin IDE Nx Console, o por tu asistente de IA a través del Nx Plugin for AWS MCP Server.
Debido a que cada componente es un generador, solo agregas lo que necesitas, cuando lo necesitas. Comienza con una API, agrega un sitio web más tarde, conéctalos cuando estés listo — cada paso es un solo comando.
Construye con frameworks probados
Sección titulada «Construye con frameworks probados»El @aws/nx-plugin deliberadamente evita construir abstracciones personalizadas sobre las herramientas que ya conoces. En lugar de inventar frameworks, runtimes o wrappers a medida, genera código idiomático usando proyectos de código abierto establecidos y ampliamente adoptados. Esto significa que tus habilidades existentes se transfieren directamente, puedes confiar en la documentación oficial de cada framework, y nunca quedas atrapado en una capa que solo este plugin entiende.
El código generado se apoya en frameworks de primera clase, incluyendo:
El valor del plugin está en cómo estas piezas se configuran y conectan juntas para AWS — no en reemplazarlas.
Abierto a modificaciones
Sección titulada «Abierto a modificaciones»Todo el código generado es tu código. El @aws/nx-plugin es una herramienta de tiempo de construcción, no una dependencia de runtime — una vez que un generador ha ejecutado, el plugin ya no está en escena. Puedes leer cada archivo que produjo, hacer commit, y cambiarlo como quieras.
Esto significa:
- Sin escotillas de escape. No hay una superficie de configuración propietaria que aprender o con la que luchar cuando necesitas hacer algo que el generador no anticipó. Editas el código generado directamente, de la misma manera que editarías cualquier código que escribiste tú mismo.
- Sin nuevas capas de abstracción. Los generadores emiten código plano e idiomático para los frameworks subyacentes. No hay una API wrapper o indirección mágica entre tú y React, tRPC, FastAPI, CDK o cualquiera de las otras herramientas — lo que ves es lo que se ejecuta.
- El plugin no es una dependencia. Genera código y se aparta del camino. Tu aplicación no importa ni depende de
@aws/nx-pluginen runtime, por lo que nunca estás bloqueado por él y nunca estás atrapado.
Si no te gusta algo en el código generado, eres libre de modificarlo. Los generadores te dan una ventaja inicial, no una jaula.
Al día con las mejoras
Sección titulada «Al día con las mejoras»Ser propietario de tu código generalmente tiene un costo: en el momento en que comienzas a editar un scaffold, quedas desconectado de las correcciones y mejoras realizadas upstream. Adoptarlas nuevamente significa leer un changelog, regenerar y reconciliar un diff manualmente. Las Migraciones son la forma en que el @aws/nx-plugin trabaja para evitar que eso suceda.
Los lanzamientos incluyen migraciones junto con ellos, con el objetivo de llevar el código que los generadores anteriores produjeron al nivel de las mejoras que hemos realizado desde entonces. Cuando corregimos un error, reforzamos un valor predeterminado de seguridad o refinamos un patrón generado, ejecutar nx migrate aplica ese cambio a tu código, en el lugar — en lugar de dejarte detectarlo en un changelog y portarlo tú mismo.
En la práctica:
- La actualización es automatizada, no un ejercicio de re-adopción. Un workspace generado hace meses puede avanzar con el plugin en lugar de alejarse más de él.
- Las personalizaciones se comparan por patrones, no se sobrescriben. Las migraciones verifican que un archivo aún coincida con la forma que el generador produjo. Donde ha divergido más allá de lo que pueden actualizar de manera segura, dejan tu código solo y reportan el seguimiento manual en su lugar.
- Algunos cambios llegan como prompts de agente. Donde la edición correcta depende de lo que has construido, la migración es un prompt que tu agente de codificación de IA aplica en lugar de un codemod.
- Las actualizaciones son opcionales. Nada en tu workspace cambia hasta que eliges ejecutar
nx migrate.
Las migraciones reducen la brecha en lugar de cerrarla: qué tan lejos se ha movido tu código decide cuánto pueden hacer, y algunos pasos aún necesitarán tus manos.
Dependencias mínimas
Sección titulada «Dependencias mínimas»El @aws/nx-plugin se esfuerza por mantener el número de dependencias globales al mínimo. Lo que necesitas para comenzar se reduce a qué generadores invocas.
Por ejemplo, cualquier generador basado en TypeScript solo requerirá tener instalado Node. Para proyectos basados en Python, UV es el único requisito.
Seguridad de tipos
Sección titulada «Seguridad de tipos»El @aws/nx-plugin emplea type-safety para simplificar la experiencia del desarrollador mediante autocompletado en el IDE, al mismo tiempo que elimina errores de runtime que de otro modo solo aparecerían en una implementación no type-safe. Como tal, todos los componentes que se proporcionan son type-safe por defecto.
La seguridad de tipos fluye a través de los límites del proyecto: cuando conectas un sitio web a una API, el cliente generado comparte tipos con el backend, por lo que un cambio en un contrato de API aparece como un error de tiempo de compilación en tu frontend en lugar de un bug en producción. Refactoriza con confianza.