Репозиторий проекта

Каждый проект в GigaStudio автоматически создает репозиторий на GitVerse. Все изменения, которые вносит GigaStudio в ответ на ваши запросы, фиксируются как коммиты от агента.

Чтобы открыть репозиторий из редактора, нажмите ··· в шапке панели чата и выберите Открыть репозиторий.

Структура проекта

Типичный проект GigaStudio — это Next.js-приложение со следующей структурой:

├── public/          # Статические файлы: изображения, шрифты, иконки
├── src/             # Исходный код приложения
├── .gitignore
├── .npmrc
├── components.json
├── next.config.mjs
├── package.json
├── tailwind.config.ts
└── tsconfig.json

Пользовательские файлы — изображения, иконки, медиа — размещаются в папке public/. После добавления файлов вы можете попросить GigaStudio использовать их через чат, например: «Замени фоновое изображение в секции героя на /my-photo.jpg».

Ветки

В репозитории проекта две ветки:

  • dev — рабочая ветка. Все изменения, которые вносит GigaStudio через чат, попадают сюда. Здесь же ведется локальная разработка;
  • master — production-ветка. Обновляется автоматически при публикации проекта через кнопку Публикация в редакторе.

WARNING

Не вносите изменения напрямую в master — они будут перезаписаны при следующей публикации.

Локальная разработка

Локальный запуск дает полный контроль над проектом: вы можете вручную редактировать код, подключать новые библиотеки, добавлять файлы и сразу видеть результат — без ограничений облачного превью. Это удобно, когда нужно внести точечные правки или отладить поведение приложения.

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

  • GigaIDE — IDE от GitVerse на базе IDEA/PyCharm Community;
  • VS Code — легкий универсальный редактор кода.

Аутентификация

Перед клонированием настройте доступ к GitVerse одним из способов:

  • hTTPS — при клонировании Git запросит логин и пароль учетной записи GitVerse. Подробнее — в документации GitVerse;
  • SSH — более удобный вариант для регулярной работы: один раз настраивается ключ, дальше авторизация происходит автоматически. Подробнее — в документации GitVerse.

Клонирование и запуск

  1. Клонируйте ветку dev:

    # HTTPS
git clone -b dev https://gitverse.ru/<username>/<repo>.git
 
# SSH
git clone -b dev git@gitverse.ru:<username>/<repo>.git
 
cd <repo>

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

    npm install --legacy-peer-deps

  3. Запустите проект в режиме разработки:

    npm run dev

Приложение будет доступно по адресу http://localhost:3000.

Остановка проекта

Чтобы остановить сервер, нажмите Ctrl+C в терминале.

Ручные коммиты

Если вы вносите изменения локально, зафиксируйте их и отправьте в репозиторий:

git add .
git commit -m "Описание изменений"
git push origin dev

Всегда пушьте в ветку dev. После того как изменения попали в репозиторий, GigaStudio увидит их при следующем запросе. Вы можете продолжить редактирование через чат.

Добавление файлов в проект

Чтобы добавить в проект собственные файлы — изображения, иконки, документы:

  1. Поместите файлы в папку public/ в корне репозитория.

  2. Сделайте коммит и запушьте изменения:

    git add public/
git commit -m "Добавлены изображения"
git push origin dev

  3. Вернитесь в GigaStudio и попросите использовать файлы через чат, например: «Используй /logo.svg как логотип в шапке сайта».

NOTE

GigaStudio видит файлы из репозитория и может обращаться к ним по пути относительно public/. Файлы из других папок в качестве медиа не поддерживаются.

Вид графа

Связанные страницы