---
title: Crea un progetto
description: Crea un progetto Jamdesk da un template o collega un repository GitHub esistente. Il sito sarà online su yourproject.jamdesk.app in pochi minuti.
---

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

Prima di scrivere la documentazione, ti serve un progetto. Puoi iniziare da un template (Jamdesk crea il repository GitHub per te) oppure collegare un repository esistente che contiene già un file `docs.json`. In entrambi i casi, il sito sarà online in pochi minuti.

## Crea un nuovo progetto

<Steps>
  <Step title="Accedi a Jamdesk">
    Vai su [dashboard.jamdesk.com](https://dashboard.jamdesk.com) e accedi con il tuo account GitHub.

    Gli utenti che accedono per la prima volta dovranno autorizzare l'app GitHub di Jamdesk.
  </Step>

  <Step title="Fai clic su New Project">
    Dal dashboard, fai clic su **New Project** nell'angolo in alto a destra.
  </Step>

  <Step title="Scegli un punto di partenza">
    <Tabs>
      <Tab title="From Template">
        Inizia con un template predefinito. Jamdesk crea per te un nuovo repository GitHub con contenuti di esempio, navigazione e componenti già configurati.

        Lo [Starter Template](https://github.com/jamdesk/starter-docs) predefinito include pagine di esempio, una specifica OpenAPI ed esempi di ogni componente. Sostituisci i contenuti con i tuoi e il gioco è fatto.
      </Tab>
      <Tab title="From Repository">
        Collega un repository GitHub esistente:

        1. Seleziona il repository dal menu a discesa
        2. Scegli il branch da deployare (di solito `main`)
        3. Specifica il percorso di `docs.json` se non si trova nella root
      </Tab>
    </Tabs>
  </Step>

  <Step title="Configura le impostazioni del progetto">
    Inserisci le informazioni di base del progetto:

    | Campo | Descrizione |
    |-------|-------------|
    | **Name** | Nome visualizzato nel dashboard |
    | **Slug** | Identificatore compatibile con gli URL (ad esempio, `my-docs`) |
    | **Domain** | Il tuo sottodominio `*.jamdesk.app` |
  </Step>
</Steps>

## Struttura minima del repository

Un progetto Jamdesk richiede solo un file `docs.json` e almeno una pagina:

```bash
my-docs/
├── docs.json
└── introduction.mdx
```

Esempio di `docs.json`:

```json docs.json
{
  "$schema": "https://jamdesk.com/docs.json",
  "name": "My Docs",
  "theme": "jam",
  "navigation": {
    "groups": [
      {
        "group": "Getting Started",
        "pages": ["introduction"]
      }
    ]
  }
}
```

## Impostazioni del progetto

Dopo la creazione, configura il progetto in **Settings**:

### Generali

- **Name** - Aggiorna il nome visualizzato
- **Slug** - Modifica l'identificatore del progetto
- **Delete Project** - Rimuove il progetto definitivamente

### Repository

- **Branch** - Il branch che attiva i deploy
- **Docs Path** - Posizione di `docs.json` per i monorepo

### Dominio

- **Subdomain** - Il tuo URL `*.jamdesk.app`
- **Custom Domain** - Aggiungi il tuo dominio
- **Host at a subpath** - Pubblica la documentazione in un percorso come `/docs` o `/help` invece che nella root del sito

### Build

- **Show Jamdesk Branding** - Mostra nel footer il link "Powered by Jamdesk" (abilitato per impostazione predefinita)
- **Rebuild** - Avvia manualmente un nuovo build

<Note>
Le modifiche alle impostazioni di build richiedono un nuovo build per diventare effettive.
</Note>

## Limiti dei progetti

| Piano | Progetti | Build/mese |
|------|----------|------------|
| Free | 1 | 100 |
| Pro | 10 | Unlimited |
| Team | Unlimited | Unlimited |

## E adesso?

<Columns cols={2}>
  <Card title="Collega GitHub" icon="github" href="/it/setup/connecting-github">
    Collega il repository per eseguire build automatici
  </Card>
  <Card title="Struttura delle directory" icon="folder-tree" href="/it/setup/directory-structure">
    Organizza la documentazione per progetti più grandi
  </Card>
  <Card title="Configurazione monorepo" icon="folders" href="/it/setup/monorepo-support">
    Configura il percorso della documentazione per i monorepo
  </Card>
  <Card title="Tutorial end-to-end" icon="route" href="/it/end-to-end-tutorial">
    Segui il workflow completo di Jamdesk
  </Card>
</Columns>