{"id":20545276,"url":"https://github.com/yuriipohorilets/parcel-template","last_synced_at":"2026-03-08T19:39:05.777Z","repository":{"id":122536238,"uuid":"527137458","full_name":"YuriiPohorilets/parcel-template","owner":"YuriiPohorilets","description":"📦 Parcel template v2.0","archived":false,"fork":false,"pushed_at":"2022-10-06T11:30:42.000Z","size":1269,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-16T15:49:28.429Z","etag":null,"topics":["parcel"],"latest_commit_sha":null,"homepage":"https://yuriipohorilets.github.io/parcel-template/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/YuriiPohorilets.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-21T07:36:40.000Z","updated_at":"2022-10-06T11:29:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"2491ad76-e98c-4647-952d-7f550dbed5af","html_url":"https://github.com/YuriiPohorilets/parcel-template","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriiPohorilets%2Fparcel-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriiPohorilets%2Fparcel-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriiPohorilets%2Fparcel-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriiPohorilets%2Fparcel-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YuriiPohorilets","download_url":"https://codeload.github.com/YuriiPohorilets/parcel-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242150807,"owners_count":20080006,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["parcel"],"created_at":"2024-11-16T01:51:16.798Z","updated_at":"2026-03-08T19:39:05.751Z","avatar_url":"https://github.com/YuriiPohorilets.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"**Read in other languages: [Русский](README.md), [Polski](README.pl.md).**\n\n# Parcel template | v2.0\n\nЭтот проект был создан при помощи Parcel. Для знакомства и настройки\nдополнительных возможностей [обратись к документации](https://parceljs.org/).\n\n## Подготовка нового проекта\n\n1. Убедись что на компьютере установлена LTS-версия Node.js.\n   [Скачай и установи](https://nodejs.org/en/) её если необходимо.\n2. Склонируй этот репозиторий.\n3. Измени имя папки с `parcel-project-template` на имя своего проекта.\n4. Создай новый пустой репозиторий на GitHub.\n5. Открой проект в VSCode, запусти терминал и свяжи проект с GitHub-репозиторием\n   [по инструкции](https://docs.github.com/en/get-started/getting-started-with-git/managing-remote-repositories#changing-a-remote-repositorys-url).\n6. Установи зависимости проекта в терминале командой `npm install` .\n7. Запусти режим разработки, выполнив команду `npm start`.\n8. Перейди в браузере по адресу [http://localhost:1234](http://localhost:1234).\n   Эта страница будет автоматически перезагружаться после сохранения изменений в\n   файлах проекта.\n\n## Файлы и папки\n\n- Все паршалы файлов стилей должны лежать в папке `src/sass` и импортироваться в\n  файлы стилей страниц. Например, для `index.html` файл стилей называется\n  `index.scss`.\n- Изображения добавляй в папку `src/images`. Сборщик оптимизирует их, но только\n  при деплое продакшн версии проекта. Все это происходит в облаке, чтобы не\n  нагружать твой компьютер, так как на слабых машинах это может занять много\n  времени.\n\n## Деплой\n\nДля настройки деплоя проекта необходимо выполнить несколько дополнительных шагов\nпо настройке твоего репозитория. Зайди во вкладку `Settings` и в подсекции\n`Actions` выбери выбери пункт `General`.\n\n![GitHub actions settings](./assets/actions-config-step-1.png)\n\nПролистай страницу до последней секции, в которой убедись что выбраны опции как\nна следующем изображении и нажми `Save`. Без этих настроек у сборки будет\nнедостаточно прав для автоматизации процесса деплоя.\n\n![GitHub actions settings](./assets/actions-config-step-2.png)\n\nПродакшн версия проекта будет автоматически собираться и деплоиться на GitHub\nPages, в ветку `gh-pages`, каждый раз когда обновляется ветка `main`. Например,\nпосле прямого пуша или принятого пул-реквеста. Для этого необходимо в файле\n`package.json` отредактировать поле `homepage` и скрипт `build`, заменив\n`your_username` и `your_repo_name` на свои, и отправить изменения на GitHub.\n\n```json\n\"homepage\": \"https://your_username.github.io/your_repo_name/\",\n\"scripts\": {\n  \"build\": \"parcel build src/*.html --public-url /your_repo_name/\"\n},\n```\n\nДалее необходимо зайти в настройки GitHub-репозитория (`Settings` \u003e `Pages`) и\nвыставить раздачу продакшн версии файлов из папки `/root` ветки `gh-pages`, если\nэто небыло сделано автоматически.\n\n![GitHub Pages settings](./assets/repo-settings.png)\n\n### Статус деплоя\n\nСтатус деплоя крайнего коммита отображается иконкой возле его идентификатора.\n\n- **Желтый цвет** - выполняется сборка и деплой проекта.\n- **Зеленый цвет** - деплой завершился успешно.\n- **Красный цвет** - во время линтинга, сборки или деплоя произошла ошибка.\n\nБолее детальную информацию о статусе можно посмотреть кликнув по иконке, и в\nвыпадающем окне перейти по ссылке `Details`.\n\n![Deployment status](./assets/status.png)\n\n### Живая страница\n\nЧерез какое-то время, обычно пару минут, живую страницу можно будет посмотреть\nпо адресу указанному в отредактированном свойстве `homepage`. Например, вот\nссылка на живую версию для этого репозитория\n[https://goitacademy.github.io/parcel-project-template](https://goitacademy.github.io/parcel-project-template).\n\nЕсли открывается пустая страница, убедись что во вкладке `Console` нет ошибок\nсвязанных с неправильными путями к CSS и JS файлам проекта (**404**). Скорее\nвсего у тебя неправильное значение свойства `homepage` или скрипта `build` в\nфайле `package.json`.\n\n## Как это работает\n\n![How it works](./assets/how-it-works.png)\n\n1. После каждого пуша в ветку `main` GitHub-репозитория, запускается специальный\n   скрипт (GitHub Action) из файла `.github/workflows/deploy.yml`.\n2. Все файлы репозитория копируются на сервер, где проект инициализируется и\n   проходит сборку перед деплоем.\n3. Если все шаги прошли успешно, собранная продакшн версия файлов проекта\n   отправляется в ветку `gh-pages`. В противном случае, в логе выполнения\n   скрипта будет указано в чем проблема.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuriipohorilets%2Fparcel-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyuriipohorilets%2Fparcel-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyuriipohorilets%2Fparcel-template/lists"}