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. Настройте проект Supabase (локальный) с помощью официального интерфейса командной строки.
3. Установите переменные среды.
   1. Скопируйте файл .env.example в .env (вручную или с помощью cp .env.example .env ).
   2. Получите SUPABASE_URL и SUPABASE_ANON_KEY из выходных данных команды supabase start .
4. Запустите миграцию БД локально с помощью supabase db reset .
5. Получите данные из Supabase: npm run fetch-data .

Разработка

Чтобы запустить сервер разработки:

npm run dev

Тестирование

Для тестирования базы данных убедитесь, что в postgres включено расширение pgTap (подробнее). После этого вы можете запустить: supabase test db .

Развертывание и сборка для производства

Чтобы использовать Supabase в качестве удаленного бэкэнда, обязательно свяжите свою локальную разработку с удаленным проектом Supabase:

1. Убедитесь, что у вас есть учетная запись Supabase, и подключите ее к интерфейсу supabase: supabase login
2. Связать конкретную supabase link --project-ref <project-ref> (подробнее)
3. Запуск миграции при удаленной БД supabase db push (подробнее)
4. Убедитесь, что переменные окружения SUPABASE_URL и SUPABASE_ANON_KEY указывают на правильный производственный проект, а не на локальные контейнеры. Вы можете получить их из панели управления вашего проекта Supabase.

Чтобы создать производственную версию приложения:

npm run build

Настройте защиту с помощью капчи

Для защиты Captcha отправленных баллов мы используем Cloudflare Turnstile. После того, как вы создадите там виджет, заполните правильные значения для переменных env:

PUBLIC_CLOUDFLARE_TURNSTILE_SITE_KEY
CLOUDFLARE_TURNSTILE_SECRET

Дополнительную информацию см. в этом руководстве: https://developers.cloudflare.com/turnstile/get-started/.