Kampung KB Bestari Belimbing 🌿

Selamat datang di repositori resmi Kampung Keluarga Berkualitas (Kampung KB) Bestari, Desa Belimbing, Kabupaten Hulu Sungai Utara, Provinsi Kalimantan Selatan.

Aplikasi Company Profile ini dibangun dengan teknologi web modern untuk menampilkan profil, dokumentasi kegiatan, dan jadwal agenda Kampung KB dengan performa yang cepat dan desain yang profesional.

🚀 Fitur Utama

• Desain Modern & Profesional: Dibangun dengan antarmuka yang bersih (clean), minim ornamen berlebihan, dan responsif di seluruh perangkat (Mobile, Tablet, Desktop).
• Admin Panel Terintegrasi: Mengelola konten halaman Beranda, Agenda, Sub-Program, hingga pengaturan Footer secara langsung tanpa harus menyentuh kode.
• Hero Banners: Area banner utama untuk menonjolkan setiap program dan kegiatan desa secara interaktif.
• GSAP Animations: Animasi mulus pada carousel galeri kegiatan.
• Otomatisasi Kompresi Gambar: Setiap gambar yang diunggah melalui Admin Panel akan dikompres secara otomatis (ke format WebP) di sisi klien sebelum dikirim ke server, untuk menghemat kuota peyimpanan dan mempercepat loading halaman.
• Vercel Blob Storage: Penyimpanan aset gambar yang efisien dan terintegrasi langsung dengan Vercel.

🛠️ Stack Teknologi Terkini

Aplikasi ini menggunakan teknologi Mutakhir:

• Framework: Next.js 14/15 (App Router)
• Bahasa: TypeScript
• Styling: Tailwind CSS v3
• Komponen UI: Radix UI & shadcn/ui
• Animasi: GSAP (GreenSock) & Framer Motion
• Penyimpanan Gambar: Vercel Blob
• Validasi Data: Zod
• Kompresi Gambar: browser-image-compression

💻 Panduan Instalasi (Development)

Jika Anda ingin menjalankan atau mengembangkan proyek ini di komputer lokal:

1. Clone repository ini:

   git clone <url-repository-anda>
   cd cp_KampungKB_Bestari_Belimbing

2. Instal seluruh dependensi:

   npm install

3. Atur Variabel Lingkungan (Environment Variables): Buat file .env.local di root directory dan tambahkan token akses Vercel Blob Anda:

   BLOB_READ_WRITE_TOKEN="vercel_blob_rw_xxxxx_xxxxxxxxx"

4. Jalankan Server Development:

   npm run dev

5. Akses Halaman: Buka peramban (browser) dan akses http://localhost:3000.

   • Halaman Publik: http://localhost:3000
   • Panel Admin: http://localhost:3000/admin

📦 Deployment ke Vercel

Aplikasi ini sangat dioptimalkan untuk di-deploy menggunakan infrastruktur Vercel.

1. Hubungkan repository GitHub Anda ke Vercel Dashboard.
2. Atur Environment Variables (BLOB_READ_WRITE_TOKEN).
3. Vercel akan secara otomatis membangun (build) dan mempublikasikan versi terbaru dari kode Anda setiap kali Anda melakukan push ke branch utama.

---

Dipersembahkan untuk Desa Belimbing, Kabupaten Hulu Sungai Utara. 🌟