queering the map

지도를 퀴어링하기

Queering the Map은 개인이 자신의 퀴어 경험과 이야기를 세계 지도의 특정 위치에 익명으로 고정하는 커뮤니티 기반 플랫폼입니다.

설정

프로젝트 설정에는 두 가지 옵션이 있습니다. 프런트엔드 전용 작업을 위한 빠른 설정과 Supabase를 사용한 전체 설정입니다.

옵션 1: 프런트엔드 전용 작업을 위한 빠른 설정

이 접근 방식은 더 빠르며 Supabase를 설정하지 않고도 프런트엔드에서 작업할 수 있습니다. 이 옵션을 선택하면 팝업에 텍스트가 표시되지 않습니다.

1. npm ci 사용하여 종속성을 설치합니다.
2. 모의 데이터를 생성하려면 시드 스크립트를 실행하세요. npm run seed-data .
3. .env.example .env 에 복사합니다: cp .env.example .env .

옵션 2: Supabase를 사용한 전체 설정

백엔드에서도 작업하려면 이 접근 방식이 필요합니다. 설정하는 데 시간이 더 걸리지만 프로덕션에서 사용하는 것과 일치하는 완전한 개발 환경을 제공합니다.

1. npm install 로 종속성을 설치합니다.
2. 공식 CLI를 사용하여 Supabase(로컬) 프로젝트를 설정합니다.
3. 환경 변수를 설정합니다.
   1. .env.example 파일을 .env 에 복사합니다(수동으로 또는 cp .env.example .env 사용).
   2. supabase start 출력에서 SUPABASE_URL 및 SUPABASE_ANON_KEY 가져옵니다.
4. supabase db reset 사용하여 로컬로 DB 마이그레이션을 실행합니다.
5. Supabase에서 데이터를 가져옵니다. npm run fetch-data .

개발 중

개발 서버를 시작하려면:

npm run dev

테스트

데이터베이스를 테스트하려면 postgres에서 pgTap 확장이 활성화되어 있는지 확인하세요(추가 정보). 그런 다음 다음을 실행할 수 있습니다: supabase test db .

프로덕션을 위한 배포 및 빌드

Supabase를 원격 백엔드로 사용하려면 로컬 개발을 원격 Supabase 프로젝트와 연결해야 합니다.

1. Supabase 계정이 있는지 확인하고 이를 supabase cli에 연결하십시오: supabase login
2. 특정 원격 프로젝트 링크 supabase link --project-ref <project-ref> (추가 정보)
3. 원격 DB supabase db push 에서 마이그레이션 실행(추가 정보)
4. 환경 변수 SUPABASE_URL 및 SUPABASE_ANON_KEY 가 로컬 컨테이너가 아닌 올바른 프로덕션 프로젝트를 가리키는지 확인하세요. Supabase 프로젝트 대시보드 내부에서 해당 항목을 가져올 수 있습니다.

앱의 프로덕션 버전을 생성하려면:

npm run build

보안 문자 보호 설정

포인트 제출의 보안 문자 보호를 위해 Cloudflare Turnstile을 사용합니다. 거기에 위젯을 생성한 후 env 변수에 대한 올바른 값을 채웁니다.

PUBLIC_CLOUDFLARE_TURNSTILE_SITE_KEY
CLOUDFLARE_TURNSTILE_SECRET

자세한 내용은 이 가이드(https://developers.cloudflare.com/turnstile/get-started/)를 참조하세요.