Dokumentasi

Panduan lengkap untuk mengelola dan mengembangkan platform ibedes.

Arsitektur Sistem

Tech stack & infrastruktur

Manajemen Blog

Membuat & mengedit artikel

Deployment

Deploy ke Netlify

Arsitektur Sistem

Tech Stack

Framework

Astro 5.16 - Static Site Generator dengan SSR

Dipilih untuk performa tinggi dan fleksibilitas multi-framework.

Styling

Tailwind CSS 4.0 - Utility-first CSS

Design system kustom dengan estetika retro-gaming.

Konten

Markdown + JSON - File-based CMS

Artikel dalam .md, produk dalam JSON, dikelola via GitHub.

Hosting

Netlify - Platform deployment serverless

Auto-deploy dari GitHub dengan edge functions.

Cara Kerja

1

Admin Panel → Edit konten via interface web di /admin

2

GitHub API → Perubahan di-commit ke repository otomatis

3

Netlify → Deteksi perubahan dan trigger build

4

Build → Astro generate HTML statis + server functions

5

Deploy → Website live dalam ~2 menit

Struktur Project 

ibedes/
├── src/
│   ├── components/       # Komponen UI reusable
│   ├── layouts/          # Layout halaman
│   ├── pages/            # Routes & halaman
│   │   ├── blog/         # Artikel blog (.md)
│   │   ├── admin/        # Panel admin
│   │   └── api/          # API endpoints
│   ├── styles/           # Global CSS
│   ├── lib/              # Utilities & helpers
│   └── data/             # Data JSON (produk, dll)
├── public/               # Aset statis
├── astro.config.mjs      # Konfigurasi Astro
├── netlify.toml          # Pengaturan Netlify
└── package.json          # Dependencies

Manajemen Blog

Membuat Artikel Baru

1

Akses Editor

Buka /admin/editor atau klik "New Article" di dashboard.

2

Isi Metadata

  • Filename: Gunakan lowercase dengan hyphen
  • Title: Judul artikel
  • Description: Ringkasan SEO (150-160 karakter)
  • Date: Tanggal publikasi
  • Featured Image: Gambar hero (opsional)
3

Tulis Konten

Gunakan sintaks Markdown di editor. Mendukung heading, list, link, gambar, code block.

4

Hubungkan Produk Afiliasi (Opsional)

Pilih produk relevan dari sidebar untuk ditampilkan di artikel.

5

Simpan & Publikasi

Klik "Simpan" untuk commit ke GitHub. Perubahan live dalam ~2 menit.

Referensi Markdown

Heading 

# Heading 1
## Heading 2
### Heading 3

Penekanan 

**teks tebal**
*teks miring*
~~coret~~

List 

- Item tidak berurut
- Item lainnya

1. Item berurut
2. Item lainnya

Link & Gambar 

[Teks link](https://url.com)
![Alt text](gambar.jpg)

Code Block 

```javascript
const hello = "world";
console.log(hello);
```

Deployment

Konfigurasi Netlify

Build Command: npm run build

Publish Directory: dist

Node Version: 18+

Functions: Enabled (untuk admin API endpoints)

Environment Variables

GITHUB_TOKEN - Personal access token untuk GitHub API

GITHUB_OWNER - Username pemilik repository

GITHUB_REPO - Nama repository

ADMIN_USER - Username admin panel

ADMIN_PASSWORD - Password admin panel

Set di Netlify Dashboard → Site Settings → Environment Variables

Workflow Deployment

Automatic Deployment

Setiap push ke branch main memicu build baru di Netlify.

Build Time

Biasanya 1-2 menit untuk rebuild seluruh website.

Preview Deployments

Pull request mendapat URL preview unik untuk testing.

Resource Tambahan

Design System

Warna, tipografi, spacing, dan library komponen

Changelog

Riwayat versi dan update fitur

GitHub Repository

Lihat source code dan kontribusi

Dapatkan Bantuan

Hubungi untuk pertanyaan dan support