gglc-ui

Pendahuluan

Sistem desain Company Books, dikemas sebagai registry yang kompatibel dengan shadcn/ui.

Apa ini

glc-ui adalah kumpulan komponen React yang diambil langsung dari berkas Figma Company BookV1.0.fig, lalu disajikan lewat protokol registry milik shadcn. Kamu memasangnya dengan perintah yang sama seperti memasang komponen shadcn mana pun:

npx shadcn@latest add @glc/button

Perintah itu menyalin kode sumbernya ke dalam repositorimu. Tidak ada paket npm yang ditambahkan, tidak ada versi yang perlu diikuti, tidak ada abstraksi yang menghalangi. Setelah masuk, berkas itu milikmu — silakan diedit.

Ini bukan library

Perbedaannya menentukan cara kamu memakainya.

Library komponen dipasang sebagai dependensi: kamu mendapat API, bukan kode. Kalau butuh perilaku yang tidak disediakan, kamu menunggu maintainer atau menimpanya dengan CSS.

Registry bekerja sebaliknya. Perintah add menaruh berkas .tsx di components/ui/ milikmu. Mau mengganti geometri tombol, menambah varian, atau membuang separuh isinya? Edit saja berkasnya. Tidak ada yang perlu diminta izin.

Konsekuensinya jujur saja: pembaruan tidak otomatis. Menjalankan add lagi akan menimpa berkasmu beserta suntinganmu. Itu memang harga yang dibayar untuk kepemilikan penuh.

Jaminan fallback

Bagian yang paling membedakan glc-ui dari registry lain.

Registry ini baru memuat 7 komponen. Itu jauh dari lengkap — dan tidak masalah, karena komponen shadcn mana pun yang belum diport tetap keluar on-brand tanpa disentuh:

npx shadcn@latest add combobox

Combobox itu milik shadcn, bukan glc-ui. Ia tetap keluar indigo Company Books, radius 10, di atas ramp netral yang sama, dan ikut berubah saat tema gelap dinyalakan. Yang membuatnya begitu adalah jembatan token di theme.css — bukan penyuntingan manual.

Kenapa ini penting

Kamu tidak perlu menunggu sebuah komponen diport. Ambil dari hulu sekarang, ganti dengan versi glc-ui nanti kalau memang perlu — dan tampilannya tidak akan berubah drastis di antara keduanya.

Mekanismenya dijelaskan di Fallback ke shadcn.

Isi registry

7 komponen sudah diport dari berkas Figma.

Mulai

Lanjut ke Instalasi untuk menyiapkan proyek, atau langsung ke Theming kalau ingin tahu dulu bagaimana tokennya bekerja.