← Cloudflare Pages / pages / framework-guides

React

React ↗ это популярный фреймворк для создания реактивных и мощных фронтенд-приложений, разработанный командой open source в Facebook.

В этом руководстве вы создадите новое приложение React и развернете его с помощью Cloudflare Pages.

Настройка нового проекта

Используйте create-cloudflare ↗ CLI (C3) для настройки нового проекта. C3 создаст каталог нового проекта, запустит официальный инструмент настройки React и предложит возможность мгновенного развертывания.

Чтобы использовать create-cloudflare чтобы создать новый проект React, выполните следующую команду:

npm create cloudflare@latest -- my-react-app --framework=react --platform=pages

create-cloudflare установит зависимости, включая Wrangler CLI и адаптер Cloudflare Pages, а затем задаст вопросы по настройке.

Перейдите в каталог приложения:

cd my-react-app

Отсюда можно запустить приложение с помощью:

npm run dev

Прежде чем продолжить

Все руководства по фреймворкам предполагают, что у вас уже есть базовое понимание Git ↗. Если вы новичок в Git, обратитесь к этому краткое руководство по Git ↗ о том, как настроить Git на локальном компьютере.

Если вы клонируете по SSH, необходимо сгенерировать ключи SSH ↗ на каждом компьютере, с которого вы отправляете или получаете данные из GitHub.

См. документация GitHub ↗ и Документация Git ↗, где это описано подробнее.

Создайте репозиторий GitHub

Создайте новый репозиторий GitHub, перейдя по адресу repo.new ↗. После создания нового репозитория перейдите в каталог только что созданного проекта, чтобы подготовить локальное приложение и отправить его в GitHub, выполнив в терминале следующие команды:

git remote add origin https://github.com/<your-gh-username>/<repository-name>
git branch -M main
git push -u origin main

Развернуть с помощью Cloudflare Pages

Развернуть через `create-cloudflare` CLI (C3)

Если вы используете create-cloudflare(C3) ↗ чтобы создать новый проект React: C3 установит все зависимости, необходимые проекту, и предложит развернуть его через CLI. Если вы согласитесь, сайт станет доступен в сети, и вы получите URL-адрес развертывания.

Развернуть через панель управления Cloudflare

На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.
Перейдите в Workers & Pages ↗
Выберите Создать приложение > Pages > Импорт существующего репозитория Git.
Выберите созданный вами новый репозиторий GitHub и в разделе Настройка сборок и деплоев раздел и укажите следующую информацию:

Параметр конфигурации	Значение
Продакшен-ветка	`main`
Команда сборки	`npm run build`
Директория сборки	`dist`

После настройки сайта вы можете запустить первый деплой. Вы увидите, как Cloudflare Pages устанавливает react, зависимостей вашего проекта и сборку сайта, прежде чем развернуть его.

После деплоя сайта вы получите уникальный поддомен для своего проекта на *.pages.dev. Каждый раз, когда вы фиксируете новый код в своем приложении React, Cloudflare Pages автоматически пересоберет ваш проект и развернет его. Вы также получите доступ к развёртывания предпросмотра для новых pull request, чтобы вы могли увидеть, как изменения выглядят на сайте, прежде чем разворачивать их в продакшен.

Подробнее

После выполнения этого руководства вы успешно развернули свой сайт на React на Cloudflare Pages. Чтобы начать работу с другими фреймворками, обратитесь к списку руководств по фреймворкам.