Blog yang menampilkan usaha, organisasi, perusahaan, dan tempat-tempat menarik di Kalimantan Selatan.
From Banua adalah platform yang dibuat untuk memperkenalkan berbagai entitas di Kalimantan Selatan. Tujuan utama dari platform ini adalah mendokumentasikan dan mempromosikan ber BA37 bagai usaha lokal, organisasi, perusahaan, dan tempat-tempat menarik yang ada di Kalimantan Selatan.
Fitur utama:
- Katalog data usaha, organisasi, perusahaan, dan tempat di Kalimantan Selatan
- Filtering berdasarkan kategori
- Pencarian dan pengurutan data
- Tampilan detail untuk setiap entitas
- UI yang intuitif dan modern terinspirasi dari Product Hunt
Proyek ini dibangun menggunakan:
- Elixir - Bahasa pemrograman yang digunakan
- Phoenix Framework - Framework web
- Tailwind CSS v4 - Untuk styling dan UI
- HTMX - Untuk interaksi dinamis pada sisi klien
Pastikan Anda memiliki beberapa hal berikut terinstal:
- Elixir (versi 1.14 atau lebih baru)
- Erlang/OTP (versi 25 atau lebih baru)
- Node.js (versi 16 atau lebih baru)
- NPM atau Yarn
Clone repositori ini:
git clone https://github.com/raizora/frombanua.git
cd frombanuaInstal dependensi:
mix deps.get
npm install --prefix assetsUntuk menjalankan server Phoenix dalam mode development:
mix phx.serverAtau di dalam IEx (Interactive Elixir):
iex -S mix phx.serverKunjungi localhost:4000 dari browser Anda untuk mengakses aplikasi.
Data entitas disimpan dalam format JSON di lib/frombanua/data/borneo_data.json dengan struktur:
{
"items": [
{
"id": 1,
"name": "Nama Entitas",
"category": "usaha|organisasi|perusahaan|tempat",
"description": "Deskripsi entitas...",
"image_url": "URL gambar",
"location": "Lokasi",
"founded_at": "Tahun berdiri",
"website": "URL website",
"tags": ["tag1", "tag2"],
"votes": 100
}
]
}Untuk menambahkan entitas baru, cukup tambahkan ke array items dalam file JSON tersebut.
Aplikasi ini menggunakan struktur standar Phoenix dengan beberapa modifikasi:
frombanua/
├── assets/ # Aset statis (CSS, JS)
├── lib/
│ ├── frombanua/ # Kode bisnis
│ │ ├── data/ # Data JSON
│ │ └── borneo.ex # Modul untuk operasi data
│ ├── frombanua_web/ # Kode web
│ │ ├── controllers/ # Controller dan template
│ │ ├── components/ # Komponen web yang dapat digunakan kembali
│ │ └── router.ex # Definisi rute
├── priv/ # Aset yang dikompilasi dan file statis
└── test/ # Unit dan integrasi test
- Data disimpan dalam format JSON di
lib/frombanua/data/borneo_data.json - Modul
Frombanua.Borneomenyediakan fungsi-fungsi untuk mengakses dan memfilter data - Controller
FrombanuaWeb.BorneoControllermenangani request HTTP dan mengolah data - Template di
borneo_html/digunakan untuk menampilkan data ke pengguna
- Instal flyctl
- Login ke Fly.io:
fly auth login
- Siapkan aplikasi:
fly launch
- Deploy:
fly deploy
- Instal Gigalixir CLI
- Login:
gigalixir login
- Buat aplikasi:
gigalixir create
- Push kode:
git push gigalixir master
- Instal Heroku CLI
- Login:
heroku login
- Buat aplikasi:
heroku create --buildpack hashnuke/elixir
- Deploy:
git push heroku main
From Banua adalah proyek open source yang diinisiasi oleh Raizora dan terbuka untuk kontribusi dari komunitas. Kami sangat mengapresiasi bantuan dalam bentuk:
- Penambahan data entitas dari Kalimantan Selatan
- Perbaikan bug
- Penambahan fitur
- Peningkatan UI/UX
- Dokumentasi
Silakan buat pull request atau buka issue jika Anda ingin berkontribusi.
Proyek ini dilisensikan di bawah lisensi MIT - lihat file LICENSE untuk detail lebih lanjut.