๐ŸคOpen Source Community

Bantu STORIQ Tumbuh

STORIQ adalah proyek open source karya anak bangsa. Bantuan dalam bentuk laporan bug, perbaikan kode, penambahan framework, maupun sekadar koreksi dokumentasi sangat kami apresiasi!

โญ

Punya akun GitHub? Dukungan sederhana berupa satu bintang (Star) dari kamu sangat berarti untuk menyemangati kami dan membantu STORIQ menjangkau lebih banyak kreator.

Star di GitHub
๐Ÿ”€

Git Workflow

Kami menggunakan alur kerja cabang standar untuk menjaga stabilitas kode produksi.

BranchFungsi
mainProduction. Hanya rilis stabil yang di-merge ke branch ini.
developmentIntegrasi fitur baru sebelum rilis stabil.
feature/*Pengembangan fitur spesifik. Dibuat dari development dan di-PR ke development.
fix/*Perbaikan bug spesifik (hotfix). Dibuat dari main atau development.
feature/nama-fitur → development → main (tag vX.Y.Z)
๐Ÿ’ป

Setup Lingkungan Dev

Jalankan perintah berikut di terminal Anda untuk menjalankan STORIQ di komputer lokal:

bash / terminal
# 1. Clone repository
git clone https://github.com/andrean-lp/storiq.git
cd storiq

# 2. Install dependensi
npm install

# 3. Jalankan server lokal development
npm run dev

# Aplikasi akan berjalan di http://localhost:4321/storiq/
๐Ÿงช

Testing & Build

npm run build

Menjalankan compile statis Astro untuk memastikan seluruh halaman dan komponen bebas dari syntax/type error.

npm run preview

Menjalankan preview server lokal dari folder hasil build /dist untuk menguji performa riil.

๐Ÿ“‹

Checklist Pull Request

Sebelum mengirimkan Pull Request, mohon pastikan hal-hal berikut sudah terpenuhi:

  • โœ“Jalankan npm run build untuk memastikan seluruh halaman ter-compile tanpa error.
  • โœ“Format kode rapi dan konsisten sesuai kaidah Astro & Tailwind CSS.
  • โœ“Tulis judul dan deskripsi PR yang jelas (jelaskan apa masalahnya & solusi yang dibuat).
  • โœ“Sertakan referensi Issue terkait (misal: "Fixes #12").
  • โœ“Sertakan tangkapan layar (screenshot) sebelum/sesudah jika mengubah tampilan antarmuka (UI).

Siap Berkontribusi?

Mulai dari issue berlabel "good first issue" atau ajukan ide perbaikanmu langsung di repositori GitHub STORIQ.