Langkah-Langkah Upload Proyek ke GitHub

Jika kamu baru belajar Git dan GitHub, mungkin kamu bertanya-tanya bagaimana cara mengunggah kode proyekmu ke repository online. Sebenarnya, langkah-langkah upload proyek ke GitHub untuk proyek pertama mu sangat mudah dilakukan, bahkan untuk pemula sekalipun. Dengan mengunggah proyek ke GitHub, kamu tidak hanya menyimpan cadangan kode di cloud, tetapi juga menunjukkan hasil karyamu kepada dunia, baik untuk portofolio maupun kolaborasi tim. Dalam tutorial ini, kita akan membahas secara lengkap dan terstruktur mulai dari membuat repository hingga menjalankan perintah Git yang diperlukan agar proyekmu bisa di-upload ke GitHub dengan benar.

Apa Itu GitHub dan Mengapa Penting untuk Developer?

GitHub adalah platform hosting berbasis cloud untuk menyimpan proyek menggunakan sistem kontrol versi Git. Dengan GitHub, kamu bisa:

Melacak perubahan setiap baris kode.
Bekerja sama dengan tim tanpa bentrok versi file.
Menampilkan portofolio proyek secara publik.
Mengamankan proyek di cloud agar tidak hilang.

Selain itu, GitHub sangat populer di kalangan developer profesional. Banyak perusahaan bahkan menjadikan akun GitHub sebagai syarat utama dalam proses rekrutmen developer.

Persiapan Sebelum Upload Proyek ke GitHub

Sebelum mulai upload proyek, pastikan kamu sudah menyiapkan beberapa hal berikut:

Akun GitHub aktif. Jika belum punya, daftarkan di https://github.com
Git sudah terinstal di komputer. Unduh dari https://git-scm.com/downloads, lalu cek instalasi dengan perintah:
```
git --version
```
Proyek siap upload. Pastikan kamu sudah punya folder proyek, misalnya:
C:\Users\NamaKamu\Documents\web-portfolio
Akses internet stabil. Karena proses push memerlukan koneksi untuk mengirim file ke GitHub.

Membuat Repository di GitHub

Langkah pertama sebelum upload adalah membuat repository di GitHub, yaitu tempat penyimpanan proyekmu.

Langkah-langkahnya:

Masuk ke akun GitHub kamu.
Klik ikon “+” di pojok kanan atas → pilih New Repository.
Isi kolom berikut:
- Repository name: misalnya web-portfolio
- Description: tambahkan deskripsi singkat (opsional)
- Visibility: pilih Public (terlihat semua orang) atau Private (hanya kamu/tim)
Centang Add a README file (opsional).
Klik Create Repository.

Setelah repository dibuat, GitHub akan menampilkan halaman berisi petunjuk untuk menghubungkan proyek lokal dengan repository tersebut.

Inisialisasi Git di Folder Proyek

Sekarang waktunya menghubungkan folder proyek di komputermu dengan Git.

Buka Command Prompt (CMD) atau Git Bash, lalu arahkan ke folder proyek:

cd C:\Users\NamaKamu\Documents\web-portfolio

Kemudian jalankan perintah:

git init

Perintah ini akan membuat folder tersembunyi bernama .git yang berfungsi untuk melacak versi file di dalam proyekmu.

Tambahkan File Proyek ke Git

Selanjutnya, tambahkan semua file proyek ke staging area dengan perintah:

git add .

Titik (.) berarti semua file di folder tersebut akan dimasukkan.

Kemudian, lakukan commit pertama untuk menyimpan perubahan:

git commit -m "First commit - upload proyek pertama"

Setiap commit sebaiknya diberi pesan yang menjelaskan perubahan yang dilakukan agar lebih mudah ditelusuri di masa depan.

Hubungkan Git Lokal ke Repository GitHub

Langkah berikutnya adalah menghubungkan proyek lokal ke repository GitHub yang sudah kamu buat.

Gunakan perintah berikut:

git remote add origin https://github.com/username/web-portfolio.git

Gantilah username dengan nama akun GitHub kamu dan web-portfolio dengan nama repository.

Untuk memastikan koneksi sudah berhasil, jalankan:

git remote -v

Jika muncul alamat repository GitHub kamu, berarti koneksi berhasil dibuat.

Upload (Push) Proyek ke GitHub

Setelah semuanya siap, sekarang saatnya melakukan upload proyek ke GitHub dengan perintah:

git push -u origin main

Namun, jika branch default di repository kamu masih master, gunakan:

git push -u origin master

Git akan meminta kamu untuk login ke GitHub — cukup masukkan username dan token akses (bukan password biasa). Setelah berhasil, semua file proyekmu akan diunggah ke GitHub.

Buka halaman repository di browser, dan kamu akan melihat file proyekmu sudah muncul online!

Alternatif: Upload Langsung dari GitHub (Tanpa Git)

Jika kamu belum familiar dengan Git, GitHub juga menyediakan cara manual untuk mengunggah file.

Caranya:

Masuk ke repository GitHub.
Klik tombol Add file → pilih Upload files.
Seret dan lepaskan file proyek ke halaman tersebut.
Klik Commit changes.

Namun, metode ini hanya cocok untuk proyek kecil atau file sederhana. Untuk proyek besar dan pengembangan berkelanjutan, gunakan Git agar versi kode mudah dikelola.

Tips Upload Proyek ke GitHub dengan Aman dan Rapi

Agar repository kamu tetap rapi dan aman, ikuti tips berikut:

Gunakan file .gitignore.
Tambahkan file .gitignore agar file sensitif (seperti password, node_modules, atau konfigurasi lokal) tidak ikut diunggah.
Contoh isi:
```
node_modules/
.env
.vscode/
```

Tambah file README.md.
Berisi deskripsi proyek, teknologi yang digunakan, dan cara menjalankan aplikasi.
Gunakan branch development.
Jangan langsung mengedit di branch utama (main), gunakan branch tambahan agar lebih aman.
Commit secara berkala.
Commit kecil namun sering membuat histori proyek lebih mudah dipahami.

Troubleshooting: Mengatasi Error Umum Saat Push ke GitHub

Kadang saat melakukan push, kamu bisa menemukan error seperti:

Error: Authentication failed.
Solusi: gunakan Personal Access Token GitHub sebagai password.
Error: branch ‘main’ does not exist.
Solusi: ganti ke master atau buat branch baru dengan:
```
git branch -M main
```

Error: remote origin already exists.
Solusi: hapus remote lama, lalu tambahkan ulang:

git remote remove origin
git remote add origin https://github.com/username/repo.git

Dengan memahami pesan error, kamu akan semakin mahir menggunakan Git.

Kesimpulan

Sekarang kamu sudah tahu langkah-langkah upload proyek pertama ke GitHub, mulai dari membuat akun dan repository hingga menjalankan perintah git init, commit, dan push.

Dengan rutin mengunggah proyek ke GitHub, kamu tidak hanya memiliki backup online, tetapi juga membangun portofolio sebagai developer profesional. GitHub menjadi bukti nyata bahwa kamu aktif mengembangkan kemampuan dan siap bekerja dalam tim pengembang modern.

Mulailah dari proyek kecil — misalnya website sederhana atau aplikasi mini — dan unggah ke GitHub hari ini. Semakin sering kamu berlatih, semakin mudah dan alami prosesnya ke depannya.