---
title: "Archivos, carpetas de Kalka y versiones | Kalka docs"
description: "Los tipos de archivo que guarda Kalka, qué contiene una carpeta de Kalka, cómo funcionan el guardado automático y la recuperación tras un cierre inesperado, y cómo guardar versiones de un diseño con Git."
url: https://kalka.design/es/docs/files-versions
language: es
---

Tus diseños son archivos en tu ordenador. Kalka nunca necesita una cuenta ni un servidor para guardarlos.

## Tres formas de guardar un documento

| Formato | Qué es | Para qué sirve |
| --- | --- | --- |
| Carpeta de Kalka | Una carpeta con páginas HTML, una hoja de estilos, design tokens e imágenes | Trabajar con desarrolladores y agentes, guardar versiones en Git |
| .kalka | La misma carpeta empaquetada en un solo archivo | Enviar un diseño como un único archivo |
| .fig | El formato de archivo de Figma | Ir y volver entre Kalka y Figma |

**Guardar** (Cmd S en macOS, Ctrl S en Windows y Linux) escribe en el archivo que abriste. **Guardar como…** elige un archivo nuevo, como `.fig` o `.kalka`. **Guardar como carpeta…**, en la app de escritorio, pide un nombre y un lugar y crea ahí una carpeta de Kalka nueva.

Kalka no guarda en una carpeta que ya contiene otros archivos, como un proyecto web o Descargas, para no mezclar nunca sus archivos con los tuyos. Una carpeta vacía o una carpeta de Kalka existente sirven.

## Qué hay en una carpeta de 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
```

_El panel Carpeta con una carpeta de Kalka: design-system, instructions, pages, project.json y styles.css_

El panel Carpeta muestra los archivos que Kalka escribe para el documento.
Cada página es un archivo HTML normal que puedes abrir en un editor de código o en un navegador. Un desarrollador puede leerlo, revisarlo en Git y tomar lo que necesite. La carpeta `instructions/` contiene lo que cuentas a los agentes sobre este proyecto: un resumen, reglas, tus propias skills y documentos de referencia. Consulta [Agentes en Kalka](https://kalka.design/es/docs/agents).

## Guardado seguro

Kalka escribe un archivo nuevo junto al antiguo y solo lo intercambia cuando está completo. Un cierre inesperado, un disco lleno o una escritura fallida dejan tu archivo como estaba. Una carpeta de Kalka se guarda igual: cada archivo se escribe primero aparte, así que la carpeta es siempre el último guardado o el nuevo, nunca una mezcla. Un guardado interrumpido se completa la próxima vez que se abre la carpeta.

## Guardado automático

El guardado automático está desactivado en un documento nuevo. Actívalo con **Guardado automático en archivo** en el menú Archivo: Kalka guarda entonces unos segundos después de que dejes de editar. Necesita un archivo en el que escribir, así que guarda el documento una vez antes. Los documentos abiertos desde un espacio de almacenamiento en la nube se guardan solos.

En Chrome y Edge, el navegador pide permiso para escribir el archivo cuando activas el guardado automático. Si un guardado automático falla, Kalka te avisa una vez y conserva tus cambios para la recuperación hasta que un guardado vuelva a funcionar.

## Recuperación tras un cierre inesperado

Mientras trabajas, Kalka guarda una copia de los cambios sin guardar en tu ordenador. Si Kalka o tu ordenador se detienen antes de que guardes, el siguiente arranque muestra **Recuperar trabajo no guardado**: **Restaurar** recupera los documentos, vinculados a los archivos de los que venían, para que el siguiente guardado escriba ahí. **Descartar** los elimina.

Puedes desactivarlo en Ajustes con **Conservar automáticamente el trabajo no guardado**.

## Cuando otra app cambia tu archivo

Git, una herramienta de sincronización u otro editor pueden cambiar un archivo que tienes abierto. Si no tienes cambios sin guardar, Kalka lo vuelve a cargar. Si los tienes, Kalka los conserva y te avisa de que el archivo ha cambiado; elige **Reload from disk** para quedarte con la otra versión, o guarda para reemplazarla por la tuya.

## Versiones con Git

El panel **Historial**, en la barra izquierda, guarda versiones de un documento con Git. Funciona en la app de escritorio, con un documento guardado en tu ordenador, y usa el `git` que ya tienes instalado.

- Abre **Historial**. Si la carpeta aún no guarda versiones, haz clic en **Guardar versiones**. Kalka crea un repositorio Git en la carpeta del documento.

- Describe los cambios en **Qué ha cambiado** y haz clic en **Crear versión**. Kalka guarda primero el documento; si el guardado falla, no se registra nada.

- Para volver atrás, haz clic en **Restaurar** junto a una versión. Kalka registra antes dónde estabas, así que la restauración también se puede deshacer, y luego vuelve a cargar el documento.

En una carpeta de Kalka, una versión registra la carpeta entera. En un archivo `.fig` o `.kalka`, registra solo ese archivo: los demás archivos que haya a su lado nunca se registran ni se restauran.

La primera vez, Kalka puede pedirte tu nombre y tu correo electrónico. Se guardan solo en ese repositorio.

### Publicar versiones en línea

Para guardar tus versiones en GitHub o en otro servicio Git, crea allí un repositorio vacío, pega su dirección en **Publicar en línea** y haz clic en **Conectar**. Kalka usa el inicio de sesión de Git que ya tienes en tu ordenador. A partir de ahí, cada versión que creas se publica. **Traer cambios** incorpora las versiones publicadas desde otro sitio, y **Publicar** envía las tuyas si creaste alguna sin conexión.

Cuando los cambios los hizo un agente, la versión dice cuál, por ejemplo Pebble.
