Simpan proyek Anda ke GitHub

GitHub adalah tempat developer menyimpan kode, lengkap dengan riwayat setiap perubahan. Hubungkan proyek MonstarX ke repositori GitHub (folder proyek di GitHub), dan keduanya akan tetap selaras, dua arah: apa yang dibangun MonstarX dikirim ke sana sebagai commit, dan apa yang Anda atau developer commit di sana masuk kembali ke MonstarX.

Ini berguna jika developer ingin mengerjakan kode di editornya sendiri, jika perusahaan Anda menyimpan semua kode di GitHub, atau jika Anda melakukan deployment dari GitHub — seperti yang dilakukan Railway, misalnya.

Bagaimana cara menghubungkan akun GitHub saya?

Anda menghubungkan GitHub sekali saja untuk seluruh akun MonstarX, dari Pengaturan›Integrasi atau dari tombol GitHub di proyek mana pun. Cara termudah adalah dengan GitHub App MonstarX: tidak ada token yang perlu dibuat atau ditempel, dan Anda menentukan sendiri repositori mana saja yang boleh diakses MonstarX.

1. Klik Hubungkan akun GitHub pribadi.

   

2. GitHub terbuka dan menanyakan di mana aplikasi akan diinstal. Pilih akun pribadi Anda (bukan organisasi).

3. Pilih repositori yang boleh dipakai MonstarX: All repositories, atau Only select repositories lalu centang yang Anda inginkan. Anda bisa mengubahnya nanti di GitHub.

4. Klik Install, lalu Authorize saat GitHub meminta konfirmasi.

5. Anda kembali ke MonstarX. Kartu bertuliskan Terhubung · GitHub App.

Beberapa hal yang perlu diketahui tentang GitHub App:

• Tidak perlu persetujuan organisasi. Aplikasi ini hanya diinstal di akun pribadi Anda. Jika Anda tidak sengaja memilih organisasi, MonstarX akan meminta Anda menginstalnya di akun pribadi lalu mencoba lagi.
• Repositori baru dibuat di akun pribadi Anda. MonstarX selalu bisa mengakses repositori yang dibuatnya sendiri, bahkan jika Anda memilih Only select repositories.
• Pilihan repositori Anda adalah batasnya. Untuk menghubungkan repositori yang sudah ada, repositori itu harus termasuk yang Anda berikan kepada aplikasi. Tambahkan repositori lain di pengaturan aplikasi terinstal di GitHub.
• Akses berlaku singkat dan diperbarui secara otomatis, serta disimpan dalam bentuk terenkripsi. Akses ini tidak pernah dikirim ke browser Anda.

Cara lain untuk menghubungkan

Jika Anda lebih suka, ada dua cara lain:

Cara	Kapan memakainya
Repositori pribadi dengan akses terbatas (di Pengaturan: Hubungkan repositori pribadi dengan akses terbatas)	Anda ingin MonstarX mengakses tepat satu repositori dengan token akses pribadi (kata sandi yang Anda buat di GitHub untuk satu keperluan). Buat fine-grained token dengan akun pribadi Anda sebagai resource owner, hanya untuk repositori tersebut, dan dengan izin Contents: read and write. Buat repositorinya di GitHub lebih dulu; jenis token ini tidak bisa membuat repositori baru.
Gunakan otorisasi GitHub sebagai gantinya	Anda ingin melakukan push ke repositori di organisasi tempat Anda menjadi anggota. Layar masuk GitHub yang biasa mungkin mencakup akses ke organisasi tersebut, jadi periksa dulu sebelum mengizinkannya.

Setelah terhubung, kartu menunjukkan caranya (GitHub App, Masuk dengan GitHub, atau Token akses pribadi) dan mencantumkan setiap repositori yang terus diperbarui MonstarX, beserta kapan terakhir disinkronkan dan apakah sinkronisasinya Otomatis atau Manual. Menghubungkan dengan cara lain di kemudian hari akan menggantikan koneksi lama; repositori yang sudah terhubung tetap terhubung.

Bagaimana cara menyimpan proyek ke GitHub?

1. Buka proyek, lalu klik GitHub di bilah atas. (Pilihan ini juga ada di Pengaturan›Ekspor proyek, di bawah Simpan di GitHub.)

2. Jika akun Anda belum terhubung, hubungkan langsung di sana.

   

3. Pilih Repositori baru atau Repositori yang sudah ada:

   • Repositori baru — pilih Pemilik (Anda atau salah satu organisasi Anda), ketik Nama repositori, biarkan Repositori privat tetap dicentang kecuali Anda ingin semua orang bisa melihat kodenya, lalu klik Buat repositori dan push.
   • Repositori yang sudah ada — ketik owner/repository atau tempelkan alamat github.com-nya, isi Branch jika perlu (branch bawaan jika dikosongkan), lalu klik Hubungkan dan sinkronkan. Akun Anda harus punya izin push ke repositori tersebut.

4. MonstarX melakukan push seluruh proyek sebagai repositori yang siap di-deploy. Tombol GitHub mendapat titik hijau saat sudah tersinkron.

Repositori baru dimulai dengan satu commit, “Initial commit from MonstarX”. Di repositori yang sudah ada, proyek di-commit di atas branch tersebut, dan file yang tidak dikelola MonstarX — LICENSE, workflow CI, dokumentasi — tidak pernah disentuh.

Apa saja yang masuk ke repositori?

Semua yang diberikan Ekspor: kode aplikasi, file framework MonstarX, konfigurasi untuk menjalankan dan men-deploy aplikasi, migrasi database, daftar nama rahasia yang dibutuhkan aplikasi (tanpa nilainya), dan README.

Beberapa hal tidak pernah dikirim ke GitHub:

• Nilai rahasia, serta baris database dan file yang diunggah di aplikasi Anda tetap tersimpan di MonstarX.
• Baris yang diimpor dari spreadsheet tidak pernah dikirim, karena repositori bisa saja publik dan baris itu berisi data pelanggan Anda.
• File biner dan file di atas 1 MB dilewati dan dicantumkan di log sinkronisasi.

Kapan MonstarX melakukan sinkronisasi?

Selama Push setiap perubahan secara otomatis aktif (aktif secara bawaan), MonstarX melakukan sinkronisasi:

• setelah setiap permintaan yang mengubah file aplikasi — pesan commit-nya adalah permintaan Anda;
• setelah perbaikan otomatis dari QA;
• setelah Anda memulihkan versi;
• setelah Anda menyimpan atau menghapus file di tab Kode.

Sinkronkan sekarang di menu GitHub melakukan push dan pull kapan pun Anda mau. Nonaktifkan push otomatis jika Anda lebih suka menyinkronkan secara manual.

Apa yang terjadi saat seseorang mengedit kode di GitHub?

Lakukan commit di GitHub seperti biasa. Pada sinkronisasi berikutnya, MonstarX menarik perubahan itu ke dalam proyek:

• Perubahan pada file aplikasi itu sendiri (src/, public/, migrations/, dan README.md) masuk ke MonstarX. Pratinjau diperbarui, migrasi database baru dijalankan, dan versi bernama Dari GitHub: diikuti subjek commit muncul di Versi.
• Sebuah kartu di percakapan, misalnya “Mengambil 3 file dari GitHub”, mencantumkan file-filenya, sehingga Anda dan MonstarX sama-sama tahu apa yang berubah.
• Perubahan pada file framework MonstarX, seperti package.json atau konfigurasi, tetap di GitHub sampai MonstarX sendiri mengubah file tersebut berikutnya.
• Jika file yang sama berubah di kedua sisi, MonstarX mempertahankan versinya, dan versi Anda tetap ada di riwayat GitHub. Kartu menandainya dengan “diubah di kedua sisi — versi MonstarX dipertahankan”.

Tips

Jika developer sedang mengubah sebuah file di GitHub, hindari meminta MonstarX mengubah file yang sama pada saat yang sama. Menyinkronkan lebih sering (Sinkronkan sekarang) menjaga kedua sisi tetap dekat.

Apa yang ditampilkan menu GitHub setelah terhubung?

• Repositori, branch-nya, dan apakah repositori itu Privat atau Publik.
• Kapan terakhir disinkronkan (Disinkronkan beberapa menit lalu), atau Sinkronisasi terakhir gagal beserta alasannya.
• Sinkronkan sekarang dan Buka repositori.
• Push setiap perubahan secara otomatis.
• Sinkronisasi terbaru — lima yang terakhir, masing-masing dengan commit-nya.
• Putuskan tautan repositori — menghentikan sinkronisasi. Repositori tetap ada di GitHub.
• Putuskan koneksi — memutuskan koneksi akun GitHub Anda. Tidak ada yang dikirim sampai Anda menghubungkannya lagi.

Bagaimana dengan aplikasi yang saya impor dari GitHub?

Saat Anda mengimpor aplikasi dari repositori yang bisa Anda push, proyek tetap terhubung ke repositori itu — di branch baru bernama monstarx, yang dimulai dari commit yang Anda impor. Branch Anda sendiri tidak pernah bergeser. Jika Anda sudah puas dengan perubahan dari MonstarX, Buka pull request di menu GitHub membawa Anda ke GitHub untuk menggabungkannya.

Pertanyaan umum

Apakah saya memerlukan token GitHub?

Tidak. Hubungkan akun GitHub pribadi menginstal GitHub App MonstarX: Anda masuk di GitHub, memilih repositori, dan selesai. Token akses pribadi hanyalah alternatif bagi yang ingin membatasi MonstarX ke satu repositori dengan cara itu.

Bisakah GitHub App mengakses organisasi perusahaan saya?

Tidak — aplikasi ini hanya diinstal di akun pribadi Anda, dan membuat repositori baru di sana. Untuk melakukan push ke repositori milik organisasi, hubungkan dengan Gunakan otorisasi GitHub sebagai gantinya, atau minta organisasi menambahkan Anda agar bisa menghubungkannya dari akun Anda.

Bagaimana cara memberi MonstarX akses ke repositori lain nanti?

Di GitHub, buka pengaturan GitHub App yang terinstal, pilih MonstarX, lalu tambahkan repositorinya (atau beralih ke All repositories). Setelah itu, hubungkan repositori tersebut dari menu GitHub di proyek.

Apakah repositori saya privat?

Repositori baru bersifat privat secara bawaan — hapus centang Repositori privat hanya jika Anda ingin kodenya publik. MonstarX tidak pernah mengirim nilai rahasia atau data aplikasi Anda.

Bisakah saya menghubungkan repositori milik organisasi perusahaan saya?

Bisa, jika akun GitHub Anda punya izin push ke repositori tersebut. Gunakan Repositori yang sudah ada, atau pilih organisasi itu sebagai Pemilik saat membuat repositori baru.

Apa yang terjadi jika saya memutuskan tautan repositori?

MonstarX berhenti menyinkronkan. Repositori beserta seluruh riwayatnya tetap ada di GitHub, dan Anda bisa menghubungkannya lagi nanti.

Developer mengubah package.json di GitHub. Mengapa perubahannya tidak masuk kembali?

File framework seperti package.json dan konfigurasi dikelola oleh MonstarX. Perubahan pada file tersebut tetap di GitHub sampai MonstarX mengubah file itu berikutnya; sinkronisasi selanjutnya tidak pernah membatalkannya diam-diam.

Bisakah saya melakukan deployment dari repositori?

Bisa. Repositori sudah siap di-deploy, dan Railway bisa men-deploy dari repositori itu. Lihat juga Terbitkan ke host lain.

Apa yang terjadi pada tautan repositori jika saya mentransfer proyek?

Tautannya dilepas, sehingga tidak ada yang pernah dikirim ke akun GitHub Anda atas nama pemilik baru. Repositori itu sendiri tidak diubah.

Terkait

Ekspor kode AndaUnduh seluruh proyek sebagai file zip.

Impor aplikasiBawa masuk aplikasi dari GitHub atau file zip.

VersiSetiap perubahan, dan cara memulihkannya.

Agen pemrogramanKirim dan tarik kode dengan Claude Code, Cursor, atau Codex.