Portfolio i GitHub w CV programisty: które repo pokazać

Wrzucasz do CV link do GitHuba i myślisz, że robota odhaczona. Rekruter ma teraz pełny dostęp do wszystkiego, co zbudowałeś, więc sam sobie znajdzie to, co najlepsze. Tak to nie działa.

Rekruter nie przegląda całego profilu. Otwiera link, rzuca okiem na to, co widać na wierzchu, i klika jedno, najwyżej dwa repozytoria. Jeśli na górze ląduje porzucony tutorial, fork bez jednego commita albo projekt bez README, to właśnie to zobaczy. Twoje najlepsze repo, schowane trzy ekrany niżej, nie istnieje.

Dlatego portfolio na GitHubie to nie „wklej link i licz na najlepsze”. To wybór dwóch, trzech repozytoriów, które pasują do oferty, opisanych tak, żeby dało się je zrozumieć bez czytania kodu. Poniżej masz, które repo pokazać pod konkretne ogłoszenie, jak je opisać i czego lepiej nie linkować w ogóle.

Które repo wybrać pod ofertę

Nie linkuj profilu z myślą „tu jest wszystko”. Wybierz repozytoria pod konkretną rolę, dokładnie tak, jak ustawiasz kolejność projektów w samym CV. Oferta frontendowa chce zobaczyć interfejs, stan i komponenty. Oferta backendowa chce API, bazę i integracje. Te same dwa, trzy projekty, inny zestaw wyeksponowany na wierzchu.

Dobre repo do pokazania ma kilka cech naraz: jest skończone i da się je uruchomić, używa stacku z oferty, a twój wkład jest w nim widoczny. Jeden taki projekt waży więcej niż dziesięć zaczętych. Jeśli aplikujesz na Reacta, na pierwszym planie ma być projekt w Reakcie, nie eksperyment z Vue sprzed roku.

Wykorzystaj to, że GitHub daje ci dźwignie. Przypnij najlepsze repozytoria (pinned repositories), żeby to one były na wierzchu profilu. Rekruter, który wchodzi z linku w CV, ma wtedy od razu zobaczyć właściwe rzeczy, a nie scrollować w poszukiwaniu czegokolwiek sensownego. Jak rozłożyć ofertę na konkretne technologie, pokazujemy w jak wyciągnąć słowa kluczowe z oferty IT.

Jak opisać repo: README, demo, stack, twój wkład

Rekruter, który klika twoje repo, nie zaczyna od czytania kodu. Zaczyna od README. Jeśli widzi tam domyślny tekst wygenerowany przez create-react-app albo pustkę, zamyka kartę. Dobre README odpowiada w pierwszych zdaniach na cztery pytania: co to robi, jak to uruchomić, w czym jest zbudowane i co konkretnie zrobiłeś ty.

Po README liczy się to, czy da się zobaczyć efekt bez stawiania projektu lokalnie. Działające demo albo krótki gif w README robią różnicę, bo rekruter nie sklonuje repozytorium na rozmowie. Jeśli to aplikacja webowa, postaw ją gdzieś i podaj link.

Stack wpisz wprost, nie zostawiaj go do wywnioskowania z package.json. „React, TypeScript, REST API, Vitest” w nagłówku README pozwala rekruterowi od razu zestawić twój projekt z wymaganiami oferty. Na koniec opisz swój wkład, zwłaszcza jeśli projekt był zespołowy albo to fork z dołożoną funkcją. Jeden uczciwy akapit o tym, co zrobiłeś ty, bije przypisanie sobie całości. Tę samą zasadę „przesuwasz akcent, nie fakty” rozkładamy szerzej w jeden projekt, cztery role w CV.

Czego nie linkować

Najszybszy sposób na zepsucie dobrego wrażenia to wysłanie rekrutera na surowy profil, gdzie pierwsze, co widać, to słabe repozytoria. Lepiej pokazać mniej, ale dopracowane.

github.com/twojnick, profil z 47 repozytoriami: pięć forków bez jednego commita, dziesięć projektów z tutoriali nazwanych „my-first-app”, trzy puste repo z samym README, reszta bez opisu i bez demo.

To samo portfolio po przemyśleniu, co pokazać:

Dwa przypięte repozytoria: aplikacja zadań (React, TypeScript, Vitest) z działającym demo i README opisującym stack oraz decyzje techniczne, plus zmergowany PR do biblioteki open source z linkiem do zaakceptowanej zmiany. Reszta eksperymentów ustawiona jako prywatne.

Nie linkuj forków bez własnego wkładu, bo fork bez commita wygląda jak skopiowany cudzy kod. Nie linkuj projektów przepisanych z tutoriala linijka po linijce, bo rekruter rozpozna popularny kurs po nazwach plików. Nie zostawiaj na wierzchu pustych repozytoriów i porzuconych eksperymentów. Eksperymenty, których się wstydzisz, możesz ustawić jako prywatne, to nie jest oszustwo, tylko porządek na wizytówce.

Portfolio uzupełnia CV, nie zastępuje

Częsty błąd juniora: „mam GitHuba, więc CV może być byle jakie”. Odwrotnie. Portfolio i CV grają na dwie różne potrzeby i jedno nie wyręcza drugiego.

CV to filtr pierwszego kontaktu. To na nim rekruter w kilkanaście sekund decyduje, czy w ogóle kliknie twój link. Jeśli CV jest ogólne, rekruter nie dojdzie do GitHuba. Portfolio to dowód, który ogląda się dopiero, gdy CV zatrzymało uwagę. Działa wtedy, gdy potwierdza to, co obiecało CV, a nie wtedy, gdy ma je ratować.

Dlatego link do GitHuba w CV ma być celny, nie ozdobny. Zamiast gołego adresu profilu przy każdym projekcie podaj bezpośredni link do konkretnego repozytorium, które ten projekt opisuje. Rekruter klika i od razu jest na właściwej stronie, nie szuka. Jak złożyć mocne CV juniora, które w ogóle doprowadzi rekrutera do twojego portfolio, rozkładamy w CV junior bez doświadczenia.

Częste błędy

• Goły link do profilu zamiast linków do konkretnych repo. Profil z 40 repozytoriami zmusza rekrutera do szukania. Linkuj wprost do dwóch, trzech projektów, które chcesz pokazać.
• Repo bez README i bez demo. Sam kod nic nie mówi w kilkanaście sekund. Bez opisu, stacku i działającego linku rekruter zamyka kartę i nie wraca.
• Forki i tutoriale na wierzchu profilu. Skopiowany cudzy kod i przepisane kursy obniżają wartość mocnych projektów. Przypnij dobre repo, eksperymenty schowaj jako prywatne.

CV + portfolio z ZłóżCV

Portfolio działa wtedy, gdy CV najpierw doprowadzi do niego rekrutera. ZłóżCV bierze z twojej bazy projekty, układa je pod wymagania konkretnej oferty i przepisuje opisy tak, żeby było widać problem, stack i efekt, a do każdego projektu możesz podpiąć link do właściwego repozytorium. Wklejasz ofertę, dostajesz dopasowane CV w PDF, które prowadzi prosto do twojego najlepszego repo. Złóż dopasowane CV, dwa pierwsze za darmo, bez karty.

Najczęstsze pytania

Czy muszę mieć portfolio na GitHubie, żeby dostać pracę w IT? Nie jest absolutnym warunkiem, ale na stanowiskach juniorskich i przy słabym doświadczeniu komercyjnym mocno pomaga. Działające repozytorium z README i demo to dowód, że potrafisz dowieźć kod do końca. Jeśli nie masz GitHuba, ważniejsze jest jedno, dwa skończone repo niż dziesięć zaczętych.

Ile repozytoriów linkować w CV? Dwa, trzy najlepiej pasujące do oferty i naprawdę skończone. Przypnij je na profilu i podaj bezpośrednie linki przy projektach w CV. Lepiej kilka dopracowanych z działającym demo niż link do profilu z dziesiątkami porzuconych eksperymentów.

Czy forki i projekty z tutoriali szkodzą? Same w sobie nie szkodzą, dopóki nie są pierwszym, co rekruter widzi po wejściu na profil. Fork bez własnego commita wygląda jak skopiowany kod, a projekt z popularnego kursu rekruter rozpozna. Przypnij własne, skończone repozytoria, a eksperymenty ustaw jako prywatne, żeby nie rozmywały wizytówki.

Czy README naprawdę jest aż tak ważne? Tak, bo to pierwsza rzecz, którą rekruter czyta po kliknięciu repo, zanim w ogóle spojrzy na kod. Dobre README mówi w pierwszych zdaniach, co projekt robi, jak go uruchomić, w czym jest zbudowany i co zrobiłeś ty. Bez tego nawet dobry kod zostaje niezauważony.