bansos.dev

Bantuan sosial untuk developer jelata

bansos.dev adalah open-source katalog promo developer Indonesia untuk menemukan domain gratis, hosting free-tier, cloud credits, API credits, database credits, startup credits, diskon tools coding, dan program gratisan lain yang relevan buat developer.

Situs ini dibangun sebagai static SvelteKit site yang SEO-friendly, data-driven, dan mudah dikontribusikan lewat CLI 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 terstruktur di src/lib/data/bansos.json.
• SEO metadata untuk halaman publik, termasuk meta description dan social card pattern.
• Workflow kontribusi via npx bansosdev add, GitHub issue, dan Pull Request otomatis.
• Halaman kontribusi publik: bansos.dev/contribute.
• Terms and conditions: bansos.dev/terms.

Tech stack

• SvelteKit static site
• TypeScript
• Vite
• GitHub Pages
• GitHub Actions untuk CI dan workflow kontribusi data
• bansosdev CLI untuk submit listing baru

Deploy dan domain

Deploy produksi berjalan lewat GitHub Pages dari workflow .github/workflows/deploy-pages.yml. Repository ini tidak membutuhkan token Cloudflare untuk deploy.

Jika memakai Cloudflare sebagai DNS untuk custom domain, arahkan DNS ke GitHub Pages dan gunakan mode DNS only sampai verifikasi domain dan sertifikat HTTPS GitHub Pages aktif. Jangan menyimpan CLOUDFLARE_API_TOKEN atau CLOUDFLARE_ACCOUNT_ID di GitHub Actions secrets untuk deploy situs ini.

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 npx bansosdev
.github/workflows/             # CI, add-entry automation, publish CLI

Cara menambah bansos

Ada dua cara:

1. Via CLI

Jalankan ini, nanti CLI akan mengembalikan URL issue GitHub yang siap dikirim. Kalau payload valid, GitHub Actions akan membuat Pull Request otomatis dari issue tersebut:

npx bansosdev add \
  --id contoh-bansos \
  --title "Contoh Bansos Developer" \
  --provider "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" \
  --status active

Parameter validity

• --validity-type wajib: pilih fixed, uncertain, atau forever.
• --validity-date wajib jika --validity-type fixed, memakai format YYYY-MM-DD.
• --validity-desc opsional untuk catatan masa berlaku, kuota, atau syarat khusus.
• --published-at opsional untuk tanggal publikasi entry dalam format YYYY-MM-DD.
• --source opsional untuk sumber verifikasi; bisa berupa URL atau teks biasa.

Cek payload JSON

npx bansosdev add ... --mode json

Lokal

npm run add:bansos -- \
  --id contoh-bansos \
  --title "Contoh Bansos Developer" \
  --provider "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"

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

2. Maintainer mode

Jika punya token maintainer, gunakan mode direct:

BANSOSDEV_GITHUB_TOKEN=ghp_xxx npx bansosdev add ... --mode direct

Token perlu punya akses repository yang cukup untuk memicu workflow. Mode ini membuat Pull Request otomatis; merge ke main akan memicu deploy GitHub Pages.

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 CLI, buka issue dari URL yang muncul, lalu tunggu PR otomatis dari bot.
• Jika lebih nyaman, tambahkan melalui branch dan Pull Request manual.
• Baca panduan kontribusi lengkap di CONTRIBUTING.

Kode etik komunitas

Ikuti Code of Conduct.

Lisensi

MIT. Lihat LICENSE.

Contributors