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在本地運行資料庫遷移。
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. 在遠端資料庫supabase db push上運行遷移（更多資訊）
4. 確保環境變數SUPABASE_URL和SUPABASE_ANON_KEY確實指向正確的生產項目而不是本地容器。您可以從 Supabase 專案的儀表板中取得它們。

要建立應用程式的生產版本：

npm run build

設定驗證碼保護

為了對點提交進行驗證碼保護，我們使用 Cloudflare Turnstile。在那裡創建小部件後，為環境變數填充正確的值：

PUBLIC_CLOUDFLARE_TURNSTILE_SITE_KEY
CLOUDFLARE_TURNSTILE_SECRET

有關更多信息，請參閱本指南：https://developers.cloudflare.com/turnstile/get-started/。