Ihr erstes Modul erstellen

Der schnellste Weg zu einem dForge-Modul erfordert keine Installation auf Ihrem Computer — keinen Editor, kein Node.js, keine Einrichtung über die Kommandozeile. Sie starten von einer fertigen Vorlage, die im Browser öffnet, beschreiben in normaler Sprache das gewünschte Modul, und ein KI-Assistent baut es Schritt für Schritt für Sie.

So oder so bauen Sie das Modul im Gespräch mit demselben KI-Assistenten. Es gibt zwei Wege hinein:

• Aus der Vorlage starten — empfohlen. Ein fertiges Projekt, in dem die dForge-Tools und der Authoring-Skill bereits verdrahtet sind — nichts einzurichten. Öffnen Sie es im Browser ohne jede Installation oder klonen Sie es auf Ihren Computer, wenn Sie lieber lokal arbeiten — beides wird hier beschrieben.
• In Ihren eigenen Editor einbinden — fortgeschritten, für Entwickler. Sie haben schon ein Projekt oder ein bevorzugtes Setup? Fügen Sie den dForge-MCP-Server selbst hinzu. Siehe KI-Agent verbinden (MCP).

Die Anleitung unten öffnet die Vorlage im Browser — der einfachste Einstieg. Lieber auf Ihrem eigenen Rechner? Springen Sie ans Ende zu Stattdessen auf Ihrem Computer arbeiten.

Was Sie brauchen

1. Ein kostenloses GitHub-Konto — um die Vorlage zu öffnen.
2. Einen dForge-Mandanten zur Installation — erst im letzten Schritt nötig. Sie können das fertige Modul auch herunterladen und ohne Mandanten über das Admin-Panel installieren.

Alles Übrige — der Editor, der KI-Assistent und die dForge-Authoring-Tools — ist in der Cloud-Arbeitsumgebung bereits vorinstalliert.

1. Von der Vorlage starten

Öffnen Sie die dForge-Modulvorlage: github.com/dforge-core/create-module. Klicken Sie auf Use this template → Create a new repository, um Ihre eigene Kopie anzulegen (privat ist in Ordnung).

2. In der Cloud öffnen

Klicken Sie in Ihrem neuen Repository auf Code → Codespaces → Create codespace on main. Ein vollwertiger Editor öffnet sich direkt im Browser. Beim ersten Laden richtet er sich eine Minute lang selbst ein — er installiert den KI-Assistenten und die dForge-Authoring-Tools für Sie. Lassen Sie das durchlaufen.

Ein Codespace ist eine kostenlose Cloud-Entwicklungsumgebung von GitHub. Es gibt nichts lokal zu installieren, und beim nächsten Öffnen machen Sie genau dort weiter, wo Sie aufgehört haben.

3. Den Assistenten starten

Geben Sie im Terminal-Bereich am unteren Rand des Editors ein:

claude

Melden Sie sich an, wenn Sie dazu aufgefordert werden. Wenn der Assistent fragt, ob die „dforge“-Tools freigegeben werden sollen, bestätigen Sie — genau das erlaubt ihm, Module zu bauen.

4. Ihr Modul beschreiben

Sagen Sie in normaler Sprache, was Sie möchten. Zum Beispiel:

„Bau mir eine Kundenverwaltung für einen Hundesalon — Kunden, ihre Tiere, Termine und Rechnungen.“

Der Assistent führt Sie durch einen kurzen, geführten Ablauf: Er klärt, wofür das Modul gedacht ist, schlägt die zu speichernden Daten vor, entwirft die Bildschirme und die Zugriffsregeln und zeigt Ihnen jeden Teil, bevor etwas geschrieben wird. Sie behalten die Kontrolle — er schlägt vor, Sie bestätigen. Verfeinern Sie jederzeit in normaler Sprache:

„Füge ein Treuepunkte-Feld hinzu.“ · „Zeige Termine in einem Kalender.“ · „Gib dem Empfang eine Nur-Lese-Rolle.“

Wenn er fertig ist, liegt Ihr Modul in einem module/-Ordner in der Arbeitsumgebung.

5. Installieren

Zwei Wege, es nach dForge zu bringen:

• Herunterladen und hochladen — am zuverlässigsten aus einem Codespace. Bitten Sie den Assistenten, „das Modul zu verpacken,“ laden Sie die entstehende .dforge-Datei im Datei-Explorer herunter und laden Sie sie über Modulverwaltung → Installieren im Admin-Panel hoch. Nichts, wofür Sie sich anmelden müssen.

• Den Assistenten direkt installieren lassen. Geben Sie ihm die Web-Adresse Ihres Mandanten — „installiere das in https://ihr-mandant.dforge.app.“ Die CLI öffnet eine Browser-Anmeldung: Sie melden sich wie gewohnt an, und die Sitzung wird lokal gespeichert. Es gibt keine API-Schlüssel oder Tokens zu kopieren — nur Ihre Mandanten-URL.

  Da diese Anmeldung aus der Cloud-Arbeitsumgebung heraus läuft, hängt sie davon ab, dass der Codespace einen lokalen Port an Ihren Browser weiterleitet — was nicht immer klappt. Wenn sie hängt, brechen Sie ab und nutzen Sie die Methode „Herunterladen und hochladen“ oben — die funktioniert immer.

Dort weitermachen, wo Sie aufgehört haben

Ihr Codespace und Ihr Repository bleiben erhalten. Kommen Sie jederzeit zurück, öffnen Sie den Codespace erneut, geben Sie claude ein und verfeinern Sie weiter — „füge Erinnerungen hinzu,“ „füge einen monatlichen Umsatzbericht hinzu.“ Neu verpacken und neu installieren, um die Änderungen in Ihren Mandanten zu übertragen.

Aus einer bestehenden Datenbank

Sie haben bereits ein Schema? Fügen Sie es in den Chat ein — „hier ist meine Tabelle / SQL / DBML, mach daraus ein dForge-Modul“ — und der Assistent wandelt es um und schleift dann gemeinsam mit Ihnen die Kanten ab.

Stattdessen auf Ihrem Computer arbeiten

Lieber lokale Dateien? Klonen Sie dieselbe vorverdrahtete Vorlage auf Ihren Rechner — die dForge-Tools und der Authoring-Skill sind bereits konfiguriert, es gibt also nichts einzurichten:

npx degit dforge-core/create-module my-module
cd my-module
code .   # oder: cursor .  ·  zed .

Öffnen Sie den Ordner, geben Sie beim ersten Hinweis die dforge-Tools frei und bauen Sie genau wie in der Anleitung oben. Tipp: Bietet Ihr Editor „Reopen in Container“ an, nehmen Sie es an — das installiert auch die Assistenten-CLI für Sie.

Sie haben schon ein Projekt oder ein eigenes Editor-Setup? Überspringen Sie die Vorlage und binden Sie den MCP-Server selbst ein — siehe KI-Agent verbinden (MCP).

Verwandt

• KI-Agent verbinden (MCP) — dieselben Authoring-Tools im lokalen Editor ausführen
• Module mit der VS-Code-Erweiterung erstellen — der geführte sechsphasige Ablauf, erklärt
• Erste Schritte — registrieren, ein Modul installieren und die Grundlagen
• Kernkonzepte — Entitäten, Ansichten, Ordner, Rollen und das Metadatenmodell