For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /de/docs/web/before-you-start.md (or send Accept: text/markdown).
Bevor Sie beginnen
Installieren Sie Node.js, Git und einen Editor, nehmen Sie Ihre Repository-Einladung an, laden Sie das Kit herunter und prüfen Sie, ob Ihr Computer für die erste Ausführung bereit ist.
1. Wählen Sie aus, was Sie ausführen möchten
Verwenden Sie einen Windows-, macOS- oder Linux-Computer mit Internetverbindung. Ein Browser führt die Web-App aus. Auf einem Telefon wird die mobile App ausgeführt. Die Desktop-App wird in einem eigenen Fenster geöffnet. Ihr Telefon allein kann die folgenden Installationsschritte nicht ausführen.
Ein Repository ist der Ordner mit Dateien, die Sie über GitHub erhalten haben. Web-, Mobil- und Desktop-Käufe stellen jeweils das entsprechende Kit-Repository bereit; Das All Platforms-Bundle stellt das Monorepo bereit, einen Ordner, der alle drei Apps enthält. Akzeptieren Sie die Einladung für das von Ihnen erworbene Repository. Ein mobiler oder Desktop-Checkout benötigt weiterhin ein erreichbares Web-Backend: den Server, der Konten und Daten verwaltet. Diese Client-Repositorys enthalten nicht den Webserver.
Bereiten Sie diese Werkzeuge einmal vor. Das Herunterladen von Tools und die erste native Kompilierung können deutlich länger als fünf Minuten dauern. Nach diesen Vorbereitungen beginnen die fünfminütigen Führungen; Durch die lokale Ausführung wird Ihre App nicht im Internet veröffentlicht.
2. Installieren Sie Node.js
Öffnen Sie unten die offizielle Node.js-Downloadseite. Wählen Sie eine LTS-Version mit der Nummer 22 oder höher und das Installationsprogramm für Ihren Computer: .msi unter Windows oder .pkg unter macOS. Öffnen Sie das heruntergeladene Installationsprogramm, behalten Sie die Standardeinstellungen bei und schließen Sie die Installation ab. Mit Node.js kann Ihr Computer das JavaScript der App ausführen. npm wird damit installiert.
Schließen Sie Ihr Terminal und öffnen Sie es nach der Installation erneut. Öffnen Sie unter Windows Start, geben Sie PowerShell ein und öffnen Sie es. Drücken Sie unter macOS Befehl + Leertaste, geben Sie Terminal ein und drücken Sie die Eingabetaste. Öffnen Sie unter Linux Terminal aus Ihrem Anwendungsmenü. Fügen Sie den folgenden Befehl ein und drücken Sie dann die Eingabetaste. Ein Ergebnis wie v22.x.x oder v24.x.x bestätigt, dass der Knoten verfügbar ist. Wenn Sie sehen, dass der Befehl nicht gefunden oder nicht erkannt wurde, öffnen Sie das Terminal erneut oder installieren Sie Node mit aktivierter Option PATH neu.
node --version
npm --version3. Installieren Sie Git und einen Texteditor
Öffnen Sie unten die Git-Downloadseite, wählen Sie Ihr Betriebssystem aus und folgen Sie dem Installationsprogramm. Git lädt Ihr privates Repository herunter und zeichnet Dateiänderungen auf. Unter macOS bietet die Ausführung des folgenden Befehls möglicherweise die Installation der Befehlszeilentools von Apple; Akzeptieren Sie es und führen Sie den Befehl nach Abschluss erneut aus. Verwenden Sie unter Linux den Installationsbefehl, der für Ihre Distribution auf der Git-Seite angezeigt wird.
Installieren Sie Visual Studio Code von der offiziellen Download-Seite. Dies ist ein Texteditor zum Öffnen des Projekts und Speichern von Konfigurationsdateien. Öffnen Sie es, wählen Sie Datei → Ordner öffnen (Datei → Öffnen unter macOS) und wählen Sie später den Supastack-Ordner aus, den Sie herunterladen. Sie müssen keinen Code schreiben, um die erste lokale Demonstration abzuschließen.
Führen Sie in einem neu geöffneten Terminal den folgenden Befehl aus. Ein Ergebnis, das mit der Git-Version beginnt, bedeutet, dass Git bereit ist. Wenn der Befehl fehlt, beenden Sie das Installationsprogramm und öffnen Sie das Terminal erneut.
git --version4. Akzeptieren Sie Ihre GitHub-Einladung
Melden Sie sich in Ihrem Browser bei GitHub mit dem Konto an, das Sie beim Kauf angegeben haben. Öffnen Sie Ihre GitHub-Einladungs-E-Mail, wählen Sie Einladung anzeigen und akzeptieren Sie den Zugriff. Öffnen Sie dann das eingeladene Repository. Sie sollten seine Dateien und eine grüne Code-Schaltfläche sehen. Ein 404-Fehler bedeutet normalerweise, dass die Einladung nicht angenommen wurde oder Sie bei einem anderen GitHub-Konto angemeldet sind.
Wählen Sie Code → Lokal → HTTPS und kopieren Sie die angezeigte Adresse. Verwenden Sie im nächsten Schritt genau diese Adresse. Beispieladressen, die spitze Klammern enthalten, sind Vorlagen: Ersetzen Sie sie, anstatt die Klammern einzufügen. Sie müssen den Namen einer Organisation nicht erraten oder das private Repository öffentlich machen.
5. Laden Sie das Projekt auf Ihren Computer herunter
Wählen Sie einen Ordner für Ihre Projekte, z. B. „Dokumente“. Öffnen Sie diesen Ordner im Datei-Explorer oder Finder. Klicken Sie unter Windows mit der rechten Maustaste auf einen leeren Bereich und wählen Sie „Im Terminal öffnen“. Wählen Sie dann bei Bedarf PowerShell. Öffnen Sie unter macOS das Terminal, geben Sie cd gefolgt von einem Leerzeichen ein, ziehen Sie den Ordner in das Terminal und drücken Sie die Eingabetaste. Das Terminal arbeitet jetzt in diesem Ordner.
Ersetzen Sie im ersten Befehl unten YOUR_COPIED_HTTPS_ADDRESS durch die HTTPS-Adresse, die Sie gerade kopiert haben. Führen Sie jeweils eine Zeile aus. Die erste Zeile erstellt einen neuen Ordner namens supastack; die zweite Zeile betritt es. Wenn Git Sie zur Anmeldung auffordert, schließen Sie die Browser-Anmeldung ab. Verwenden Sie Ihr GitHub-Kontokennwort nicht als Git-Kennwort. Wenn die Browser-Anmeldung nicht verfügbar ist, befolgen Sie die unten verlinkte HTTPS-Authentifizierungsanleitung von GitHub.
Erfolg: Der Supastack-Ordner enthält package.json, pnpm-workspace.yaml, Apps und Pakete. Dies ist das Repository-Stammverzeichnis. Wenn Git angibt, dass das Ziel bereits existiert, verwenden Sie einen anderen leeren Ordner oder öffnen Sie den vorhandenen Klon. Löschen Sie Ihre Arbeit nicht. Lassen Sie dieses Terminal für den nächsten Schritt geöffnet.
git clone YOUR_COPIED_HTTPS_ADDRESS supastack
cd supastack6. Überprüfen Sie Corepack und den angehefteten Paketmanager
Führen Sie den ersten Befehl unten aus. Corepack wählt die in package.json aufgezeichnete pnpm-Version aus. pnpm lädt die Bibliotheken herunter, die das Projekt verwendet. Wenn Corepack um Erlaubnis zum Herunterladen dieser Version bittet, geben Sie y ein und drücken Sie die Eingabetaste. Diese Checkout-Pins pnpm 11.19.0; Behalten Sie die PIN bei, anstatt einen anderen Paketmanager zu wählen.
Wenn das Corepack fehlt, führen Sie npm install --global corepack aus, öffnen Sie Ihr Terminal erneut und versuchen Sie es erneut. Wenn PowerShell angibt, dass ein npm.ps1- oder corepack.ps1-Skript nicht ausgeführt werden kann, verwenden Sie npm.cmd oder corepack.cmd für diesen Befehl, einschließlich corepack.cmd pnpm install. Sie müssen die Ausführungsrichtlinie Ihres Computers nicht ändern.
Die gefilterten Erstausführungsbefehle rufen Corepack direkt auf. Wenn Sie einen Turbo-Befehl wie corepack pnpm dev verwenden, benötigt Turbo auch einen pnpm-Befehl auf PATH. Das folgende Windows-Setup erstellt diesen Befehl in einem vom Benutzer beschreibbaren Ordner. Die Änderung PATH gilt nur für das aktuelle Terminal. Führen Sie diesen Block nach dem Öffnen eines neuen Terminals erneut aus, wenn pnpm fehlt. Führen Sie unter macOS/Linux corepack enable aus; Wenn ein Berechtigungsfehler gemeldet wird, verwenden Sie stattdessen den gefilterten Erstausführungsbefehl.
corepack --version
corepack pnpm --version
# Windows PowerShell only, for Turbo commands:
$kitShimDir = Join-Path $env:LOCALAPPDATA 'supastack/corepack-shims'
New-Item -ItemType Directory -Path $kitShimDir -Force | Out-Null
corepack enable --install-directory $kitShimDir
$env:PATH = "$kitShimDir;$env:PATH"7. Fahren Sie mit Ihrer Plattform fort
Sie sind bereit, wenn Node- und Git-Druckversionen vorhanden sind. Corepack kann das angeheftete pnpm auswählen und Ihr Terminal befindet sich im Ordner mit package.json. Wählen Sie unten ein Tutorial aus. Docker ist für die Webdemonstration optional; Für echte Konten ist später eine Datenbank erforderlich. Desktop benötigt außerdem Rust und native Build-Tools, die im Tutorial vor dem Startbefehl erläutert werden.