---
title: "Dateien, Kalka-Ordner und Versionen | Kalka docs"
description: "Die Dateitypen, die Kalka speichert, was ein Kalka-Ordner enthält, wie automatisches Speichern und Absturzwiederherstellung funktionieren und wie du Versionen eines Designs mit Git behältst."
url: https://kalka.design/de/docs/files-versions
language: de
---

Deine Designs sind Dateien auf deinem Computer. Zum Speichern braucht Kalka nie ein Konto oder einen Server.

## Drei Arten, ein Dokument zu speichern

| Format | Was es ist | Geeignet für |
| --- | --- | --- |
| Kalka-Ordner | Ein Ordner mit HTML-Seiten, einem Stylesheet, Design-Tokens und Bildern | Arbeit mit Entwicklern und Agenten, Versionen in Git |
| .kalka | Derselbe Ordner, in eine Datei gepackt | Ein Design als einzelne Datei verschicken |
| .fig | Das Dateiformat von Figma | Hin und her mit Figma |

**Speichern** (Cmd S unter macOS, Ctrl S unter Windows und Linux) schreibt in die geöffnete Datei. **Speichern unter…** wählt eine neue Datei, als `.fig` oder `.kalka`. **Als Ordner speichern…** fragt in der Desktop-App nach Name und Ort und legt dort einen neuen Kalka-Ordner an.

Kalka speichert nicht in einen Ordner, der schon andere Dateien enthält, etwa ein Website-Projekt oder deine Downloads, damit sich seine Dateien nie mit deinen mischen. Ein leerer Ordner oder ein bestehender Kalka-Ordner ist in Ordnung.

## Was in einem Kalka-Ordner liegt

```
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
```

_Das Ordner-Panel mit einem Kalka-Ordner: design-system, instructions, pages, project.json und styles.css_

Das Ordner-Panel zeigt die Dateien, die Kalka für das Dokument schreibt.
Jede Seite ist eine einfache HTML-Datei, die du in einem Code-Editor oder Browser öffnen kannst. Entwickler können sie lesen, in Git prüfen und übernehmen, was sie brauchen. Der Ordner `instructions/` enthält, was du Agenten über dieses Projekt sagst: eine Zusammenfassung, Regeln, deine eigenen Skills und Referenzdokumente. Siehe [Agenten in Kalka](https://kalka.design/de/docs/agents).

## Sicher speichern

Kalka schreibt eine neue Datei neben die alte und tauscht sie erst aus, wenn sie vollständig ist. Ein Absturz, eine volle Festplatte oder ein fehlgeschlagener Schreibvorgang lässt deine Datei unverändert. Ein Kalka-Ordner wird genauso gespeichert: Jede Datei wird zuerst daneben geschrieben, sodass der Ordner immer entweder der letzte oder der neue Speicherstand ist, nie eine Mischung. Ein abgebrochenes Speichern wird beim nächsten Öffnen des Ordners abgeschlossen.

## Automatisch speichern

Für ein neues Dokument ist automatisches Speichern aus. Schalte es im Menü Datei mit **Automatisch in Datei speichern** ein: Kalka speichert dann ein paar Sekunden, nachdem du aufhörst zu bearbeiten. Dafür braucht es eine Datei, in die geschrieben wird, also speichere das Dokument zuerst einmal. Dokumente aus einem Cloud-Speicher-Arbeitsbereich speichern von selbst automatisch.

In Chrome und Edge fragt der Browser beim Einschalten um Erlaubnis, die Datei zu schreiben. Schlägt ein automatisches Speichern fehl, sagt Kalka dir das einmal und behält deine Änderungen für die Absturzwiederherstellung, bis wieder ein Speichern gelingt.

## Absturzwiederherstellung

Während du arbeitest, behält Kalka eine Kopie der nicht gespeicherten Änderungen auf deinem Computer. Hören Kalka oder dein Computer vor dem Speichern auf zu laufen, zeigt der nächste Start **Nicht gespeicherte Arbeit wiederherstellen**: **Wiederherstellen** holt die Dokumente zurück, verknüpft mit den Dateien, aus denen sie stammen, sodass das nächste Speichern dorthin schreibt. **Verwerfen** verwirft sie.

Du kannst das in den Einstellungen mit **Ungespeicherte Arbeit automatisch sichern** ausschalten.

## Wenn eine andere App deine Datei ändert

Git, ein Sync-Tool oder ein anderer Editor kann eine Datei ändern, die du geöffnet hast. Ohne ungespeicherte Änderungen lädt Kalka sie neu. Mit ungespeicherten Änderungen behält Kalka sie und sagt dir, dass sich die Datei geändert hat; wähle **Reload from disk**, um die andere Version zu übernehmen, oder speichere, um sie durch deine zu ersetzen.

## Versionen mit Git

Das Panel **Verlauf** in der linken Leiste behält Versionen eines Dokuments mit Git. Es funktioniert in der Desktop-App, für ein Dokument, das auf deinem Computer gespeichert ist, und nutzt das dort bereits installierte `git`.

- Öffne **Verlauf**. Behält der Ordner noch keine Versionen, klicke auf **Versionen behalten**. Kalka legt im Ordner des Dokuments ein Git-Repository an.

- Beschreibe unter **Was sich geändert hat** die Änderungen und klicke auf **Version anlegen**. Kalka speichert zuerst das Dokument; schlägt das Speichern fehl, wird nichts festgehalten.

- Um zurückzugehen, klicke neben einer Version auf **Wiederherstellen**. Kalka hält zuerst fest, wo du warst, sodass sich auch das Wiederherstellen rückgängig machen lässt, und lädt das Dokument dann neu.

Bei einem Kalka-Ordner hält eine Version den ganzen Ordner fest. Bei einer `.fig`- oder `.kalka`-Datei nur diese Datei: Andere Dateien daneben werden nie festgehalten oder wiederhergestellt.

Beim ersten Mal fragt Kalka eventuell nach deinem Namen und deiner E-Mail-Adresse. Sie werden nur in diesem Repository gespeichert.

### Versionen online veröffentlichen

Um deine Versionen auf GitHub oder einem anderen Git-Host zu behalten, lege dort ein leeres Repository an, füge seine Adresse unter **Online veröffentlichen** ein und klicke auf **Verbinden**. Kalka nutzt die Git-Anmeldung, die schon auf deinem Computer eingerichtet ist. Danach wird jede Version veröffentlicht, die du anlegst. **Aktualisieren** holt Versionen, die anderswo veröffentlicht wurden, und **Veröffentlichen** sendet deine, falls du offline welche angelegt hast.

Hat ein Agent die Änderungen gemacht, nennt die Version ihn, etwa Pebble.
