queering the map

Mengantri Peta

Queering the Map adalah platform berbasis komunitas tempat individu secara anonim menyematkan pengalaman dan cerita queer mereka ke lokasi tertentu di peta global.

Pengaturan

Anda memiliki dua opsi untuk menyiapkan proyek: penyiapan cepat untuk pekerjaan frontend saja atau penyiapan penuh dengan Supabase.

Opsi 1: Pengaturan Cepat untuk Pekerjaan Frontend Saja

Pendekatan ini lebih cepat dan memungkinkan Anda bekerja di frontend tanpa menyiapkan Supabase. Perhatikan bahwa popup tidak akan menampilkan teks jika Anda memilih opsi ini.

1. Instal dependensi dengan npm ci .
2. Jalankan skrip seed untuk menghasilkan data tiruan: npm run seed-data .
3. Salin .env.example ke .env : cp .env.example .env .

Opsi 2: Pengaturan Penuh dengan Supabase

Pendekatan ini diperlukan jika Anda ingin bekerja juga di backend. Penyiapannya membutuhkan waktu lebih lama, namun menyediakan lingkungan pengembangan yang lengkap, selaras dengan apa yang kami gunakan dalam produksi.

1. Instal dependensi dengan npm install .
2. Siapkan proyek Supabase (lokal) dengan CLI resmi.
3. Tetapkan variabel lingkungan.
   1. Salin file .env.example ke .env (secara manual atau dengan cp .env.example .env ).
   2. Dapatkan SUPABASE_URL dan SUPABASE_ANON_KEY Anda dari keluaran supabase start .
4. Jalankan migrasi DB secara lokal dengan supabase db reset .
5. Ambil data dari Supabase: npm run fetch-data .

Berkembang

Untuk memulai server pengembangan:

npm run dev

Pengujian

Untuk menguji database pastikan ekstensi pgTap diaktifkan di postgres (info lebih lanjut). Setelah itu, Anda dapat menjalankan: supabase test db .

Menyebarkan dan Membangun untuk produksi

Untuk menggunakan Supabase sebagai backend jarak jauh, pastikan untuk menghubungkan pengembangan lokal Anda dengan proyek Supabase jarak jauh Anda:

1. Pastikan Anda memiliki akun Supabase dan sambungkan ke cli supabase: supabase login
2. Tautkan supabase link --project-ref <project-ref> (info lebih lanjut)
3. Jalankan migrasi pada DB supabase db push jarak jauh (info lebih lanjut)
4. Pastikan env vars SUPABASE_URL dan SUPABASE_ANON_KEY mengarah ke proyek produksi yang benar dan bukan container lokal. Anda dapat mengambilnya dari dalam dasbor proyek Supabase Anda.

Untuk membuat versi produksi aplikasi:

npm run build

Siapkan Perlindungan Captcha

Untuk perlindungan Captcha pada pengiriman poin, kami menggunakan Cloudflare Turnstile. Setelah Anda membuat widget di sana, isi nilai yang benar untuk variabel env:

PUBLIC_CLOUDFLARE_TURNSTILE_SITE_KEY
CLOUDFLARE_TURNSTILE_SECRET

Untuk info lebih lanjut, lihat panduan ini: https://developers.cloudflare.com/turnstile/get-started/.