Concetti
Il @aws/nx-plugin è un plugin Nx che fornisce un toolkit per costruire e distribuire applicazioni full-stack su AWS. Ti offre una collezione di Generatori che creano codice applicativo pronto per la produzione e l’infrastruttura per distribuirlo — type-safe, eseguibile localmente e pronto per il rilascio.
Invece di partire da una pagina vuota, tu (o il tuo agente AI) scegli i componenti di cui hai bisogno — API, siti web, autenticazione, agenti AI, infrastruttura — fornisci alcune opzioni di configurazione, e il plugin genera codice iniziale basato sulle best practice. Collega persino i progetti tra loro (incluso l’aggiornamento di file esistenti tramite trasformazioni AST) per produrre client type-safe tra frontend e backend.
Basato su Nx e i suoi generatori
Sezione intitolata “Basato su Nx e i suoi generatori”Nx è un framework di build intelligente per la gestione di monorepos. È agnostico rispetto al linguaggio, permettendo a TypeScript, Python, infrastruttura e altro di coesistere e compilare insieme in un unico workspace. Il suo sistema di build utilizza caching e analisi del grafo delle dipendenze per ricostruire solo ciò che è cambiato ed eseguire task in parallelo, mantenendo test, linting e build veloci man mano che il workspace cresce.
Ogni funzionalità del @aws/nx-plugin è fornita come Generatore Nx — scaffolding automatizzato che produce strutture di codice coerenti da template predefiniti. I generatori possono essere invocati tramite Nx CLI, il plugin IDE Nx Console, o dal tuo assistente AI attraverso il Nx Plugin for AWS MCP Server.
Poiché ogni componente è un generatore, aggiungi solo ciò di cui hai bisogno, quando ne hai bisogno. Inizia con un’API, aggiungi un sito web più tardi, collegali quando sei pronto — ogni passo è un singolo comando.
Costruisci con framework collaudati
Sezione intitolata “Costruisci con framework collaudati”Il @aws/nx-plugin evita deliberatamente di costruire astrazioni personalizzate sopra gli strumenti che già conosci. Invece di inventare framework, runtime o wrapper su misura, genera codice idiomatico utilizzando progetti open-source consolidati e ampiamente adottati. Questo significa che le tue competenze esistenti si trasferiscono direttamente, puoi fare affidamento sulla documentazione ufficiale di ogni framework, e non sei mai vincolato a un livello che solo questo plugin comprende.
Il codice generato si basa su framework di altissima qualità, tra cui:
Il valore del plugin sta nel modo in cui questi pezzi sono configurati e collegati insieme per AWS — non nel sostituirli.
Modificabile liberamente
Sezione intitolata “Modificabile liberamente”Tutto il codice generato è il tuo codice. Il @aws/nx-plugin è uno strumento di build-time, non una dipendenza runtime — una volta che un generatore è stato eseguito, il plugin non è più in gioco. Puoi leggere ogni file che ha prodotto, committarlo e modificarlo come preferisci.
Questo significa:
- Nessuna via di fuga. Non c’è una superficie di configurazione proprietaria da imparare o con cui lottare quando devi fare qualcosa che il generatore non ha previsto. Modifichi il codice generato direttamente, nello stesso modo in cui modificheresti qualsiasi codice che hai scritto tu stesso.
- Nessun nuovo livello di astrazione. I generatori emettono codice semplice e idiomatico per i framework sottostanti. Non c’è un’API wrapper o indirezione magica tra te e React, tRPC, FastAPI, CDK o qualsiasi altro strumento — ciò che vedi è ciò che viene eseguito.
- Il plugin non è una dipendenza. Genera codice e si fa da parte. La tua applicazione non importa né dipende da
@aws/nx-plugina runtime, quindi non sei mai bloccato da esso e mai vincolato.
Se non ti piace qualcosa nel codice generato, sei libero di modificarlo. I generatori ti danno un vantaggio iniziale, non una gabbia.
Dipendenze minime
Sezione intitolata “Dipendenze minime”Il @aws/nx-plugin si impegna a mantenere il numero di dipendenze globali al minimo. Ciò di cui hai bisogno per iniziare si riduce a quali generatori invochi.
Ad esempio, qualsiasi generatore basato su TypeScript richiederà solo l’installazione di Node. Per progetti basati su Python, UV è l’unico requisito.
Type safety
Sezione intitolata “Type safety”Il @aws/nx-plugin impiega la type-safety per semplificare l’esperienza degli sviluppatori tramite completamenti IDE, eliminando al contempo errori runtime che altrimenti emergerebbero solo in un’implementazione non type-safe. Di conseguenza, tutti i componenti forniti sono type-safe per impostazione predefinita.
La type safety fluisce attraverso i confini dei progetti: quando colleghi un sito web a un’API, il client generato condivide i tipi con il backend, quindi una modifica a un contratto API emerge come errore in fase di compilazione nel frontend piuttosto che come bug in produzione. Refactorizza con fiducia.