queering the map

Interroger la carte

Queering the Map est une plateforme communautaire où des individus épinglent de manière anonyme leurs expériences et histoires queer à des endroits spécifiques sur une carte mondiale.

Installation

Vous disposez de deux options pour configurer le projet : une configuration rapide pour un travail frontend uniquement ou une configuration complète avec Supabase.

Option 1 : configuration rapide pour le travail front-end uniquement

Cette approche est plus rapide et vous permet de travailler sur le frontend sans configurer Supabase. Notez que les fenêtres contextuelles n'afficheront pas de texte si vous choisissez cette option.

1. Installez les dépendances avec npm ci .
2. Exécutez le script seed pour générer des données fictives : npm run seed-data .
3. Copiez .env.example dans .env : cp .env.example .env .

Option 2 : installation complète avec Supabase

Cette approche est nécessaire si vous souhaitez travailler également sur le backend. La mise en place prend plus de temps mais fournit un environnement de développement complet, aligné sur ce que nous utilisons en production.

1. Installez les dépendances avec npm install .
2. Configurez un projet Supabase (local) avec la CLI officielle.
3. Définissez les variables d'environnement.
   1. Copiez le fichier .env.example dans .env (manuellement ou avec cp .env.example .env ).
   2. Obtenez votre SUPABASE_URL et SUPABASE_ANON_KEY à partir de la sortie de supabase start .
4. Exécutez les migrations de base de données localement avec supabase db reset .
5. Récupérez les données depuis Supabase : npm run fetch-data .

Développement

Pour démarrer un serveur de développement :

npm run dev

Essai

Pour tester la base de données, assurez-vous que l'extension pgTap est activée dans postgres (plus d'informations). Ensuite, vous pouvez exécuter : supabase test db .

Déploiement et construction pour la production

Pour utiliser Supabase comme backend distant, assurez-vous de lier votre développement local à votre projet Supabase distant :

1. Assurez-vous d'avoir un compte Supabase et connectez-le à la cli supabase : supabase login
2. Lier un supabase link --project-ref <project-ref> (plus d'informations)
3. Exécuter des migrations sur une base de données supabase db push (plus d'informations)
4. Assurez-vous que les variables d'environnement SUPABASE_URL et SUPABASE_ANON_KEY pointent vers le bon projet de production et non vers les conteneurs locaux. Vous pouvez les récupérer depuis le tableau de bord de votre projet Supabase.

Pour créer une version de production de l'application :

npm run build

Configurer la protection Captcha

Pour la protection Captcha des soumissions de points, nous utilisons Cloudflare Turnstile. Une fois que vous avez créé un widget, remplissez les valeurs correctes pour les variables d'environnement :

PUBLIC_CLOUDFLARE_TURNSTILE_SITE_KEY
CLOUDFLARE_TURNSTILE_SECRET

Pour plus d'informations, consultez ce guide : https://developers.cloudflare.com/turnstile/get-started/.