# Modelli di documento

> Disegna i tuoi documenti, con l'IA o a mano.

nullish ha già dei modelli predefiniti, sobri, in inglese, tedesco, francese e italiano. Se vuoi documenti che ti somiglino, disegnane di tuoi: la pagina è tutta tua, non solo un logo e una riga di testo.

I modelli nascono nel progetto [nullish document templates](https://github.com/usenullish/document-templates), che mostra i tuoi documenti in anteprima live con dati di esempio: ogni modifica la vedi subito. Il lavoro puoi lasciarlo all'IA o farlo tu.

## Scaricare il progetto

{% steps %}

1. Fai un fork di [usenullish/document-templates](https://github.com/usenullish/document-templates) su GitHub se vuoi tenere i modelli in un repository tuo, poi clonalo:

   ```sh
   git clone https://github.com/usenullish/document-templates.git
   cd document-templates
   npm ci
   ```

2. Avvia l'anteprima e apri [localhost:4321](http://localhost:4321):

   ```sh
   npm run dev
   ```

{% /steps %}

## Farlo disegnare all'IA

Apri il progetto in un assistente di programmazione come Claude Code, Cursor o Copilot e spiegagli cosa vuoi:

- "Usa il mio logo da `logo.svg` nell'angolo in alto a sinistra e il colore del nostro marchio `#1d4ed8` per i titoli."
- "Metti il nostro indirizzo nel piè di pagina e le coordinate bancarie accanto ai totali."
- "Fallo somigliare di più a questo PDF" (con una vecchia fattura allegata).

Il progetto descrive i dati di ogni documento, quindi l'assistente sa cosa ha a disposizione. Tieni l'anteprima aperta lì accanto e chiedi ritocchi finché il risultato non ti piace.

## Oppure fallo tu

Ogni documento ha la sua cartella in `src/templates/`. Per le fatture è `src/templates/invoices/`:

- `Invoice.astro` è il layout: cosa appare sulla pagina, e dove.
- `i18n.json` contiene i testi in inglese, francese, tedesco e italiano.

Lo stile lo definisci con CSS semplice o con le classi Tailwind. Le misure sono in millimetri, come sulla carta. Nel [README del progetto](https://github.com/usenullish/document-templates#readme) trovi i dati di ogni documento e la sintassi dei modelli.

{% aside %}
nullish salva solo l'HTML, quindi il modello non può caricare niente da fuori. Incorpora il logo
come SVG o come URI `data:`, e lo stesso vale per un font personalizzato.
{% /aside %}

## Caricarlo su nullish

{% steps %}

1. Compila i modelli:

   ```sh
   npm run build
   ```

   Ti ritrovi un file per lingua per ogni documento, per esempio in `templates/invoices/`: `en.html`, `fr.html`, `de.html` e `it.html`.

2. In nullish vai su **Impostazioni → Fatturazione → Modelli di documento** e crea un modello. Dagli un **Nome**.

3. Scegli **Aggiungi un contenuto** per ogni lingua che ti serve: seleziona la **Lingua** e carica il file corrispondente, per esempio `it.html` per l'italiano.

{% /steps %}

Quando generi un PDF, per esempio una fattura, scegli il tuo modello sotto **Modello di documento**. Puoi averne più di uno, per esempio uno per marchio.

{% aside type="tip" %}
Basta un errore di battitura nei dati usati dal modello e il PDF non si genera: così te ne accorgi subito. Controlla
nell'anteprima prima di caricarlo.
{% /aside %}