wauputr4/bansos - Project IndopenSource

README

bansos.dev

🇮🇩 Indonesia (Default) · 🌐 English

🌏 Bahasa Indonesia (Default)

Bantuan sosial untuk developer jelata

bansos.dev adalah open-source katalog info bagi-bagi berkah, promo gratisan, dan diskonan tools coding paling legit khusus untuk developer jelata di Indonesia. Dibuat biar portofolio kita-kita tetep menyala walau dompet lagi sekarat. Nyari domain gratis, hosting free-tier, cloud credits, API credits, database gratisan, atau startup credits? Di sini tempat ngumpulnya! 100% Gratisan, No Clickbait, No Ribet. fr fr 🚀

Situs ini dibangun sebagai static SvelteKit site yang super SEO-friendly, data-driven, aman di mode terang/gelap, dan gampang banget buat dikontribusikan lewat email atau merge request.

Keyword cepat

bansos developer, promo developer Indonesia, domain gratis, cloud credits gratis, API credits, hosting free tier, startup credits, developer tools gratis, open source Indonesia, SvelteKit static site.

Fitur utama

Katalog bansos developer yang crawlable dan mudah dicari.
Listing domain gratis, cloud gratis, hosting free-tier, API credits, database credits, dan benefit startup.
Halaman detail dengan provider, benefit, syarat klaim, masa berlaku, status aktif/expired, dan link resmi.
Filter tag dan highlight rekomendasi/terbaru.
Data terstruktur di src/lib/data/bansos.json.
SEO metadata untuk halaman publik, termasuk meta description dan social card pattern.
Workflow kontribusi publik via email dan Git clone.
Halaman kontribusi publik: bansos.dev/contribute.
Terms and conditions: bansos.dev/terms.

Deploy dan Hosting

Situs ini di-deploy dan di-hosting menggunakan Cloudflare Pages dengan adapter @sveltejs/adapter-cloudflare. Setiap kali ada merge request atau push ke branch main, Cloudflare secara otomatis memicu build dan mendistribusikan situs statis super cepat beserta seluruh dynamic OG image yang sudah di-prerender.

Menjalankan proyek

npm install
npm run dev
npm run build

Validasi lokal:

npm run check
npm run lint

Struktur penting

src/lib/data/bansos.json       # data utama listing bansos
src/lib/data/bansos.ts         # helper selector, sorting, dan contributor stats
src/lib/components/            # komponen UI reusable
src/routes/list/               # halaman list dan detail bansos
src/routes/contribute/         # panduan kontribusi publik
scripts/add-bansos.mjs         # script lokal tambah data
packages/bansosdev-cli/        # CLI bansosdev (disabled untuk submit publik)

Cara Menambah Bansos

Untuk saat ini, submit publik yang aktif adalah via email dan Git clone. Jalur form, npx CLI, dan bot dinonaktifkan sementara karena spam.

[!TIP] Soon: Submisi via Discord & Telegram Bot! Kami sedang membangun integrasi bot agar kamu bisa mengirimkan bansos baru secara otomatis langsung dari server Discord atau channel Telegram. Sembari menunggu, yuk gabung ke komunitas kami:

Discord Server untuk ngobrol, diskusi, dan submit via chat (coming soon).

Telegram Channel untuk dapetin update instan promo developer terbaru langsung di HP-mu.

1. Opsi 1: Lewat Email

Opsi ini sangat cocok buat kamu yang ingin berbagi info dengan cepat tanpa perlu menyentuh terminal.

Buka halaman kontribusi di browser: bansos.dev/contribute.
Pilih tab Email.
Kirim usulan ke submit@bansos.dev memakai template yang tersedia.
Pastikan semua field penting terisi: judul, provider, benefit, syarat klaim, link resmi, status, sumber, dan kontributor.

2. Opsi 2: Lewat Command Line (npx CLI) - Dinonaktifkan

Submit publik via npx bansosdev add sedang dinonaktifkan sementara karena spam. Dokumentasi CLI tetap disimpan untuk maintainer dan pengujian lokal, tetapi jangan dipakai untuk submit publik saat ini.

npx bansosdev add

CLI akan menuntunmu mengisi field demi field untuk menyiapkan data lokal.

Kamu juga bisa mengirimkan data langsung menggunakan argumen CLI:

npx bansosdev add \
  --id contoh-bansos \
  --title "Contoh Bansos Developer" \
  --provider "Example Provider" \
  --description "Deskripsi singkat bansos." \
  --benefits "Benefit satu|Benefit dua" \
  --validity-type fixed \
  --validity-date 2026-06-30 \
  --validity-desc "Berlaku khusus pelajar" \
  --published-at 2026-06-13 \
  --requirements "Buat akun|Klaim program" \
  --cta-link "https://example.com" \
  --contributor-name "Nama Kamu" \
  --contributor-url "https://example.com" \
  --tags "Cloud,Gratisan"

Parameter validity

--validity-type wajib: pilih fixed, uncertain, atau forever.
--validity-date wajib jika --validity-type fixed, memakai format YYYY-MM-DD (Berfungsi sebagai Tanggal Berakhir).
--validity-desc opsional untuk catatan masa berlaku, kuota, atau syarat khusus.
--published-at opsional untuk tanggal mulai berlaku (start date) dalam format YYYY-MM-DD. Default adalah hari ini.
--source opsional untuk sumber verifikasi; bisa berupa URL atau teks biasa.

Catatan Otomatisasi:

Parameter provider akan diekstrak secara otomatis dari domain cta-link.

Parameter status akan dihitung otomatis (active, upcoming, atau expired) berdasarkan tanggal published-at dan validity-date.

Cek payload JSON

npx bansosdev add ... --mode json

3. Opsi 3: Lewat Git Clone (Manual Merge Request)

Opsi ini bagi kamu yang ingin menguji kode secara lokal atau memodifikasi file secara langsung.

Clone repositori ini ke komputermu:

git clone https://gitlab.com/wauputr4/bansos.git
cd bansos
npm install

Tambahkan data secara lokal menggunakan helper script:

npm run add:bansos -- \
  --id contoh-bansos \
  --title "Contoh Bansos Developer" \
  --provider "Example Provider" \
  --description "Deskripsi singkat bansos." \
  --benefits "Benefit satu|Benefit dua" \
  --validity-type fixed \
  --validity-date 2026-06-30 \
  --requirements "Buat akun|Klaim program" \
  --cta-link "https://example.com" \
  --contributor-name "Nama Kamu" \
  --contributor-url "https://example.com" \
  --tags "Cloud,Gratisan"

Script ini akan memvalidasi data dan menyimpannya di file data terstruktur src/lib/data/bansos.json.

Argumen --benefits dan --requirements dipisahkan dengan |. Argumen --tags dipisahkan dengan koma.

Buat branch baru, tambahkan commit, push ke fork, dan kirim merge request ke repositori utama.

Maintainer mode (Khusus Admin / Maintainer)

Mode direct untuk submit otomatis sedang dinonaktifkan. Untuk perubahan maintainer, gunakan Git clone, commit manual, dan merge request ke main.

npx bansosdev add ... --mode json

Perintah di atas hanya untuk mengecek payload JSON secara lokal.

Detail lengkap CLI lihat docs/bansosdev-cli.md.

Panduan kualitas listing

Listing yang baik sebaiknya menyertakan:

Link resmi provider atau halaman program.
Benefit yang spesifik, misalnya nominal credit, durasi, atau batas kuota.
Syarat klaim yang jelas.
Status aktif, expired, atau upcoming.
Tag yang membantu pencarian, misalnya Cloud, Domain, AI Credits, Startup, atau No Credit Card.
Nama dan URL kontributor.

Kontribusi

Kirim data lewat email ke submit@bansos.dev.
Jika lebih nyaman, tambahkan melalui branch dan merge request manual.
Baca panduan kontribusi lengkap di CONTRIBUTING.

Kode etik komunitas

Ikuti Code of Conduct.

Sponsor & Dukungan

Proyek bansos.dev dibangun secara gratis oleh komunitas. Jika proyek ini membantumu menghemat budget developer-mu, silakan kirim dukungan via email ke me@wau.my.id.

[!NOTE] Soon: Kami berencana menghadirkan fitur di mana donatur/pengunjung bisa mengirimkan dukungan (donasi) langsung ke masing-masing kontributor yang mendaftarkan/menulis listing bansos tersebut.

Lisensi

MIT. Lihat LICENSE.

Disclaimer

bansos.dev adalah platform komunitas open-source yang bertujuan membantu sesama developer Indonesia menemukan program bantuan sosial yang sah dan legal dari provider resmi. Kami tidak terafiliasi dengan provider mana pun.

Kami dengan tegas melarang:

Penyalahgunaan informasi bansos untuk tujuan abuse atau mengeksploitasi celah kebijakan provider.
Pelanggaran terhadap ketentuan layanan (ToS) platform atau provider pihak ketiga.
Tindakan yang melanggar privasi data individu atau organisasi.
Segala bentuk tindakan ilegal atau melanggar hukum yang berlaku.
Submit informasi bansos yang palsu, menyesatkan, atau tidak bisa diklaim.

Semua informasi yang ditampilkan bersifat referensi. Selalu verifikasi langsung ke situs resmi provider sebelum melakukan klaim. Kami tidak bertanggung jawab atas perubahan kebijakan sepihak dari provider, interpretasi manfaat yang keliru, ataupun penyalahgunaan informasi oleh pihak tidak bertanggung jawab.

Dengan menggunakan bansos.dev, Anda menyetujui bahwa platform ini hanyalah katalog komunitas dan segala klaim, transaksi, atau interaksi dengan provider sepenuhnya merupakan tanggung jawab pribadi masing-masing pengguna.