Lewati ke konten utama

Aplikasi Web

ChurchApps mencakup tiga aplikasi web, masing-masing melayani audiens dan tujuan yang berbeda. Ketiganya berbagi fondasi teknologi yang sama, yaitu React 19, TypeScript, dan Material-UI 7, tetapi berbeda dalam alat build dan target deployment.

Sekilas Pandang Aplikasi​

AplikasiTujuanFrameworkPort Pengembangan
B1AdminDasbor administrasi gerejaReact 19 + Vite + MUI 75173
B1AppAplikasi anggota gereja untuk publikNext.js 16 + React 19 + MUI 73301
LessonsAppPengelolaan konten pelajaranNext.js 16 + React 193501

Tumpukan Teknologi Bersama​

Ketiga aplikasi web dibangun dengan:

  • TypeScript -- Keamanan tipe menyeluruh (end-to-end)
  • React 19 -- Pustaka komponen UI
  • Material-UI 7 -- Sistem desain dan kumpulan komponen
  • React Query 5 -- Pengelolaan state server

Komponen Bersama​

Aplikasi-aplikasi ini berbagi komponen UI dan utilitas melalui keluarga paket @churchapps/apphelper*:

PaketTujuan
@churchapps/apphelperKomponen React bersama inti
@churchapps/apphelper-loginKomponen UI autentikasi
@churchapps/apphelper-donationsFormulir donasi dan pemberian
@churchapps/apphelper-formsKomponen pembuat formulir
@churchapps/apphelper-markdownRender Markdown
@churchapps/apphelper-websiteKomponen situs web/CMS
tip

Untuk detail tentang pengembangan paket bersama ini secara lokal, lihat dokumentasi AppHelper.

Skrip Postinstall​

Setiap aplikasi web memiliki skrip postinstall yang menyalin file locale dan aset CSS dari @churchapps/apphelper ke dalam proyek. Skrip ini berjalan otomatis setelah npm install.

info

Jika komponen tampak tanpa gaya setelah memasang dependensi, skrip postinstall mungkin tidak berjalan dengan benar. Anda dapat menjalankannya secara manual dengan npm run postinstall.

Alat Build​

Aplikasi menggunakan dua alat build yang berbeda:

  • B1Admin menggunakan Vite -- bundler modern yang cepat, ideal untuk aplikasi satu halaman (single-page application)
  • B1App dan LessonsApp menggunakan Next.js -- menyediakan server-side rendering, routing berbasis file, dan build produksi yang dioptimalkan