feat: initial theme scaffold

- Repo metadata: theme.toml, README, Apache-2.0 license
- Hugo defaults: vi language, post permalinks, taxonomies, paginate, TOC config
- exampleSite skeleton with themesDir wiring
- CI: Hugo build + Pagefind index + Pages deploy
- Pagefind devDependency in package.json (Dependabot weekly)
- vi i18n strings, default archetype
- Empty layouts/_partials/_markup/_shortcodes directories ready for Phase 3

themes/tsuki/.github/dependabot.yml

@@ -0,0 +1,21 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+      - npm
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+      - github-actions

themes/tsuki/.github/workflows/pages.yml

@@ -0,0 +1,63 @@
+name: Build and deploy exampleSite
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      HUGO_VERSION: 0.154.0
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+
+      - name: Setup Hugo (extended)
+        uses: peaceiris/actions-hugo@v3
+        with:
+          hugo-version: ${{ env.HUGO_VERSION }}
+          extended: true
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build site
+        working-directory: exampleSite
+        run: hugo --gc --minify --baseURL "https://tiennm99.github.io/tsuki/"
+
+      - name: Build Pagefind index
+        run: npx pagefind --site exampleSite/public
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: exampleSite/public
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

themes/tsuki/.gitignore

@@ -0,0 +1,26 @@
+# Hugo build artifacts
+/public/
+/resources/
+.hugo_build.lock
+
+# exampleSite build artifacts
+exampleSite/public/
+exampleSite/resources/
+exampleSite/.hugo_build.lock
+exampleSite/static/pagefind/
+
+# Pagefind generated index
+static/pagefind/
+
+# Node
+node_modules/
+npm-debug.log*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Editors
+.vscode/
+.idea/
+*.swp

themes/tsuki/README.md

@@ -0,0 +1,64 @@
+# tsuki (月)
+
+[![build](https://github.com/tiennm99/tsuki/actions/workflows/pages.yml/badge.svg)](https://github.com/tiennm99/tsuki/actions/workflows/pages.yml)
+[![license](https://img.shields.io/github/license/tiennm99/tsuki)](LICENSE)
+[![Hugo](https://img.shields.io/badge/hugo-%E2%89%A50.146-ff4088?logo=hugo)](https://gohugo.io)
+
+A Hugo blog + personal portfolio theme. The homepage *is* the portfolio — bio, featured projects, recent posts. Posts live at `/post/`. Vietnamese-first typography, View Transitions on navigation, Pagefind search, Giscus comments.
+
+> 月 (*tsuki*): the moon. Quiet, observed, returned to. Companion to [`bonsai`](https://github.com/tiennm99/bonsai) in the same naming family.
+
+**→ [Live demo](https://tiennm99.github.io/tsuki/)** (after first deploy)
+
+## Status
+
+🚧 **Under construction** — initial scaffold. See [the implementation plan](https://github.com/tiennm99/miti99/tree/main/plans) for what's coming.
+
+## Features
+
+- **Blog** — posts, tags, categories, year-grouped archive
+- **Personal portfolio on the homepage** — driven by `data/profile.yaml` + `data/projects.yaml`, no separate `/portfolio` section
+- **Search** — [Pagefind](https://pagefind.app), zero-runtime, indexed at build time
+- **Comments** — [Giscus](https://giscus.app) (GitHub Discussions)
+- **Vietnamese-first** — diacritic-safe typography, native vi date formats, Be Vietnam Pro fallback
+- **Dark mode** — `prefers-color-scheme` + persistent toggle, no flash of wrong theme
+- **View Transitions API** — smooth same-document navigation in supporting browsers
+- **No build step** — pure Hugo + browser ES modules. No SCSS, no TypeScript, no bundler in the theme.
+- **Light** — target ≤ 15 KB CSS gzipped, ≤ 8 KB JS gzipped (excluding Pagefind UI)
+
+## Quick start
+
+### As a git submodule
+
+```bash
+git submodule add https://github.com/tiennm99/tsuki.git themes/tsuki
+```
+
+Add to your site's `hugo.yaml`:
+
+```yaml
+theme: tsuki
+```
+
+### As a Hugo Module
+
+```bash
+hugo mod init github.com/<you>/<your-site>
+hugo mod get github.com/tiennm99/tsuki
+```
+
+Then add to `hugo.yaml`:
+
+```yaml
+module:
+  imports:
+    - path: github.com/tiennm99/tsuki
+```
+
+## Configuration
+
+Documented in [`docs/config.md`](docs/config.md) (coming soon). For now, see `exampleSite/hugo.yaml` and `exampleSite/data/`.
+
+## License
+
+[Apache-2.0](LICENSE)

themes/tsuki/archetypes/default.md

@@ -0,0 +1,7 @@
+---
+title: "{{ replace .Name "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+tags: []
+categories: []
+---

themes/tsuki/exampleSite/content/_index.md

@@ -0,0 +1,3 @@
+---
+title: tsuki
+---

themes/tsuki/exampleSite/hugo.yaml

@@ -0,0 +1,9 @@
+baseURL: https://tiennm99.github.io/tsuki/
+languageCode: vi
+defaultContentLanguage: vi
+title: tsuki — example
+themesDir: ../..
+theme: tsuki
+
+params:
+  description: Example site for the tsuki Hugo theme.

themes/tsuki/hugo.yaml

@@ -0,0 +1,33 @@
+languageCode: vi
+defaultContentLanguage: vi
+
+paginate: 10
+paginatePath: page
+
+taxonomies:
+  category: categories
+  tag: tags
+
+permalinks:
+  post: /:year/:month/:day/:slug/
+
+markup:
+  goldmark:
+    renderer:
+      unsafe: true
+  highlight:
+    noClasses: false
+    lineNos: false
+  tableOfContents:
+    startLevel: 2
+    endLevel: 4
+
+params:
+  search:
+    enable: true
+  comments:
+    giscus:
+      enable: false
+  toc:
+    enable: true
+    minWordCount: 400

themes/tsuki/i18n/vi.yml

@@ -0,0 +1,47 @@
+- id: readingTime
+  translation: "{{ .Count }} phút đọc"
+
+- id: postedOn
+  translation: "Đăng vào"
+
+- id: updatedOn
+  translation: "Cập nhật"
+
+- id: tags
+  translation: "Thẻ"
+
+- id: categories
+  translation: "Chuyên mục"
+
+- id: archive
+  translation: "Lưu trữ"
+
+- id: search
+  translation: "Tìm kiếm"
+
+- id: searchPlaceholder
+  translation: "Tìm bài viết..."
+
+- id: recentPosts
+  translation: "Bài viết gần đây"
+
+- id: featuredProjects
+  translation: "Dự án nổi bật"
+
+- id: viewAll
+  translation: "Xem tất cả"
+
+- id: tableOfContents
+  translation: "Mục lục"
+
+- id: previousPage
+  translation: "Trang trước"
+
+- id: nextPage
+  translation: "Trang tiếp"
+
+- id: noResults
+  translation: "Không có kết quả."
+
+- id: copyright
+  translation: "© {{ .Year }} {{ .Author }}"

themes/tsuki/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "tsuki",
+  "version": "0.1.0",
+  "description": "tsuki — Hugo blog + personal portfolio theme",
+  "license": "Apache-2.0",
+  "private": true,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tiennm99/tsuki.git"
+  },
+  "devDependencies": {
+    "pagefind": "^1.4.0"
+  }
+}

themes/tsuki/theme.toml

@@ -0,0 +1,18 @@
+name = "tsuki"
+license = "Apache-2.0"
+licenselink = "https://github.com/tiennm99/tsuki/blob/main/LICENSE"
+description = "月 — Hugo blog + personal portfolio theme. Vietnamese-first typography, View Transitions API, Pagefind search, Giscus comments. Companion to bonsai."
+homepage = "https://github.com/tiennm99/tsuki"
+demosite = "https://tiennm99.github.io/tsuki/"
+tags = ["blog", "portfolio", "personal", "minimal", "dark", "vietnamese", "pagefind", "view-transitions"]
+features = ["blog", "portfolio", "search", "comments", "dark-mode", "responsive", "i18n", "rss"]
+min_version = "0.146.0"
+
+[author]
+  name = "Tien Nguyen"
+  homepage = "https://miti99.com"
+
+[original]
+  author = ""
+  homepage = ""
+  repo = ""