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ć. Konkretne zestawy projektów dla poszczególnych ścieżek rozpisaliśmy osobno: projekty Python do portfolio, projekty DevOps do portfolio i projekty do portfolio Data Scientist.

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.

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.