Skip to content

Dirty-architecture/chat-frontend

Repository files navigation

Запуск React-приложения на Vite

Этот документ описывает, как установить зависимости и запустить React‑приложение, созданное с помощью Vite.

📦 Требования

Перед началом убедитесь, что у вас установлены:

  • Node.js версии 20.x или выше

Проверить версию:

node -v
  • npm (обычно устанавливается вместе с Node.js) или yarn / pnpm

Рекомендуется использовать последнюю LTS‑версию Node.js.

🚀 Установка и запуск

1. Клонирование репозитория

git clone https://github.com/Dirty-architecture/chat-frontend.git
cd only

2. Установка зависимостей

npm install

3. Переменные окружения (ENV)

Проект использует переменные окружения через файл .env в корне репозитория.

  1. Создайте файл .env (если его нет)
  2. Добавьте необходимые переменные

Пример:

VITE_API_URL=http://localhost:4000

4. Запуск приложения в режиме разработки

npm run dev

После запуска в терминале появится адрес, обычно:

http://localhost:5173

Откройте его в браузере — приложение готово к работе 🎉

🛠 Доступные скрипты

  • npm run dev — запуск в режиме разработки
  • npm run build — сборка проекта для продакшена
  • npm run preview — локальный просмотр продакшн‑сборки
  • npm run lint — проверка кода (если настроен ESLint)

⚙️ Сборка проекта

Для сборки оптимизированной версии приложения выполните:

npm run build

Результат будет сохранён в папке dist/.

❗ Возможные проблемы

  • Ошибка версии Node.js — обновите Node.js до LTS‑версии
  • Порт занят — Vite автоматически предложит другой порт
  • Зависимости не устанавливаются — попробуйте удалить node_modules и package-lock.json, затем выполнить npm install

Методология БЭМ (BEM)

В проекте для именования CSS‑классов используется методология БЭМ (Block — Element — Modifier). Это помогает поддерживать единый стиль, улучшает читаемость стилей и упрощает масштабирование интерфейса.

Правила именования

  • Блок — независимая сущность интерфейса: block
  • Элемент — часть блока, не существует отдельно: block-element
  • Модификатор — состояние/вариация блока или элемента: block__modifier или block-element__modifier

Полезные ссылки

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors