# Erste Schritte

## Webversion

OpenPencil läuft direkt im Browser und muss nicht installiert werden. Öffnen Sie [app.openpencil.dev](https://app.openpencil.dev), um mit der Gestaltung zu beginnen.

Wenn Sie ein eigenes Produkt auf OpenPencil aufbauen möchten, lesen Sie den Bereich [Automatisierung](/programmable/) und die Dokumentation zum [Vue SDK](/programmable/sdk/).

## Desktop-Anwendung

Fertige Versionen für macOS, Windows und Linux finden Sie auf der [Release-Seite](https://github.com/open-pencil/open-pencil/releases/latest).

| Plattform | Datei |
| --------------------- | -------------------- |
| macOS (Apple Silicon) | `.dmg` (aarch64) |
| macOS (Intel) | `.dmg` (x64) |
| Windows (x64) | `.msi` / `.exe` |
| Windows (ARM) | `.msi` / `.exe` |
| Linux (x64) | `.AppImage` / `.deb` |

## Systemvoraussetzungen

OpenPencil rendert mit CanvasKit über WebGL und nutzt aktuelle Webplattform-Funktionen, daher ist eine neuere Browser-Engine erforderlich. Die Webversion unterstützt Chrome 111, Edge 111, Firefox 128 und Safari 16.4 oder neuer; Chromium-basierte Browser wie Brave und Opera richten sich nach ihrer Chrome-Version. Die Desktop-Anwendung rendert im WebView des Systems, daher bestimmt die Engine des Betriebssystems die Untergrenze:

| Plattform | Voraussetzung |
| --------- | ------------- |
| macOS | macOS 13 Ventura oder neuer mit den aktuellen Safari-Updates (Safari 16.4 wurde mit macOS 13.3 ausgeliefert). |
| Windows | Windows 10 oder neuer mit der Laufzeitumgebung Microsoft Edge WebView2 Evergreen, die sich selbst aktualisiert. |
| Linux | WebKitGTK 2.40 oder neuer (`webkit2gtk-4.1`). |

Ist die Engine zu alt, zeigt OpenPencil an, was aktualisiert werden muss, statt ein leeres Fenster darzustellen. Erscheint dieser Hinweis auf einem System, das die Voraussetzungen erfüllt, verwenden Sie den Link „Report a problem“, der die Angaben zu Browser und Engine vorausfüllt.

## Installation unter macOS mit Homebrew

```sh
brew install --cask openpencil
```

Der Befehl installiert die signierte App für Macs mit Apple Silicon oder Intel-Prozessor aus dem [offiziellen Homebrew-Katalog](https://formulae.brew.sh/cask/openpencil). Updates werden von Homebrew geprüft und können später als GitHub-Releases erscheinen. Bis dahin steht der [direkte Download](https://github.com/open-pencil/open-pencil/releases/latest) bereit. Die CLI wird separat installiert: `npm install -g @open-pencil/cli`.

Wenn du den archivierten eigenen Tap verwendet hast, wechsle so:

```sh
brew uninstall open-pencil/tap/open-pencil
brew install --cask openpencil
```

## Aus dem Quellcode erstellen

### Voraussetzungen

- [Bun](https://bun.sh/) als Runtime und Package Manager;
- [Rust](https://rustup.rs/) nur für die Tauri-Anwendung.

### Installation

```sh
git clone https://github.com/open-pencil/open-pencil.git
cd open-pencil
bun install
```

### Entwicklungsserver

```sh
bun run dev
```

Der Editor ist anschließend unter `http://localhost:1420` erreichbar.

### Befehle

| Befehl | Zweck |
| ------------------------------- | --------------------------------------------------------------------------------------- |
| `bun run dev` | Entwicklungsserver mit HMR starten |
| `bun run build` | Produktionsversion erstellen |
| `bun run check` | oxlint und Typprüfung mit tsgo ausführen |
| `bun run test` | E2E- und visuelle Regressionstests mit Playwright ausführen |
| `bun run test:update` | Referenz-Screenshots aktualisieren |
| `bun run test:unit` | Unit-Tests mit bun:test ausführen |
| `bun run docs:dev` | Entwicklungsserver der Dokumentation starten |
| `bun run docs:build` | Dokumentation schnell zur lokalen Prüfung erstellen |
| `bun run docs:build:production` | Vollständige veröffentlichungsfähige Dokumentation einschließlich LLM-Dateien erstellen |

## Tauri-Anwendung

Zum Erstellen der Tauri-Anwendung werden Rust und plattformspezifische Systemkomponenten benötigt.

### macOS

```sh
xcode-select --install
cargo install tauri-cli --version "^2"
bun run tauri dev
```

### Windows

1. Installieren Sie [Rust](https://rustup.rs/) mit der Toolchain `stable-msvc`:
   ```sh
   rustup default stable-msvc
   ```
2. Installieren Sie die [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/) mit der Workload **Desktop development with C++**.
3. WebView2 ist in Windows 10 ab Version 1803 und in Windows 11 bereits enthalten.
4. Führen Sie Folgendes aus:
   ```sh
   bun run tauri dev
   ```

### Linux

Installieren Sie unter Debian oder Ubuntu die Systemabhängigkeiten:

```sh
sudo apt install libwebkit2gtk-4.1-dev build-essential curl wget file \
  libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
```

Führen Sie anschließend aus:

```sh
bun run tauri dev
```

### Installationspaket erstellen

```sh
bun run tauri build                                    # Aktuelle Plattform
bun run tauri build --target universal-apple-darwin    # Universal Binary für macOS
```