Готовый к продакшену Medusa DTC Starter

Готовый к продакшену Medusa DTC Starter

от Gorgo

Документация | Демо | Сайт

Готовый к продакшену стартер Medusa для DTC-магазинов: бэкенд Medusa и витрина на Next.js с конверсионным оформлением заказа, 36 языками, 241 страной, транзакционными письмами, SEO с эндпоинтом llms.txt и интеграциями, которые вы настраиваете прямо в панели администратора Medusa.

Возможности

Все возможности официального DTC-стартера Medusa плюс:

• Конверсионное оформление заказа: Шаги оформления реализованы как модальные окна, которые упрощают процесс покупки, а итоги корзины и поле промокода всё время на виду. За основу взят подход Яндекс KIT, платформы Яндекса для запуска интернет-магазинов. Убрать или добавить любое поле не составит труда.

• Автозаполнение адреса: Поле адреса подсказывает варианты по мере ввода, а после выбора подсказки индекс, город и регион заполняются автоматически. Покупатель в любой момент может отметить «Ввести адрес вручную» и заполнить поля сам. Используйте встроенный сервис DaData или подключите свой, как описано в руководстве Настройка автозаполнения адреса.

• Полная поддержка i18n: 36 языков с поддержкой RTL и 241 страна по умолчанию. Добавляйте свои регионы или убирайте лишние прямо в файлах данных сид-скрипта. Про их формат и валюты читайте в руководстве Настройка начальных данных.

• Поиск по каталогу: Быстрый и удобный поиск по товарам и категориям на базе Store API. Вы можете подключить свой поисковый движок, например Meilisearch.

• Каталог с фильтрами: Фильтры по опциям товаров, сортировка по новизне и цене, боковая панель с категориями и подкатегориями, а на мобильных фильтры открываются в панели снизу. Выбранные фильтры остаются в адресе страницы, поэтому ссылкой на подборку можно поделиться. За основу взят каталог магазина брендовой одежды 12 STOREEZ.

• Транзакционные письма: Собственный SMTP-провайдер уведомлений отправляет письма по шаблонам React Email с помощью пакета nodemailer. Семь подписчиков реагируют на события customer.created, auth.password_reset, order.placed, order.completed, order.fulfillment_created, order.transfer_requested и payment.captured. Смотрите шаблоны писем на GitHub.

• Ревалидация кэша по запросу: При изменении товара, категории, коллекции или перевода подписчик бэкенда отправляет вебхук на витрину, и витрина сбрасывает кэш именно тех страниц, которых это касается. Смотрите код подписчика на GitHub.

• Модуль интеграций: Администратор магазина настраивает провайдеров платежей, доставок и других сервисов прямо в приложении Medusa Admin, не редактируя конфигурационные файлы и не выполняя повторное развёртывание магазина. Конфиденциальные значения шифруются, а настройки проверяются перед применением.

• SEO и AI-оптимизация: sitemap.xml, robots.txt и hreflang-альтернативы генерируются автоматически, мета-теги Open Graph и Twitter Card настраиваются для каждой страницы, а также есть эндпоинт llms.txt для AI-краулеров.

Начало работы

Одна команда разворачивает проект, выполняет миграции, создаёт администратора и заполняет базу регионами, локалями и демо-каталогом:

npx create-medusa-app@latest --repo-url https://github.com/gorgojs/medusa-dtc-starter

Дальше запустите бэкенд, скопируйте publishable-ключ API из раздела Settings → Publishable API Keys панели администратора в .env.local витрины и поднимите витрину на http://localhost:8000. Про установку вручную и разбор типичных проблем читайте в руководстве Начало работы с Medusa DTC Starter.

Поддержка и сообщество

Есть вопросы по стартеру? Пишите в чат поддержки в Telegram: @gorgojs_chat

Общайтесь с другими разработчиками Medusa в Telegram: @medusajs_chat