# kienday — sitemap

> reference file for development. update when pages change.
> last updated: 2026-05-27

## static pages

| path | title | section | description |
|------|-------|---------|-------------|
| `/` | trang chủ | — | hero, featured garden notes, latest posts, newsletter |
| `/garden/` | vườn số | khám phá | all garden notes grid with growth stage badges |
| `/notes/` | ghi chép | viết | chronological blog posts |
| `/bookshelf/` | tủ sách | sách | book covers grouped by category (triết học, sức khỏe, văn hóa, thiếu nhi) |
| `/bookshelf/[slug]/` | chi tiết sách | — | individual book page with cover, review, and reading notes |
| `/about/` | về tôi | về | personal bio, quick facts, interests, contact |
| `/now/` | bây giờ | bây giờ | current focus, learning, away from screen |
| `/uses/` | công cụ | công cụ | tools, apps, desk setup, site stack |
| `/projects/` | dự án | dựng | side projects (placeholder) |
| `/colophon/` | colophon | meta | how this site is built, principles |
| `/design-system/` | hệ thống thiết kế | tham khảo | component library, design tokens, copy-to-clipboard |
| `/sitemap/` | sitemap | — | this page — all routes + content inventory |

## dynamic routes

| pattern | source | count |
|---------|--------|-------|
| `/garden/[slug]/` | `src/content/garden/*.mdx` | 4 notes |
| `/notes/[slug]/` | `src/content/notes/*.mdx` | 1 post |
| `/bookshelf/[slug]/` | `src/content/bookshelf/*.mdx` | 9 books |

## content inventory

### garden notes (`src/content/garden/`)

| id | title | stage | planted |
|----|-------|-------|---------|
| `why-digital-garden` | tại sao là vườn số | budding | 2026-05-20 |
| `learning-in-public` | học trong công khai | budding | 2026-05-15 |
| `tools-for-thought` | công cụ cho suy nghĩ | seedling | 2026-05-22 |
| `on-finding-your-taste` | về việc tìm gu thẩm mỹ | seedling | 2026-05-25 |

### blog posts (`src/content/notes/`)

| id | title | date |
|----|-------|------|
| `hello-world` | chào thế giới | 2026-05-26 |

### bookshelf (`src/content/bookshelf/*.mdx`)

| id | title | author | category | rating |
|----|-------|--------|----------|--------|
| `beginning-of-infinity` | the beginning of infinity | david deutsch | triết học | 5 |
| `thinking-in-systems` | thinking in systems | donella meadows | triết học | 5 |
| `naval-ravikant` | the almanack of naval ravikant | eric jorgenson | triết học | 5 |
| `why-we-sleep` | why we sleep | matthew walker | sức khỏe | 5 |
| `breath` | breath | james nestor | sức khỏe | 4 |
| `how-buildings-learn` | how buildings learn | stewart brand | văn hóa | 5 |
| `the-creative-act` | the creative act | rick rubin | văn hóa | 5 |
| `le-petit-prince` | le petit prince | antoine de saint-exupéry | thiếu nhi | 5 |
| `hoang-tu-be` | hoàng tử bé | antoine de saint-exupéry | thiếu nhi | 5 |

each book is an `.mdx` file with full content: review, reading notes, personal experience.

## feeds & meta

| path | type | description |
|------|------|-------------|
| `/rss.xml` | rss | latest notes feed (xml) |
| `/sitemap-index.xml` | sitemap | auto-generated xml sitemap |

## design tokens

defined in `src/styles/global.css`:

```
accent      oklch(0.45 0.12 165)   green, primary
soil        oklch(0.97 0.005 100)  warm cream bg
bark        oklch(0.15 0.006 85)   near-black text
night       oklch(0.13 0.006 90)   dark mode bg
mist        oklch(0.92 0.004 95)   dark mode text
```

### components

- `.garden-card` — content card with hover shadow
- `.growth-badge` / `.growth-seedling` / `.growth-budding` / `.growth-evergreen` — stage indicators
- `.nav-link` — navigation link (no underline, hover accent)
- `.section-label` — uppercase section header label (12px, 600, 0.06em tracking)
- `.data-list` — key-value grid display
- `.skip-link` — accessibility skip-to-content
- `src/components/ThemeToggle.astro` — dark/light mode button
- `src/components/MobileNav.astro` — mobile hamburger menu
- `src/components/Newsletter.astro` — email signup form
- `src/components/SEO.astro` — opengraph + twitter meta

### icons

lucide via `@lucide/astro`: Sun, Moon, Menu, X, Flower, PenLine, Book, BookOpen, BookCheck, BookPlus, User, Clock, Wrench, Sprout, Leaf, TreePine, Mail, Rss, Info, FolderGit, ArrowRight, Compass

## development

```bash
npm run dev       # http://localhost:4321
npm run build     # outputs to dist/
npm run preview   # preview production build
```

- framework: astro 5 + tailwind css 4
- content: markdown + mdx via astro content collections
- deploy: cloudflare pages (auto-deploy from github)
- repo: https://github.com/kien-day/kienday
- domain: kien.day