Repozytorium

Miejsce przechowujące kod projektu wraz z pełną historią zmian. Może być lokalne lub zdalne, np. na GitHubie.

Repozytorium (z angielskiego repository, w skrócie repo) to miejsce, w którym trzymasz kod swojego projektu razem z pełną historią jego zmian. To nie jest zwykły folder z plikami — repozytorium pamięta, kto, kiedy i co zmienił, więc w każdej chwili możesz cofnąć się do dowolnej wcześniejszej wersji. Repo może żyć lokalnie na Twoim dysku albo zdalnie, na serwerze takim jak GitHub, GitLab czy Bitbucket.

Jak to działa i do czego służy

Repozytorium zwykle prowadzisz przez system kontroli wersji — w 2026 roku w zdecydowanej większości projektów jest to Git. Zamiast zapisywać kolejne kopie typu projekt_final_v2_naprawde_ostateczny.zip, robisz commit: migawkę stanu projektu z opisem, co się zmieniło. Te commity tworzą historię, którą możesz przeglądać, porównywać i odtwarzać.

Repo daje Ci trzy rzeczy naraz: backup (kod jest bezpieczny, jeśli laptop padnie), historię (widzisz, kiedy wkradł się błąd) i współpracę (kilka osób pracuje nad tym samym projektem bez nadpisywania sobie zmian). W repo zdalnym dochodzą jeszcze gałęzie (branche), pull requesty i code review.

Przykład z praktyki

Załóż lokalne repozytorium w istniejącym katalogu projektu:

  • git init — tworzy puste repo (powstaje ukryty katalog .git, w którym Git trzyma całą historię),
  • git add . — dodaje pliki do tzw. poczekalni (staging area),
  • git commit -m "Pierwszy commit" — zapisuje migawkę,
  • git remote add origin https://github.com/user/projekt.git — podpina repo zdalne,
  • git push -u origin main — wysyła kod na GitHub.

Od tej pory git clone pozwoli komukolwiek (albo Tobie na innym komputerze) pobrać cały projekt razem z historią.

Częste błędy i mity

Mit: repozytorium to to samo co GitHub. Nie. Git to narzędzie, repozytorium to projekt z historią, a GitHub to tylko jeden z hostingów dla repozytoriów zdalnych. Git działa świetnie bez internetu.

Typowe wpadki początkujących: wrzucenie do repo plików, których tam być nie powinno — haseł, kluczy API, katalogu node_modules czy plików .env. Od tego jest plik .gitignore. Pamiętaj też, że raz wypchnięty do publicznego repo sekret traktuj jak skompromitowany — usunięcie go kolejnym commitem nic nie da, bo siedzi w historii.

Pojęcia powiązane

Git, system kontroli wersji (VCS), commit, branch (gałąź), pull request, .gitignore, klonowanie, GitHub, GitLab, monorepo.