Salta ai contenuti

Modelli di documento

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, 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.

  1. Fai un fork di usenullish/document-templates su GitHub se vuoi tenere i modelli in un repository tuo, poi clonalo:

    Finestra del terminale
    git clone https://github.com/usenullish/document-templates.git
    cd document-templates
    npm ci
  2. Avvia l'anteprima e apri localhost:4321:

    Finestra del terminale
    npm run dev

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.

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 trovi i dati di ogni documento e la sintassi dei modelli.

  1. Compila i modelli:

    Finestra del terminale
    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.

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.