Skip to main content
Dokumentasi di-host di Mintlify (bukan Cloudflare Workers). Domain: docs.sertifikasitrainer.com. Source code: folder apps/docs di monorepo. Konfigurasi utama: docs.json.

Preview lokal

bun run dev:docs
# atau: cd apps/docs && bun run dev
Buka http://localhost:3333 — lokal tidak pakai login (hanya production di dashboard Mintlify).

Deploy ke Mintlify

  1. Login Mintlify Dashboard
  2. Hubungkan repo GitHub → path docs: apps/docs
  3. Set custom domain: docs.sertifikasitrainer.com (DNS di Cloudflare mengarah ke Mintlify)
  4. Setiap push ke main (yang mengubah apps/docs) → auto-redeploy

Docs minta login — cara buka publik

Kalau buka docs.sertifikasitrainer.com di-redirect ke /login, penyebabnya bukan file di repo — melainkan pengaturan Authentication di dashboard Mintlify. Situs saat ini memakai mode Private (Mintlify Auth / password / OAuth). Visitor wajib login dulu.

Opsi A — Semua halaman publik (disarankan)

Untuk docs onboarding yang boleh dibaca siapa saja:
1

Buka Authentication

dashboard.mintlify.com → pilih deployment docs → Authentication
Atau langsung: app.mintlify.com/products/authentication
2

Ubah site visibility

Di bagian Authentication method, ubah Site visibility dari Private menjadi Public.
3

Nonaktifkan metode login

Hapus / matikan:
  • Authenticated (Mintlify Auth — login akun org Mintlify)
  • Password
  • Custom (OAuth / JWT)
4

Save & tunggu redeploy

Klik Save changes. Tunggu deploy selesai (~1–2 menit).
5

Verifikasi

curl -sI https://docs.sertifikasitrainer.com | head -3
Harus tidak redirect ke /login. Buka homepage di browser incognito — langsung tampil tanpa login.
Pengaturan ini hanya bisa diubah di Mintlify Dashboard, tidak lewat docs.json atau GitHub Actions.

Opsi B — Sebagian publik, sebagian private

Kalau tetap mau auth untuk halaman internal saja:
  1. Biarkan site Private + metode auth aktif
  2. Tandai halaman/grup yang boleh dibaca tanpa login di docs.json:
{
  "navigation": {
    "groups": [
      {
        "group": "Mulai",
        "public": true,
        "pages": ["introduction", "quickstart"]
      }
    ]
  }
}
Atau per halaman di frontmatter MDX:
---
title: "Quickstart"
public: true
---
Halaman tanpa public: true tetap butuh login.

Cek cepat: login dari mana?

GejalaPenyebab
URL /login?redirect=...Mintlify Authentication (Private)
Form password MintlifyPassword auth di dashboard
Redirect ke app.mintlify.com/api/end-user-authMintlify Auth (harus anggota org)
Cloudflare Access / Zero TrustBukan Mintlify — cek Cloudflare dashboard

Validasi sebelum push

cd apps/docs
bun run validate
bun run broken-links
Atau dari root: bun run docs:validate