queering the map

Queering der Karte

Queering the Map ist eine Community-basierte Plattform, auf der Einzelpersonen ihre queeren Erfahrungen und Geschichten anonym an bestimmte Orte auf einer globalen Karte anheften.

Aufstellen

Sie haben zwei Möglichkeiten, das Projekt einzurichten: eine schnelle Einrichtung für reine Frontend-Arbeiten oder eine vollständige Einrichtung mit Supabase.

Option 1: Schnelle Einrichtung für reine Frontend-Arbeit

Dieser Ansatz ist schneller und ermöglicht Ihnen die Arbeit am Frontend, ohne Supabase einzurichten. Beachten Sie, dass Popups keinen Text anzeigen, wenn Sie diese Option wählen.

1. Installieren Sie Abhängigkeiten mit npm ci .
2. Führen Sie das Seed-Skript aus, um Scheindaten zu generieren: npm run seed-data .
3. Kopieren Sie .env.example nach .env : cp .env.example .env .

Option 2: Vollständiges Setup mit Supabase

Dieser Ansatz ist notwendig, wenn Sie auch am Backend arbeiten möchten. Die Einrichtung dauert länger, bietet aber eine vollständige Entwicklungsumgebung, die auf das abgestimmt ist, was wir in der Produktion verwenden.

1. Installieren Sie Abhängigkeiten mit npm install .
2. Richten Sie ein Supabase-Projekt (lokal) mit der offiziellen CLI ein.
3. Legen Sie die Umgebungsvariablen fest.
   1. Kopieren Sie die Datei .env.example nach .env (manuell oder mit cp .env.example .env ).
   2. Holen Sie sich Ihre SUPABASE_URL und SUPABASE_ANON_KEY aus der Ausgabe von supabase start .
4. Führen Sie die DB-Migrationen lokal mit supabase db reset aus.
5. Rufen Sie die Daten von Supabase ab: npm run fetch-data .

Entwicklung

So starten Sie einen Entwicklungsserver:

npm run dev

Testen

Stellen Sie zum Testen der Datenbank sicher, dass die pgTap Erweiterung in Postgres aktiviert ist (weitere Informationen). Anschließend können Sie Folgendes ausführen: supabase test db .

Bereitstellen und Erstellen für die Produktion

Um Supabase als Remote-Backend zu verwenden, stellen Sie sicher, dass Sie Ihre lokale Entwicklung mit Ihrem Remote-Supabase-Projekt verknüpfen:

1. Stellen Sie sicher, dass Sie über ein Supabase-Konto verfügen und verbinden Sie es mit der Supabase-CLI: supabase login
2. Verknüpfen Sie ein bestimmtes Remote-Projekt supabase link --project-ref <project-ref> (weitere Informationen)
3. Führen Sie Migrationen auf Remote-DB- supabase db push aus (weitere Informationen)
4. Stellen Sie sicher, dass die Umgebungsvariablen SUPABASE_URL und SUPABASE_ANON_KEY auf das richtige Produktionsprojekt und nicht auf die lokalen Container verweisen. Sie können sie über das Dashboard Ihres Supabase-Projekts abrufen.

So erstellen Sie eine Produktionsversion der App:

npm run build

Captcha-Schutz einrichten

Für den Captcha-Schutz der Punktübermittlungen verwenden wir Cloudflare Turnstile. Sobald Sie dort ein Widget erstellt haben, geben Sie die korrekten Werte für die Umgebungsvariablen ein:

PUBLIC_CLOUDFLARE_TURNSTILE_SITE_KEY
CLOUDFLARE_TURNSTILE_SECRET

Weitere Informationen finden Sie in diesem Leitfaden: https://developers.cloudflare.com/turnstile/get-started/.