di balik Hideout

Docs

Gimana site ini dirakit: stack-nya, jalan sebuah post dari file MDX sampai jadi page, dan potongan design yang dipakai buat ngegambarnya.

Jalan di atas apa

Dibaca dari package.json waktu build, jadi versi di sini ya versi yang dipakai build ini.
  • next16.2.9

    App Router, static params, ImageResponse for OG images

  • react19.2.7

    UI

  • tailwindcss4.3.1

    styles, theme tokens as utilities

  • daisyui5.6.3

    gading-light and gading-dark themes, primitives

  • mdx-bundler9.2.1

    compiles each post at build time

  • typescript5.9.3

    types

  • cloudinary^2.7.0

    media sync script (devDependency)

  • swr-global-state^2.2.0

    small shared client state

Dari file MDX sampai jadi page

Tiap post itu satu file di src/contents/posts/{en,id}. Waktu build, tiap file jadi static page, satu OG image dan tiga share image, terus masuk ke pagination dan sitemap. Media di public/media di-push ke Cloudinary lewat workflow yang dijalanin manual.
Diagram: post MDX lewat getAllBlogPaths, generateStaticParams dan next build, keluar jadi post page, og.png, share image, page pagination dan sitemap. public/media masuk ke Cloudinary lewat workflow cloudinary.
src/modules/Content/services/content-parser.ts
export async function getAllBlogPaths() {
  const paths = await Promise.all(Object.keys(I18n).map(getAllBlogMeta));
  return paths.flat(1).map(({ meta, locale }) => ({
    lang: locale,
    slug: meta.slugOriginal
  }));
}
src/app/(base)/[lang]/blog/[slug]/page.ts
export const dynamic = 'force-static';

export const dynamicParams = false;

export const generateStaticParams = generateBlogPathsWithLang;

Soal revalidation: workflow On Demand Revalidation ngejalanin src/scripts/app:revalidate.ts, yang baca sitemap.xml terus manggil /api/revalidate. Sekarang repo ini nggak punya route itu di src/app, jadi workflow-nya nggak punya apa-apa buat dipanggil. Page berubah waktu site di-build ulang.

Halaman-halamannya

  • /docs/content-pipeline

    Content pipeline

    Static pagination, OG dan share image, slug ID/EN, series, sitemap dan workflow GitHub, langsung dari code-nya.

  • /docs/colors

    Warna

    Token daisyUI dan soft token, light dan dark berdampingan, lengkap dengan contrast ratio yang dihitung.

  • /docs/typography

    Typography

    Empat font dan tugasnya masing-masing, heading scale, dan prose artikel pake style aslinya.

  • /docs/components

    Components

    Component yang hidup: card, pill button, banner, gambar yang bisa di-zoom, code block, hero terminal.