Portfolio na GitHubie — jak zbudować i co pokazać

Dobre portfolio na GitHubie to kilka ukończonych, działających projektów z czytelnym plikiem README, sensowną historią commitów i przypiętych (pinned) na Twoim profilu. Dla osoby bez komercyjnego doświadczenia to najmocniejszy dowód umiejętności — pokazuje realny kod, a nie tylko listę kursów. W praktyce dobrze zaprezentowane repozytorium często robi na rekruterze większe wrażenie niż sam certyfikat.

Certyfikat mówi, że skończyłeś kurs. Portfolio pokazuje, co potrafisz z tą wiedzą zrobić. W tym artykule przejdziemy przez to, jakie projekty wybrać, jak napisać README, dlaczego liczy się historia commitów i co przypiąć na profilu.

Dlaczego portfolio jest ważniejsze niż certyfikat?

Rekruter i przyszły team lead chcą zobaczyć, jak myślisz i piszesz kod, zanim zaproszą Cię na rozmowę. Certyfikat potwierdza obecność na kursie, ale nie mówi nic o jakości Twojego kodu, umiejętności czytania cudzych rozwiązań ani o tym, czy potrafisz doprowadzić projekt do końca.

Portfolio na GitHubie odpowiada na te pytania wprost. Publiczne repozytorium to jednocześnie próbka kodu, dowód samodzielności i temat do rozmowy technicznej. Dlatego zamiast zbierać kolejne kursy, lepiej zbudować kilka porządnych projektów — a solidny fundament dają praktyczne kursy IT z mentorem, gdzie kod od początku trafia do repozytorium.

Ile projektów i jakie wybrać?

Nie chodzi o ilość, tylko o jakość. Wystarczą 3-5 projektów, które faktycznie działają i które potrafisz omówić linijka po linijce. Lepiej mieć trzy dopracowane repozytoria niż dwadzieścia porzuconych.

• Projekt z kursu, ale rozbudowany — weź zadanie z zajęć i dodaj coś od siebie (nową funkcję, testy, lepszy interfejs).
• Projekt rozwiązujący realny problem — narzędzie, które sam byś chciał używać: bot, prosty tracker wydatków, scraper danych.
• Projekt pokazujący konkretną technologię — np. aplikacja z bazą danych i API, jeśli celujesz w backend.
• Mały projekt „na zaliczenie" tematu — ćwiczenie z testów automatycznych albo integracji z zewnętrznym API.

Jeśli dopiero wybierasz kierunek, warto najpierw przemyśleć specjalizację — pomoże w tym artykuł jaki kurs IT wybrać. Inne projekty naturalnie pasują do ścieżek takich jak tester automatyzujący w Pythonie czy frontend developer.

Jak napisać dobre README?

README to pierwsza rzecz, którą widzi osoba wchodząca do repozytorium. Jeśli jest puste albo zawiera tylko domyślny tekst, projekt wygląda na porzucony — niezależnie od tego, jak dobry jest kod w środku.

Dobry plik README powinien zawierać:

1. Krótki opis — co robi projekt i jaki problem rozwiązuje, w 2-3 zdaniach.
2. Zrzut ekranu lub GIF — jeśli projekt ma interfejs, pokaż go od razu.
3. Stack technologiczny — języki, frameworki i narzędzia, których użyłeś.
4. Instrukcję uruchomienia — jak sklonować repozytorium i odpalić projekt lokalnie.
5. Sekcję „czego się nauczyłem" lub plany rozwoju — pokazuje refleksję i chęć rozwoju.

Pisz po polsku lub po angielsku — angielski jest bezpieczniejszym wyborem, bo działa też w rekrutacjach do firm zagranicznych.

Dlaczego liczy się historia commitów?

Historia commitów opowiada, jak powstawał projekt. Jeden gigantyczny commit „final version" wygląda podejrzanie i sugeruje, że kod został wklejony skądś na koniec. Regularne, opisowe commity pokazują, że projekt rósł krok po kroku i że rozumiesz proces pracy z kodem.

• Commituj często i w logicznych porcjach — jedna funkcja, jedna poprawka.
• Pisz treściwe opisy: „dodano walidację formularza", a nie „fix", „update", „zmiany".
• Nie bój się widocznych błędów w historii — pokazują, że naprawdę pracowałeś nad kodem.

Historia commitów to też świetny materiał na rozmowę techniczną — łatwo o niej opowiadać, gdy przygotowujesz się do rozmowy kwalifikacyjnej w IT.

Jak wygląda dobry profil na GitHubie?

Profil to Twoja wizytówka, więc zadbaj o kilka podstaw. Ustaw czytelną nazwę użytkownika (najlepiej imię i nazwisko), dodaj zdjęcie i krótki opis w bio. To drobiazgi, ale budują pierwsze wrażenie.

Najważniejsza funkcja to pinned repositories — możesz przypiąć do sześciu repozytoriów, które pokażą się na górze profilu. Przypnij swoje najlepsze projekty, a nie forki cudzych bibliotek czy ćwiczenia „hello world". Ukryj lub usuń stare, chaotyczne repozytoria, żeby nie rozpraszały uwagi.

Jak połączyć portfolio z CV i szukaniem pracy?

Portfolio nie działa w próżni — jest częścią większej całości. Link do GitHuba powinien znaleźć się w CV, na LinkedInie i w wiadomościach do rekruterów. Zadbaj, żeby prowadził do profilu z przypiętymi, dopracowanymi projektami.

Warto zsynchronizować portfolio z resztą aplikacji: opisz projekty w CV programisty i przygotuj się na pytania o nie. Jeśli szukasz pierwszej pracy, pomogą praktyczne wskazówki z artykułu o pierwszej pracy w IT bez doświadczenia. A jeśli dopiero planujesz zmianę zawodu, zacznij od tekstu o przebranżowieniu do IT.

Najczęstsze pytania

Czy projekty z kursu wystarczą w portfolio?

Tak, ale najlepiej je rozbudować. Projekt z zajęć pokazuje podstawy, jednak jeśli setki osób oddały identyczny kod, nie wyróżnisz się. Dodaj własną funkcję, testy albo lepszy interfejs — wtedy repozytorium staje się naprawdę Twoje i masz o czym opowiadać na rozmowie.

Czy muszę znać Gita, żeby zacząć?

Podstaw Gita nauczysz się szybko — wystarczą commit, push, branch i pull request. Nie musisz znać wszystkiego od razu. Najlepiej uczyć się w praktyce, publikując kolejne projekty. Na dobrym kursie pracę z Gitem i GitHubem ćwiczysz od pierwszych tygodni.

Publiczne czy prywatne repozytoria?

Projekty do portfolio powinny być publiczne — inaczej rekruter ich nie zobaczy. Prywatne trzymaj tylko wtedy, gdy zawierają dane wrażliwe albo kod komercyjny, którego nie wolno Ci ujawnić. W portfolio juniora zdecydowana większość repozytoriów powinna być otwarta.

Ile czasu zajmuje zbudowanie sensownego portfolio?

Zwykle kilka tygodni do kilku miesięcy, w zależności od tempa i wolnego czasu. Nie chodzi o pośpiech, lecz o systematyczność — jeden dopracowany projekt miesięcznie po pół roku daje solidne portfolio. Jeśli uczysz się na kursie, projekty powstają naturalnie w trakcie nauki.

Chcesz zbudować portfolio, które realnie pomoże w rekrutacji? Na praktycznym kursie Python Developer z mentorem od początku pracujesz na prawdziwych projektach i publikujesz kod na GitHubie — tak, by po ukończeniu mieć gotowe portfolio, a nie tylko certyfikat.