---
title: Guida onboarding
description: "Completa l'onboarding guidato: crea un progetto, collega GitHub, configura docs.json e avvia la prima build del sito."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

## I 5 passaggi

<Steps>
  <Step title="Avvia prova">
    Al primo accesso, Jamdesk avvia automaticamente la tua **prova gratuita di 14 giorni** del piano Pro.

    - Accesso completo a tutte le funzionalità
    - La prova termina 14 giorni dopo l'attivazione
  </Step>

  <Step title="Crea progetto">
    Assegna un nome al progetto di documentazione:

    - Usa un nome chiaro e descrittivo (ad es. "Documentazione API", "Guida utente")
    - Il nome diventa parte dell'URL del sito di documentazione
    - Puoi modificare in seguito il nome visualizzato nelle impostazioni del progetto
  </Step>

  <Step title="Collega GitHub e crea i documenti iniziali">
    Jamdesk crea un nuovo repository GitHub dal [Starter Template](https://github.com/jamdesk/starter-docs):

    - Pagine di esempio con contenuti e componenti realistici
    - `docs.json` preconfigurato con navigazione e branding
    - Esempio di specifica OpenAPI per la documentazione di riferimento API
    - Pronto per essere modificato e inviato immediatamente
  </Step>

  <Step title="Installa CLI">
    La CLI di Jamdesk abilita lo sviluppo locale:

    ```bash
    npm install -g jamdesk
    ```

    <Note>
    Puoi saltare questo passaggio durante l'onboarding e installare la CLI in qualsiasi momento. Se lo salti, puoi comunque modificare la documentazione direttamente su GitHub.
    </Note>
  </Step>

  <Step title="Inizia a modificare">
    Ora puoi creare! Modifica la documentazione:

    - **Tramite CLI**: modifica i file localmente con `jamdesk dev`
    - **Tramite GitHub**: modifica direttamente i file `.mdx` nel repository
    - **Su Jamdesk**: alcune funzionalità del dashboard sono disponibili (a seconda del piano)

    Quando esegui il push su GitHub, le modifiche avviano automaticamente nuove build della documentazione.
  </Step>
</Steps>

## Dopo l'onboarding

Dopo aver completato l'onboarding, puoi:
- [Creare altri progetti](/it/help/projects/creating)
- [Invitare membri del team](/it/help/projects/team-members)
- [Visualizzare le analisi](/it/setup/analytics-overview)
- [Configurare domini personalizzati](/it/deploy/custom-domains)

## Risoluzione dei problemi

### Ho saltato un passaggio: posso tornare indietro?
Puoi completare l'onboarding in qualsiasi momento dal dashboard del progetto. Cerca la scheda dell'onboarding per riprendere dal punto in cui ti sei fermato.

### Ho scelto il repository GitHub sbagliato
Crea un nuovo progetto con il repository corretto. Puoi eliminare quello precedente in qualsiasi momento.

### Ho bisogno di aiuto durante l'onboarding
Contatta il [supporto](/it/help/support/contact) in qualsiasi momento durante la procedura.

## Articoli correlati

<Columns cols={2}>
  <Card title="Prima build" icon="hammer" href="/it/help/getting-started/first-build">
    Avvia e verifica la prima build
  </Card>
  <Card title="Tour del dashboard" icon="compass" href="/it/help/getting-started/dashboard-tour">
    Scopri il dashboard di Jamdesk
  </Card>
</Columns>