behind the Hideout

Docs

How this site is put together: the stack, the path a post takes from an MDX file to a page, and the design pieces it is drawn with.

What it runs on

Read from package.json at build time, so these versions are the ones this build used.
  • 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

From MDX file to page

Every post is a file in src/contents/posts/{en,id}. At build time each file becomes a static page, an OG image and three share images, and lands in the pagination and the sitemap. Media in public/media is pushed to Cloudinary by a workflow run by hand.
Diagram: MDX posts go through getAllBlogPaths, generateStaticParams and next build, and come out as the post page, og.png, share images, pagination pages and the sitemap. public/media goes to Cloudinary through the cloudinary workflow.
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;

About revalidation: the On Demand Revalidation workflow runs src/scripts/app:revalidate.ts, which reads sitemap.xml and calls /api/revalidate. This repo has no such route in src/app right now, so that workflow has nothing to call. Pages change when the site is built again.

The pages

  • /docs/content-pipeline

    Content pipeline

    Static pagination, OG and share images, ID/EN slugs, series, sitemap and the GitHub workflows, from the code.

  • /docs/colors

    Colors

    daisyUI tokens and the soft tokens, light and dark side by side, with measured contrast ratios.

  • /docs/typography

    Typography

    The four fonts and what each is for, the heading scale, and article prose with the real styles.

  • /docs/components

    Components

    Live components: card, pill buttons, banner, zoomable image, code block, hero terminal.