web/SETUP.md

Гайд по работе с проектом

Важные моменты

• Для работы с проектом нужна Windows 10/11.
• Нужно открывать именно Windows PowerShell, НЕ Windows PowerShell ISE. Если видны варианты с x86 и x64, выбирайте x64.
• Если VS Code предупредит вас о том, что у вас WSL 2, закройте VS Code и выполните команду в PowerShell: wsl --set-version Ubuntu 2

1. Установка WSL

1. Откройте PowerShell от имени администратора и выполните команду:

   dism.exe /online /enable-feature /all /featurename:Microsoft-Windows-Subsystem-For-Linux /featurename:VirtualMachinePlatform
   

   Если не заработает, пропускайте этот шаг.

2. Перезагрузите компьютер.

3. Снова откройте PowerShell от имени администратора и выполните wsl --install -d Ubuntu. После установки создайте имя пользователя и пароль для своей Linux-системы.

2. Настройка VS Code

1. Запустите VS Code.
2. Перейдите в Extensions (значок кубиков слева) и установите расширение Remote - WSL или просто WSL. Расширение должно быть от Microsoft.
3. Нажмите на синюю кнопку в нижнем левом углу и нажмите Connect to WSL.

3. Настройка среды

1. В VS Code нажмите Ctrl+Shift+P и введите Git: Clone Repository. Введите URL репозитория. В диалоге выбора папки введите /home/<ваше имя пользователя в WSL>.

2. Откройте терминал (Terminal > New Terminal) и выполните команду:

   # Установка Python и Node.js
   sudo apt update 
   sudo apt install nodejs npm python3 python3-pip python3.12-venv
   # Установка nvm
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
   # Установка Node.js 24
   nvm install 24
   nvm use 24
   # Установка зависимостей npm
   npm install
   

4. Работа с проектом

Чтобы запустить проект, выполните npm run dev или нажмите Ctrl+Shift+B. Проект запустится по адресу http://localhost:8301.