Selamat! Kamu telah berhasil membangun sebuah proyek API yang fungsional, terdokumentasi, dan teruji dengan baik. Langkah terakhir dari seorang developer adalah memamerkan hasil karyanya kepada dunia. Tempat terbaik untuk melakukannya adalah GitHub.
Bagian 1: Apa Itu GitHub? (Portofolio Digital Developer)
GitHub adalah sebuah platform online yang digunakan oleh jutaan developer di seluruh dunia untuk menyimpan, mengelola, dan berkolaborasi dalam proyek kode. Anggap saja ini seperti “Google Drive” atau “Instagram” khusus untuk para pembuat kode.
Fungsi utama GitHub adalah:
- Menyimpan Kode secara Online: Menjadi backup aman untuk semua proyekmu.
- Version Control (Kontrol Versi): Dengan bantuan alat bernama Git, GitHub menyimpan riwayat setiap perubahan yang kamu buat. Jadi, jika ada kesalahan, kamu bisa kembali ke “versi” sebelumnya dengan mudah.
- Kolaborasi: Memudahkan kerja sama dalam tim.
- Membangun Portofolio: Ini yang paling penting untukmu sekarang. Profil GitHub-mu adalah CV digital-mu. Semakin banyak proyek berkualitas yang kamu tampilkan di sana, semakin baik reputasimu di mata perusahaan atau calon klien.
Bagian 2: Panduan Membuat Akun GitHub
Jika kamu belum punya akun, prosesnya sangat mudah.
- Buka Situs GitHub: Kunjungi github.com.
- Daftar: Klik tombol “Sign up” dan ikuti proses pendaftarannya. Kamu akan diminta mengisi email, membuat password, dan memilih username. Pilihlah username yang profesional karena ini akan menjadi identitasmu di dunia developer.
Bagian 3: Praktik: Mengunggah Proyek ke GitHub
Sekarang kita akan mengunggah project-express
kita. Proses ini menggunakan alat baris perintah (command line) bernama Git.
Langkah 0: Instal Git Jika komputermu belum terinstal Git, unduh terlebih dahulu dari git-scm.com/downloads dan instal dengan pengaturan default.
Langkah 1: Buat Repositori Baru di GitHub
- Login ke akun GitHub-mu.
- Di pojok kanan atas, klik ikon
+
lalu pilih “New repository”. - Beri nama repositorimu (misalnya,
bootcamp-api-siswa
), berikan deskripsi singkat (opsional), pastikan statusnya Public, lalu klik “Create repository”.
Langkah 2: Hubungkan Proyek Lokal dengan GitHub Buka terminal di dalam folder proyekmu di VSCode, lalu jalankan perintah-perintah berikut satu per satu:
- Inisialisasi Git di Proyekmu:
git init
- Buat file
.gitignore
: Buat sebuah file baru di folder utama proyekmu bernama.gitignore
. Isi file tersebut dengan satu baris ini untuk memberitahu Git agar tidak mengunggah foldernode_modules
yang sangat besar:node_modules/
- Tambahkan Semua File untuk Dilacak:
git add .
- Buat “Simpanan” Pertama (Commit):
git commit -m "Initial commit: Proyek API Data Siswa"
- Hubungkan dan Unggah: Kembali ke halaman repositori GitHub yang kamu buat tadi. Salin dan tempel tiga baris perintah yang disediakan di bawah bagian “…or push an existing repository from the command line”. Perintahnya akan terlihat seperti ini:
git remote add origin https://github.com/USERNAME_ANDA/NAMA_REPO_ANDA.git git branch -M main git push -u origin main
Tunggu prosesnya selesai. Sekarang, coba segarkan (refresh) halaman repositori GitHub-mu. Semua kodemu sudah berhasil diunggah!
Bagian 4: Membuat File README.md yang Informatif
Saat orang lain mengunjungi repositorimu, hal pertama yang mereka lihat adalah isi dari file README.md
. Ini adalah “halaman sampul” proyekmu. Mari kita buat yang bagus.
-
Buat File: Di VSCode, buat file baru di folder utama proyekmu bernama
README.md
. -
Isi dengan Informasi Penting: Gunakan format Markdown untuk menjelaskan proyekmu. Berikut adalah contoh template sederhana:
# Proyek API Data Siswa Ini adalah proyek RESTful API sederhana yang dibuat sebagai bagian dari Mini Bootcamp Backend Pemula dengan Express.js dan Supabase. ## Deskripsi API ini memungkinkan pengguna untuk melakukan operasi CRUD (Create, Read, Update, Delete) pada data siswa. Proyek ini dibangun menggunakan Node.js, Express.js, dan terhubung ke database PostgreSQL melalui Supabase. ## Fitur / Endpoint API * `GET /students`: Mengambil semua data siswa. * `POST /students`: Menambahkan data siswa baru. * `PUT /students/:id`: Memperbarui data siswa berdasarkan ID. * `DELETE /students/:id`: Menghapus data siswa berdasarkan ID. ## Cara Menjalankan Proyek Secara Lokal 1. Clone repositori ini. 2. Jalankan `npm install` untuk menginstal semua dependensi. 3. Buat file konfigurasi Supabase Anda. 4. Jalankan server dengan `node src/index.js`.
- Unggah README.md: Simpan file
README.md
, lalu kembali ke terminal dan jalankan perintah-perintah ini untuk mengunggah perubahan terakhirmu:git add README.md git commit -m "docs: Menambahkan file README.md" git push
Segarkan kembali halaman GitHub-mu. Sekarang repositorimu terlihat jauh lebih profesional dan informatif.
Selamat! Kamu telah menyelesaikan seluruh materi bootcamp dan berhasil mempublikasikan hasil kerjamu!