Zum Inhalt springen

Einrichtung

Diese Anleitung führt Sie durch die Einrichtung von LaunchFast. Wir gehen den Prozess durch, das Projekt zu klonen, die Abhängigkeiten zu installieren, Ihre Datenbank einzurichten und den lokalen Entwicklungsserver zu starten.

Voraussetzungen

Bevor Sie loslegen können, müssen die folgenden Dinge auf Ihrem Rechner installiert sein.

  • Node.js (v18 oder höher)
  • Git
  • VSCode (empfohlen, oder ein beliebiger anderer Code-Editor)
  • Projekteinrichtung

    1. Ein neues Projekt mit LaunchFast erstellen

      Klonen Sie das LaunchFast-Repository:

      Terminal window
      git clone https://github.com/LaunchFast-Boilerplates/launchfa.st-astro

      Installieren Sie als Nächstes alle Abhängigkeiten. Stellen Sie sicher, dass Sie npm installiert haben, bevor Sie den folgenden Befehl ausführen:

      Terminal window
      npm install

      Richten Sie als Nächstes die Umgebungsvariablen ein. Kopieren Sie dazu die Datei .env.example im Stammverzeichnis Ihres Projekts und benennen Sie sie wie folgt in .env um:

      Terminal window
      cp .env.example .env

      Legen Sie schließlich das LaunchFast-Repository als Upstream-Origin für Ihr Projekt fest, damit Sie künftig Updates über die folgenden Befehle einspielen können:

      Terminal window
      rm -rf .git
      git init
      # Your writable remote
      git remote add origin git@github.com:<user>/<repo>.git
      # LaunchFast template for pulling updates only
      git remote add upstream https://github.com/LaunchFast-Boilerplates/launchfa.st-astro
      git add -A
      git commit -m "Initial commit"
      # First push: establishes branch tracking
      git push -u origin main # use 'master' if that’s your default
    2. Ihren Datenbankanbieter einrichten

      Öffnen Sie die Datei .env und aktualisieren Sie DATABASE_TYPE sowie die relevanten Umgebungsvariablen des Datenbankanbieters gemäß den folgenden Anweisungen:

      Initialisieren Sie schließlich das relevante Schema beim Datenbankanbieter, allerdings nur, wenn Sie Postgres oder SQLite nutzen, über den folgenden Befehl:

      Terminal window
      npm run db:setup
    3. Ihren Storage-Anbieter einrichten

      Richten Sie die Storage-Umgebungsvariablen ein, um die Möglichkeit zu nutzen, Dateien (wie Bilder, Videos usw.) über Pre-signed URLs hochzuladen und auszuliefern. LaunchFast unterstützt alle S3-kompatiblen Storage-Anbieter (Amazon S3, Cloudflare R2 und Supabase Storage) sowie Firebase Storage.

      Öffnen Sie die Datei .env und aktualisieren Sie STORAGE_PROVIDER sowie die relevanten Umgebungsvariablen des Storage-Anbieters gemäß den folgenden Anweisungen:

    4. Authentifizierung einrichten

      Öffnen Sie die Datei .env und aktualisieren Sie die Authentifizierungs-Umgebungsvariablen gemäß den folgenden Anweisungen:

    5. Ihren E-Mail-Anbieter einrichten

      Öffnen Sie die Datei .env und aktualisieren Sie die Umgebungsvariablen für den E-Mail-Anbieter, den Sie verwenden möchten, gemäß den folgenden Anweisungen:

    6. Ihren Entwicklungsserver starten

      Jetzt sollte Ihre App startbereit sein. Um den lokalen Entwicklungsserver zu starten, navigieren Sie in das Stammverzeichnis Ihres Projekts und führen Sie den folgenden Befehl aus.

      Terminal window
      npm run dev

      Öffnen Sie localhost:3000 in Ihrem Browser, um Ihre App zu sehen.