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/。