mirror of
https://github.com/fromchat-messenger/web.git
synced 2026-09-22 11:05:05 +03:00
43 lines
2.8 KiB
Markdown
43 lines
2.8 KiB
Markdown
# Гайд по работе с проектом
|
||
|
||
## Важные моменты
|
||
- Для работы с проектом нужна 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 от имени администратора и выполните команду:
|
||
```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) и выполните команду:
|
||
|
||
```bash
|
||
# Установка 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. |