bansos - 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 pull 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 per listing di src/lib/data/bansos/.
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 pull 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/<slug>/    # index.json + README tiap listing
src/lib/data/bansos/contributors/ # profil kontributor
src/lib/data/bansos.ts         # loader, selector, sorting, dan 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 lama (submit publik dinonaktifkan)

Setiap listing wajib memiliki contributorSlug yang terhubung dua arah dengan manifest profil. Avatar diambil otomatis dari GitHub bila tersedia; profil tanpa GitHub tetap tampil memakai dua inisial. Semua tautan nama kontributor di situs mengarah ke profil internal bansos.dev. Konten profil dapat disesuaikan melalui src/lib/data/bansos/contributors/<slug>/README.md. Profil publik memakai URL canonical https://bansos.dev/<slug>/; validator mencegah slug contributor bentrok dengan route situs atau shortlink bansos.

Cara Menambah Bansos

Untuk saat ini, submit publik yang aktif adalah via AI Agent, email, dan Git clone. Jalur form, CLI publik, 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 AI Agent

Install skill resmi bansos.dev agar agent memahami struktur listing, profil contributor, validasi, dan alur PR terbaru:

npx skills add wauputr4/skill-bansos --skill '*' --agent '*'

Setelah terpasang, berikan link sumber dan minta agent memakai $bansos-add-entry. Review data dan diff sebelum membuka pull request.

2. Opsi 2: 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.

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

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

Fork dan clone repositori ini ke komputermu memakai GitHub CLI:
```
gh repo fork wauputr4/bansos --clone
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-slug username-kamu \
  --contributor-name "Nama Kamu" \
  --contributor-url "https://example.com" \
  --tags "Cloud,Gratisan"

Script ini akan memvalidasi data lalu membuat src/lib/data/bansos/<slug>/index.json dan README listing.

Argumen --benefits dan --requirements dipisahkan dengan |. Argumen --tags dipisahkan dengan koma. --contributor-slug wajib pada setiap submit. --contributor-name wajib dan --contributor-url opsional hanya jika profil contributor tersebut belum ada.

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

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 pull 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.