Skip to main content

Installazione

Questa guida spiega come installare @itlogix/chatbot-itlogix all'interno di un progetto frontend. Il pacchetto è distribuito tramite un registry npm privato GitLab, quindi è necessaria una configurazione iniziale.

1. Configurazione del file .npmrc​

Prima di procedere con l'installazione, crea (o modifica) un file .npmrc nella root del progetto e inserisci il seguente contenuto:

@itlogix:registry=https://repository.itlogix.it/api/v4/groups/78/-/packages/npm/
//repository.itlogix.it/api/v4/groups/78/-/packages/npm/:_authToken=TOKEN_DA_INSERIRE
always-auth=true

🔐 Token di autenticazione​

  • Sostituisci TOKEN_DA_INSERIRE con un Personal Access Token GitLab
  • Il token deve avere almeno i permessi read_package_registry

⚠️ Attenzione: non versionare il file .npmrc se contiene token sensibili.

2. Installazione del pacchetto​

Una volta configurato correttamente il file .npmrc, esegui il comando:

npm install @itlogix/chatbot-itlogix

Il chatbot verrà aggiunto alle dipendenze del progetto.

3. Dipendenze installate automaticamente​

Durante l'installazione, il pacchetto include automaticamente le seguenti dipendenze:

{
  "lodash.merge": "^4.6.2",
  "rehype-raw": "^7.0.0",
  "socket.io": "^4.8.1",
  "socket.io-client": "^4.8.1"
}

Queste librerie sono necessarie per il corretto funzionamento interno del chatbot.

4. Peer Dependencies richieste​

Il progetto che utilizza il chatbot deve già includere le seguenti librerie:

{
  "@fortawesome/free-solid-svg-icons": ">= 6.0.0",
  "@fortawesome/react-fontawesome": ">= 0.2.0",
  "@mui/material": ">=6.0.0 <8.0.0",
  "autoprefixer": ">=10.4.0",
  "postcss": ">=8.4.0",
  "react": ">=18.0.0 <20.0.0",
  "react-dom": ">=18.0.0 <20.0.0",
  "react-markdown": "^10.1.0",
  "tailwindcss": ">=4.0.0"
}

ℹ️ Nota​

Se una o più peer dependency non sono presenti o non rispettano le versioni richieste, npm mostrerà un warning (o un errore, a seconda della configurazione).

5. Verifica finale​

Al termine dell'installazione:

  • verifica che @itlogix/chatbot-itlogix compaia nel package.json
  • assicurati che il progetto utilizzi React 18+, MUI e Tailwind CSS correttamente configurati

A questo punto il chatbot è pronto per essere utilizzato 🚀