Creare una Nuova App React

Utilizza una toolchain integrata per avere la migliore esperienza utente e di sviluppo.

Questa pagina descrive alcune toolchains popolari di React che ti aiuteranno per compiti come:

  • Scalare su molti file e componenti.
  • Utilizzare librerie di terze parti importate da npm.
  • Individuare subito errori comuni.
  • Visualizzare in tempo reale l’effetto delle modifiche al codice JavaScript e CSS durante lo sviluppo.
  • Ottimizzare l’output per la produzione.

Le toolchains raccomandate in questa pagina non hanno bisogno di una configurazione per essere utilizzate.

Potresti Non Avere Bisogno di una Toolchain

Se non hai a che fare con i problemi descritti sopra o non ti senti a tuo agio ad utilizzare questi strumenti JavaScript, considera se aggiungere React come un semplice tag <script> a una pagina HTML, opzionalmente utilizzando JSX.

Questo è anche il modo più semplice di integrare React in un sito esistente. Puoi sempre aggiungere una toolchain più estesa in seguito se trovi che sia utile!

Il team di React raccomanda prima di tutto queste soluzioni:

  • Se stai imparando React o creando una nuova applicazione single-page, utilizza Create React App.
  • Se stai realizzando un sito renderizzato lato server con Node.js, prova Next.js.
  • Se stai realizzando un sito orientato al contenuto statico, prova Gatsby.
  • Se stai realizzando una libreria di componenti o integrando una base di codice preesistente, prova con le Toolchains Più Flessibili.

Create React App

Create React App è un ambiente confortevole per imparare React, ed è il modo migliore per iniziare a costruire una nuova applicazione single-page in React.

Si occupa di configurare il tuo ambiente di sviluppo in modo da poter utilizzare le caratteristiche più recenti di JavaScript, fornisce un’ottima esperienza di sviluppo e ottimizza la tua applicazione per la produzione. Avrai bisogno di avere installato Node >= 6 e npm >= 5.2 nella tua macchina. Per creare un progetto, esegui:

npx create-react-app mia-app
cd mia-app
npm start

Nota

npx nella prima riga non è un errore di battitura — è un esecutore di pacchetti incluso in npm 5.2+.

Create React App non gestisce la logica di backend o i database; crea soltanto una catena di build per il frontend, quindi puoi utilizzarlo con qualsiasi backend. Al suo interno utilizza Babel e webpack, ma non hai bisogno di sapere nulla a tal riguardo.

Quando sei pronto a rilasciare in produzione, esegui il comando npm run build e verrà creata una build ottimizzata della tua applicazione nella cartella build. Puoi sapere di più su Create React App leggendo il README e la Guida per gli Utenti.

Next.js

Next.js è un framework popolare e leggero per le applicazioni statiche e renderizzate lato server realizzate con React. Include di serie soluzioni per il routing e l’applicazione degli stili, e assume che tu stia utilizzando Node.js come ambiente server.

Impara ad utilizzare Next.js seguendo la sua guida ufficiale.

Gatsby

Gatsby è il miglior modo di creare siti statici con React. Ti consente di utilizzare componenti React, ma il suo output è costituito interamente da codice HTML e CSS pre-renderizzato, in modo da garantire tempi di caricamento i più rapidi possibile.

Impara ad utilizzare Gatsby dalla sua guida ufficiale e da questa galleria di kit di partenza.

Toolchains Più Flessibili

Le toolchains seguenti offrono più scelta e flessibilità. Le raccomandiamo per gli utenti più esperti:

Creare una Toolchain da Zero

Una toolchain JavaScript di build tipicamente comprende i seguenti strumenti:

  • Un gestore di pacchetti, come Yarn o npm. Ti consente di trarre vantaggio da un vasto ecosistema di pacchetti di terze parti, occupandosi della loro installazione e aggiornamento.

  • Un bundler, come webpack o Parcel. Ti consente di scrivere codice modulare e racchiuderlo in piccoli pacchetti per ottimizzare i tempi di caricamento.

  • Un compilatore come Babel. Ti consente di scrivere codice JavaScript moderno che funziona anche nei vecchi browser.

Se preferisci realizzare la tua toolchain JavaScript da zero, leggi questa guida in cui alcune delle funzionalità di Create React App vengono ricreate.

Non dimenticarti di controllare che la tua toolchain personalizzata sia impostata correttamente per la produzione.