Портфолио программиста: что включить, как оформить GitHub и показать проекты

Начинающий разработчик за столом просматривает свои проекты на ноутбуке, код на экране размыт Собеседования и резюме

Портфолио программиста без опыта работы составляют два-три своих проекта, которые запускаются, лежат в открытых репозиториях на GitHub и описаны в README. Отдельный сайт-портфолио для этого не обязателен. Ссылки на проекты ставят в резюме, а про каждый нужно уметь рассказать на собеседовании.

Что о портфолио пишут в вакансиях без опыта

8 октября 2026 года мы открыли все 304 вакансии без опыта в роли «Программист, разработчик» по России на hh.ru. Портфолио, пет-проекты (собственные программы, сделанные не по заказу), учебные работы или ссылку на GitHub кандидата упоминают 36 из них, примерно каждая восьмая. Восемь из них повторяют одно объявление компании о стажировке на JavaScript и React, в требованиях там «наличие учебных/тестовых проектов в портфолио». В стажировке на фронтенд в другой компании написано: «В случае своих pet проектов необходимы ссылки на github». В других вакансиях это пожелание: «Плюс если есть 1–2 учебных/pet-проекта», «Что будет плюсом: профиль с проектами на GitHub».

В выборке SQL или базы данных встречаются в 116 вакансиях из 304, Git, GitHub или GitLab в 87, API или REST в 68, Docker в 32. Иногда о портфолио спрашивают прямо в отклике. В одной стажировке в сопроводительном письме просят ответить: «Есть ли опыт учебных или личных проектов?». В вакансии junior-разработчика среди вопросов к отклику стоит: «Есть ли GitHub, pet-project или примеры реализованных проектов».

Из чего состоит портфолио программиста

Часть портфолио Где лежит Что в ней
Профиль GitHub имя, фото, пара строк о себе, контакты, закреплённые работы
Проекты публичные репозитории код, README, история коммитов, тесты
Демо GitHub Pages, свой хостинг или видео то, что можно открыть без установки
Резюме файл и профиль на сайте вакансий ссылки на профиль и на две-три главные работы

Обязательны в портфолио профиль и проекты. Демо нужно, если у программы есть интерфейс: веб-страница или мобильное приложение. Серверному сервису хватит инструкции запуска и примеров запросов.

Какие проекты взять в портфолио

Два-три законченных проекта лучше десятка начатых. Учебные работы с курсов брать можно, но у всего потока они сделаны по одному заданию. Доработайте свою версию: добавьте функцию, которой не было в задании, тесты, запуск через Docker. Выбирайте проект под требования вакансий своего направления. Например, если в вакансиях просят SQL, храните данные в базе.

Направление Пример работы для портфолио Какие навыки видны
Бэкенд (Python, Java, Go, PHP) сервис записи к мастеру или учёта расходов с REST API и базой данных SQL, обработка ошибок, тесты, Docker
Фронтенд приложение на данных из открытого API: погода, расписание, каталог работа с API, состояния загрузки и ошибки, вид на телефоне
Мобильная разработка приложение с локальным хранением и синхронизацией с сервером архитектура экранов, работа без сети
Аналитика данных разбор открытого набора данных с выводами SQL, Python, графики
Автоматизация Telegram-бот с напоминаниями или отчётом работа с API, расписание, хранение данных
Читайте также:  Собеседование на аналитика: этапы, вопросы и задачи для аналитика данных, системного и бизнес-аналитика

Тестовое задание после отказа остаётся вашей работой: его можно доработать и выложить в портфолио. Многие открытые проекты помечают задачи для новичков меткой good first issue: ищите задачи с этой меткой в репозиториях библиотек, которыми пользуетесь.

Как оформить GitHub для портфолио

Профиль разработчика на мониторе: аватар, блоки закреплённых репозиториев и график активности, всё размыто

Профиль и закреплённые проекты

В профиле можно закрепить до шести репозиториев и gist’ов вместе. Закрепить можно публичный репозиторий, который принадлежит вам или в который вы делали вклад за последний год. Закрепите две-три лучшие работы и не закрепляйте упражнения с курсов.

Короткий текст над ними даёт профильный README. Чтобы его создать, заведите репозиторий с тем же именем, что и ваш логин. README появится на странице профиля, если этот репозиторий публичный, в его корне лежит файл README.md и в файле есть текст. Хватит трёх-пяти строк: кто вы, какой стек и уровень, какую работу ищете, как связаться. Вместо ряда значков технологий напишите строку вроде «ищу стажировку Python-разработчиком, Москва или удалённо».

README проекта

README первым читают, когда кто-то заходит в репозиторий из вашего портфолио. Опишите в нём:

  1. Что делает программа и для кого она.
  2. Как её запустить: команды по шагам, нужные версии, пример файла настроек без настоящих паролей.
  3. Стек: язык, фреймворк, база данных.
  4. Скриншот или ссылку на работающую версию.
  5. Что было сложным и что вы бы сделали иначе.

Проверить описание лучше на знакомом: пусть скачает репозиторий и запустит программу по вашей инструкции, не задавая вопросов. Если не получилось, поправьте инструкцию до того, как ставить ссылку в резюме.

Коммиты и история

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

По истории коммитов видно, как шла работа. Если всё загружено одним коммитом «initial», этого не видно. Делайте коммит на каждое законченное изменение и пишите, что изменилось: «добавил фильтр по дате», а не «upd» сорок раз подряд.

График активности в профиле учитывает коммит, если почта, с которой он сделан, привязана к вашему аккаунту, коммит сделан не в форке и лежит в ветке по умолчанию или в gh-pages. Если график пустой, а изменения есть, обратите внимание на почту: выполните в папке проекта git config user.email. Команда печатает, какую почту Git ставит автором коммита. Если она ничего не печатает, почта не задана. Если адрес есть, но в аккаунте его нет, добавьте этот адрес в настройки аккаунта или смените почту в Git на уже привязанную. Активность в закрытых репозиториях по умолчанию в график не идёт. Её можно включить, детали при этом скрыты.

Читайте также:  Резюме программиста: как составить, образец для junior и middle

Пароли, токены и файлы .env в публичный репозиторий не кладите: его видят все, вместе с историей старых коммитов.

Код с работы и проекты под NDA

Исключительное право на программу, написанную в пределах трудовых обязанностей, по ГК РФ принадлежит работодателю, если договор не говорит иное. Авторство при этом остаётся за автором. Программы охраняются как литературные произведения, исходный код тоже. Поэтому рабочий код без разрешения в открытое портфолио не выкладывают. Опишите такую работу в резюме словами: задача, ваша часть, технологии. Если подписывали соглашение о неразглашении, сверьте с ним и описание.

Нужен ли сайт-портфолио программисту

Бэкенд-разработчику и аналитику отдельный сайт не обязателен: смотреть будут код. У фронтендера сайт-портфолио сам становится проектом: сделайте его на своём стеке и проверьте вид на телефоне. Сайт на конструкторе ничего не добавляет к портфолио программиста: по нему не видно, как вы пишете код.

Сайт-портфолио открыт на ноутбуке и на телефоне рядом, карточки проектов размыты

Статический сайт на HTML, CSS и JavaScript можно бесплатно разместить на GitHub Pages. Сайт пользователя лежит в репозитории <логин>.github.io и открывается по адресу https://<логин>.github.io. На бесплатном тарифе репозиторий для сайта должен быть публичным. Для всех сайтов на GitHub Pages действуют общие ограничения: размер до 1 ГБ, мягкий лимит трафика 100 ГБ в месяц, интернет-магазин или платный сервис там держать нельзя. На сайте хватит имени и стека, трёх карточек работ со ссылками на код и демо и контактов.

Портфолио программиста 1С

Рабочие доработки 1С подпадают под те же правила о служебных программах, поэтому портфолио собирают из других частей. В стажёрской вакансии 1С из нашей выборки плюсом названы «Любой практический опыт с 1С, сертификаты 1С, курсы/кейсы, пет-проекты». Сертификаты 1С лучше поставить в резюме и в портфолио, а рабочие задачи описать как кейсы: что автоматизировали и какой получили результат. В другой стажировке 1С в стеке указаны EDT, Git, GitLab и merge requests, так что учебная конфигурация в Git заодно покажет, что вы умеете с ним работать.

Пример портфолио программиста

Пример вымышленный: так могло бы выглядеть портфолио джуна на Python, который ищет первую работу.

Часть Содержание
Профильный README «Python-разработчик, ищу стажировку или junior. FastAPI, PostgreSQL, Docker. Контакты ниже»
Проект 1 сервис записи в автосервис: REST API, авторизация по токену, тесты на pytest, запуск через Docker Compose
Проект 2 Telegram-бот для учёта расходов: напоминания по расписанию, отчёт за месяц, данные в PostgreSQL
Проект 3 разбор открытых данных о поездках такси в Jupyter Notebook: SQL-запросы и графики
Закреплено три проекта выше, упражнения курса не закреплены

Как показать портфолио в резюме и на собеседовании

Кандидат показывает интервьюеру свой проект на ноутбуке в переговорной, код на экране размыт

В резюме ссылка на профиль стоит в контактах, а проекты идут отдельным блоком на месте опыта работы: название, ссылка, стек и одна-две строки о том, что делает программа. На hh.ru кандидату без опыта ссылки лучше писать в разделе «О себе»: раздел «Портфолио» там рассчитан на картинки. Подробнее о структуре читайте в статье про резюме программиста. Перед откликом откройте каждую ссылку в браузере без входа в аккаунт: закрытую страницу посторонний не откроет.

Читайте также:  Собеседование на аналитика: этапы, вопросы и задачи для аналитика данных, системного и бизнес-аналитика

В сопроводительном письме дайте ссылку на одну работу, которая ближе всего к вакансии, и одной фразой скажите, чем она похожа на задачи компании.

К собеседованию подготовьте рассказ о каждой работе из портфолио на две-три минуты: какую задачу решает программа, почему выбрали такое решение и такой стек, какая проблема оказалась самой сложной, что бы вы переделали. Пройдите по своему коду, как будто объясняете его другому человеку: каждый файл, каждую подключённую библиотеку. Если при написании использовали нейросеть, разберите её часть построчно. Портфолио, которое вы не можете объяснить, работает против вас, об этом мы писали в статье о том, заменит ли ИИ программистов.

Ошибки, из-за которых портфолио не работает

  • Программа просит ключ API или пароль, которого нет в примере файла настроек, и у проверяющего она не запустится.
  • Портфолио давно не обновлялось: среди закреплённых учебные задачи, а новых проектов нет.
  • Закреплённый проект перестал собираться после последних коммитов, и сборку так и не починили.

Частые вопросы

Сколько проектов нужно в портфолио программиста?

Два-три законченных. Прежде чем начинать третий, доведите первые два до рабочей версии с README. Как выстроить учёбу до первых работ, описано в плане как стать программистом с нуля.

Можно ли показывать учебные работы с курсов?

Можно: в восьми объявлениях одной компании о стажировке прямо стоит «наличие учебных/тестовых проектов в портфолио». Но такое же задание есть у всего потока, поэтому добавьте в свою версию то, чего не было в задании, и напишите в README, что сделали сами.

GitHub или GitLab?

В нескольких вакансиях из выборки прямо написано «ссылка на GitHub / GitLab» или «GitHub/GitLab». Закрепление, профильный README и GitHub Pages выше описаны для GitHub, у GitLab свои настройки. Код, который уже лежит на GitLab, переносить ради портфолио не обязательно.

Что положить в портфолио фронтенд-разработчику?

Работающие страницы по ссылке и их код. Проект с настоящим API, обработкой ошибок и аккуратным видом на телефоне ценнее пяти одинаковых лендингов. Что ещё ждут от джуна на фронтенде, разобрано в статье про фронтенд-разработчика.

Можно ли взять в портфолио заказ с фриланса?

Да, если по договору права на код остались у вас или заказчик разрешил его показать. Если нет, опишите работу словами и приложите скриншот без данных заказчика, если договор это не запрещает. Как оформлять такие заказы, мы разбирали в статье про фриланс для программиста.

Оцените статью
Блог о программировании
Добавить комментарий