---
title: "File, cartelle Kalka e versioni | Kalka docs"
description: "I tipi di file che salva Kalka, cosa contiene una cartella Kalka, come funzionano il salvataggio automatico e il recupero dopo un crash, e come tenere le versioni di un design con Git."
url: https://kalka.design/it/docs/files-versions
language: it
---

I tuoi design sono file sul tuo computer. Kalka non ha mai bisogno di un account o di un server per salvarli.

## Tre modi per salvare un documento

| Formato | Cos’è | Ideale per |
| --- | --- | --- |
| Cartella Kalka | Una cartella di pagine HTML, un foglio di stile, design token e immagini | Lavorare con sviluppatori e agenti, tenere le versioni in Git |
| .kalka | La stessa cartella raccolta in un unico file | Inviare un design come file unico |
| .fig | Il formato di file di Figma | Passare avanti e indietro con Figma |

**Salva** (Cmd S su macOS, Ctrl S su Windows e Linux) scrive nel file che hai aperto. **Salva con nome…** sceglie un nuovo file, come `.fig` o `.kalka`. **Salva come cartella…**, nell’app desktop, chiede un nome e una posizione e lì crea una nuova cartella Kalka.

Kalka si rifiuta di salvare in una cartella che contiene già altri file, come il progetto di un sito web o Download, così non mescola mai i suoi file con i tuoi. Una cartella vuota o una cartella Kalka esistente vanno bene.

## Cosa c’è in una cartella Kalka

```
my-design/
  project.json          pages, artboard positions, settings, variables
  pages/
    home.html           one HTML file per page
    pricing.html
  styles.css            the classes your layers share
  design-system/
    tokens.json         your variables as W3C design tokens
    tokens.css          the same tokens as CSS custom properties
  assets/
    images/             every image, named by its content
  instructions/         optional rules, skills and documents for agents
```

_Il pannello Cartella che elenca una cartella Kalka: design-system, instructions, pages, project.json e styles.css_

Il pannello Cartella mostra i file che Kalka scrive per il documento.
Ogni pagina è un semplice file HTML che puoi aprire in un editor di codice o in un browser. Uno sviluppatore può leggerlo, rivederlo in Git e prendere quello che gli serve. La cartella `instructions/` contiene quello che dici agli agenti su questo progetto: un riassunto, regole, le tue skill e documenti di riferimento. Vedi [Gli agenti in Kalka](https://kalka.design/it/docs/agents).

## Salvare in sicurezza

Kalka scrive un nuovo file accanto al vecchio e lo mette al suo posto solo quando è completo. Un crash, un disco pieno o una scrittura non riuscita lasciano il tuo file com’era. Una cartella Kalka viene salvata allo stesso modo: ogni file viene prima scritto a parte, quindi la cartella corrisponde sempre all’ultimo salvataggio o al nuovo, mai a un misto. Un salvataggio interrotto viene completato alla successiva apertura della cartella.

## Salvataggio automatico

Il salvataggio automatico è disattivato per un nuovo documento. Attivalo con **Salvataggio automatico su file** nel menu File: Kalka salva allora qualche secondo dopo che smetti di modificare. Gli serve un file su cui scrivere, quindi salva prima il documento una volta. I documenti aperti da uno spazio di archiviazione cloud si salvano automaticamente da soli.

In Chrome ed Edge, il browser chiede il permesso di scrivere il file quando attivi il salvataggio automatico. Se un salvataggio automatico non riesce, Kalka te lo dice una volta e conserva le tue modifiche per il recupero dopo un crash finché un salvataggio non va di nuovo a buon fine.

## Recupero dopo un crash

Mentre lavori, Kalka conserva sul tuo computer una copia delle modifiche non salvate. Se Kalka o il computer si fermano prima che tu salvi, all’avvio successivo compare **Recupera il lavoro non salvato**: **Ripristina** riporta i documenti, collegati ai file da cui provenivano, così il salvataggio successivo scrive lì. **Scarta** li elimina.

Puoi disattivare questa funzione nelle Impostazioni con **Conserva automaticamente il lavoro non salvato**.

## Quando un’altra app modifica il tuo file

Git, uno strumento di sincronizzazione o un altro editor possono modificare un file che hai aperto. Se non hai modifiche non salvate, Kalka lo ricarica. Se ne hai, Kalka le conserva e ti avvisa che il file è cambiato; scegli **Ricarica dal disco** per prendere l’altra versione, oppure salva per sostituirla con la tua.

## Versioni con Git

Il pannello **Cronologia**, nella barra laterale sinistra, tiene le versioni di un documento con Git. Funziona nell’app desktop, per un documento salvato sul tuo computer, e usa il `git` già installato.

- Apri **Cronologia**. Se la cartella non tiene ancora le versioni, fai clic su **Conserva le versioni**. Kalka crea un repository Git nella cartella del documento.

- Descrivi cosa è cambiato sotto **Cosa è cambiato** e fai clic su **Crea versione**. Kalka salva prima il documento; se il salvataggio non riesce, non viene registrato nulla.

- Per tornare indietro, fai clic su **Ripristina** accanto a una versione. Kalka registra prima il punto in cui eri, così anche il ripristino si può annullare, poi ricarica il documento.

Per una cartella Kalka, una versione registra tutta la cartella. Per un file `.fig` o `.kalka`, registra solo quel file: gli altri file accanto non vengono mai registrati né ripristinati.

La prima volta, Kalka può chiederti nome e indirizzo e-mail. Vengono salvati solo in quel repository.

### Pubblicare le versioni online

Per tenere le tue versioni su GitHub o su un altro host Git, crea lì un repository vuoto, incolla il suo indirizzo sotto **Pubblica online** e fai clic su **Collega**. Kalka usa l’accesso Git già configurato sul tuo computer. Da quel momento ogni versione che crei viene pubblicata. **Recupera** porta le versioni pubblicate da altrove, e **Pubblica** invia le tue se ne hai create offline.

Quando le modifiche le ha fatte un agente, la versione dice quale, per esempio Pebble.
