---
title: Ein Projekt erstellen
description: Erstellen Sie ein Jamdesk-Projekt aus einer Vorlage oder verbinden Sie ein vorhandenes GitHub-Repository. Ihre Website ist in wenigen Minuten live.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Bevor Sie Dokumentation schreiben können, benötigen Sie ein Projekt. Sie können mit einer Vorlage beginnen (Jamdesk erstellt das GitHub-Repository für Sie) oder ein vorhandenes Repository verbinden, das bereits eine `docs.json` enthält. In beiden Fällen ist Ihre Website innerhalb weniger Minuten live.

## Ein neues Projekt erstellen

<Steps>
  <Step title="Sign in to Jamdesk">
    Gehen Sie zu [dashboard.jamdesk.com](https://dashboard.jamdesk.com) und melden Sie sich mit Ihrem GitHub-Konto an.

    Erstnutzer werden aufgefordert, die Jamdesk GitHub App zu autorisieren.
  </Step>

  <Step title="Click New Project">
    Klicken Sie im Dashboard oben rechts auf **New Project**.
  </Step>

  <Step title="Einen Ausgangspunkt auswählen">
    <Tabs>
      <Tab title="From Template">
        Beginnen Sie mit einer vorgefertigten Vorlage. Jamdesk erstellt für Sie ein neues GitHub-Repository mit Beispielinhalten, Navigation und bereits konfigurierten Komponenten.

        Die standardmäßige [Starter Template](https://github.com/jamdesk/starter-docs) enthält Beispielseiten, eine OpenAPI-Spezifikation und Beispiele für jede Komponente. Ersetzen Sie die Inhalte durch Ihre eigenen, und schon sind Sie fertig.
      </Tab>
      <Tab title="From Repository">
        Verbinden Sie ein vorhandenes GitHub-Repository:

        1. Wählen Sie das Repository aus dem Dropdown-Menü aus
        2. Wählen Sie den bereitzustellenden Branch aus (normalerweise `main`)
        3. Geben Sie den Pfad zu `docs.json` an, falls sich die Datei nicht im Stammverzeichnis befindet
      </Tab>
    </Tabs>
  </Step>

  <Step title="Projekteinstellungen konfigurieren">
    Legen Sie die grundlegenden Informationen Ihres Projekts fest:

    | Field | Description |
    |-------|-------------|
    | **Name** | Im Dashboard angezeigter Anzeigename |
    | **Slug** | URL-freundlicher Bezeichner (z. B. `my-docs`) |
    | **Domain** | Ihre `*.jamdesk.app`-Subdomain |
  </Step>
</Steps>

## Minimale Repository-Struktur

Ein Jamdesk-Projekt benötigt nur eine `docs.json` und mindestens eine Seite:

```bash
my-docs/
├── docs.json
└── introduction.mdx
```

Beispiel für `docs.json`:

```json docs.json
{
  "$schema": "https://jamdesk.com/docs.json",
  "name": "My Docs",
  "theme": "jam",
  "navigation": {
    "groups": [
      {
        "group": "Getting Started",
        "pages": ["introduction"]
      }
    ]
  }
}
```

## Projekteinstellungen

Konfigurieren Sie Ihr Projekt nach der Erstellung unter **Settings**:

### Allgemein

- **Name** – Aktualisieren Sie den Anzeigenamen
- **Slug** – Ändern Sie den Projektbezeichner
- **Delete Project** – Entfernen Sie das Projekt dauerhaft

### Repository

- **Branch** – Der Branch, der Bereitstellungen auslöst
- **Docs Path** – Speicherort von `docs.json` in Monorepos

### Domain

- **Subdomain** – Ihre `*.jamdesk.app`-URL
- **Custom Domain** – Fügen Sie Ihre eigene Domain hinzu
- **Host at a subpath** – Stellen Sie die Dokumentation unter einem Pfad wie `/docs` oder `/help` statt im Stammverzeichnis der Website bereit

### Build

- **Show Jamdesk Branding** – Zeigen Sie den Link „Powered by Jamdesk“ in der Fußzeile an (standardmäßig aktiviert)
- **Rebuild** – Lösen Sie manuell einen neuen Build aus

<Note>
Änderungen an den Build-Einstellungen werden erst mit einem neuen Build wirksam.
</Note>

## Projektlimits

| Plan | Projects | Builds/Month |
|------|----------|--------------|
| Free | 1 | 100 |
| Pro | 10 | Unlimited |
| Team | Unlimited | Unlimited |

## Wie geht es weiter?

<Columns cols={2}>
  <Card title="GitHub verbinden" icon="github" href="/de/setup/connecting-github">
    Verbinden Sie Ihr Repository für automatische Builds
  </Card>
  <Card title="Verzeichnisstruktur" icon="folder-tree" href="/de/setup/directory-structure">
    Organisieren Sie Ihre Dokumentation für eine skalierbare Struktur
  </Card>
  <Card title="Monorepo einrichten" icon="folders" href="/de/setup/monorepo-support">
    Konfigurieren Sie den Dokumentationspfad für Monorepos
  </Card>
  <Card title="End-to-End-Tutorial" icon="route" href="/de/end-to-end-tutorial">
    Folgen Sie dem vollständigen Jamdesk-Workflow
  </Card>
</Columns>