diff --git a/Github repo b/Github repo new file mode 100644 index 00000000..db2b8904 --- /dev/null +++ b/Github repo @@ -0,0 +1,108 @@ +## ๐Ÿš€ Menyediakan Repositori GitHub untuk Projek **codepaul** + +Anda telah membangunkan projek **React + Node.js + Express** dengan struktur seperti di bawah. Sekarang tiba masanya untuk meletakkannya di GitHub. + +``` +codepaul/ +โ”œโ”€โ”€ client/ +โ”œโ”€โ”€ server/ +โ”œโ”€โ”€ .github/ +โ”œโ”€โ”€ .gitignore +โ”œโ”€โ”€ README.md +โ””โ”€โ”€ LICENSE +``` + +### ๐Ÿ“Œ Pilihan 1: Buat Repositori Baru di GitHub (melalui laman web) + +1. Buka [GitHub](https://github.com) dan log masuk. +2. Klik butang **+** di sudut kanan atas, pilih **New repository**. +3. Isi butiran: + - **Repository name**: `codepaul` (atau nama pilihan anda, contoh: `my-app`) + - **Description**: (optional) "Full-stack React + Node.js + Express with CI/CD" + - **Public** atau **Private** (pilih mengikut keperluan) + - **Jangan** tandakan "Initialize this repository with a README" (kerana kita sudah ada README tempatan). +4. Klik **Create repository**. + +### ๐Ÿ“Œ Pilihan 2: Buat Repositori Menggunakan GitHub CLI (jika dipasang) + +```bash +gh repo create codepaul/codepaul --public --source=. --remote=origin --push +``` + +(Gantikan `codepaul/codepaul` dengan username/repo anda) + +--- + +## ๐Ÿ”— Menyambung Repositori Tempatan ke GitHub + +Selepas repositori kosong sedia di GitHub, jalankan arahan berikut dalam terminal di direktori root projek anda: + +```bash +# Jika anda belum menambah remote +git remote add origin https://github.com/codepaul/codepaul.git + +# Tukar nama branch utama kepada main (jika masih master) +git branch -M main + +# Push semua commit ke GitHub +git push -u origin main +``` + +> **Nota**: Gantikan `codepaul/codepaul.git` dengan URL repositori anda yang sebenar. + +--- + +## โœ… Semakan + +Selepas push, buka repositori di GitHub โ€“ anda akan melihat semua folder dan fail, termasuk `.github/workflows/ci-cd.yml`. Setiap kali anda melakukan `git push` ke branch `main`, GitHub Actions akan menjalankan pipeline CI/CD yang telah ditetapkan. + +--- + +## ๐Ÿ” Menyediakan Rahsia (Secrets) untuk Deployment (Pilihan) + +Jika anda ingin mengaktifkan langkah deploy dalam GitHub Actions (contohnya ke Vercel, Render, dll.), anda perlu menambah **secrets** di repositori GitHub: + +1. Buka repositori di GitHub. +2. Pergi ke **Settings** โ†’ **Secrets and variables** โ†’ **Actions**. +3. Klik **New repository secret**. +4. Tambah nama (contoh: `VERCEL_TOKEN`) dan nilainya (token daripada Vercel). +5. Dalam fail workflow, gunakan `${{ secrets.VERCEL_TOKEN }}` untuk merujuknya. + +--- + +## ๐Ÿ“ฆ Struktur Fail yang Telah Disediakan + +Ringkasan fail utama yang telah anda hasilkan: + +- **`client/`** โ€“ Frontend React (dengan `App.js`, komponen Hello, dll.) +- **`server/`** โ€“ Backend Express (dengan `server.js`, routes, dll.) +- **`.github/workflows/ci-cd.yml`** โ€“ Pipeline CI/CD +- **`.gitignore`** โ€“ Fail dan direktori yang dikecualikan +- **`README.md`** โ€“ Dokumentasi projek +- **`LICENSE`** โ€“ Lesen MIT + +Pastikan semua fail telah di-commit sebelum push: + +```bash +git add . +git commit -m "Complete full-stack project with CI/CD" +git push +``` + +--- + +## ๐Ÿงช Uji Pipeline + +Selepas push, pergi ke tab **Actions** di repositori GitHub anda. Anda akan melihat workflow `CI/CD Pipeline` sedang berjalan. Klik untuk melihat log. Jika semuanya hijau, tahniah โ€“ CI/CD anda berfungsi! + +--- + +## ๐ŸŽฏ Seterusnya + +- **Kembangkan projek**: Tambah pangkalan data (MongoDB, PostgreSQL), autentikasi, atau ujian. +- **Deploy sebenar**: Gunakan Render untuk backend dan Vercel untuk frontend. +- **Sesuaikan domain**: Beli domain dan pautkan ke perkhidmatan hosting. + +Jika anda memerlukan bantuan untuk mana-mana langkah di atas (misalnya menulis konfigurasi deployment untuk Render atau Vercel dalam GitHub Actions), beritahu saya โ€“ saya akan bantu! + +**Selamat membangun!** ๐Ÿš€