@hutusi/amytis 1.5.6 → 1.6.0

package/CHANGELOG.md

@@ -0,0 +1,94 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.6.0] - 2026-02-20
+
+### Added
+- **Search Engine Upgrade**: Migrated from Fuse.js to **Pagefind** for high-performance, static full-text search with extremely low client-side overhead.
+- **Enhanced Search UI**:
+  - Full-content search with context highlighting and excerpts.
+  - Type-based filtering tabs (All, Post, Flow, Book).
+  - Recent searches history persisted in local storage.
+  - Interactive search tips panel with syntax hints.
+  - Advanced keyboard navigation (Tab-based focus trap, arrow keys, Alt+number shortcuts).
+  - Debounced input and visual loading states.
+  - Full-screen responsive layout for mobile devices.
+- **Search Utilities**: New unit-tested utility library for processing search results and metadata.
+- **Project Documentation**: Added a comprehensive `CHANGELOG.md` documenting the project's evolution from 1.0.0.
+
+### Changed
+- **Documentation Overhaul**: Streamlined `TODO.md` roadmap and updated `GEMINI.md` and `ARCHITECTURE.md` to reflect the new search architecture.
+- **i18n**: Fully localized search interface supporting both English and Chinese.
+
+### Fixed
+- **Hydration**: Suppressed body-level hydration warnings caused by browser extensions.
+- **Search Precision**: Improved title cleaning and date extraction for search results.
+
+## [1.5.6] - 2026-02-19
+
+### Added
+- **Scoped Publishing**: Transitioned to `@hutusi/amytis` for official release on npm and GitHub.
+- **Trusted Publishing**: Implemented secure OIDC-based deployment for npm.
+- **Engineering Quality**: Added `bun run validate` to integrate linting, testing, and building.
+
+### Changed
+- **Refined DX**: Cleaned up all linting warnings and optimized interactive components with `requestAnimationFrame` cleanup.
+- **Better Accessibility**: Improved `MarkdownRenderer` semantics by preserving native `<p>` tags.
+
+### Fixed
+- **Hydration & Stability**: Resolved all React 19 hydration mismatches in `LanguageProvider`, `Hero`, and `ThemeToggle`.
+- **Content Fixes**: Corrected mangled LaTeX formulas and resolved duplicated frontmatter mapping keys.
+
+## [1.5.0] - 2026-02-18
+
+### Added
+- **Daily Notes (Flows)**: A new stream-style content format for micro-blogging and quick thoughts.
+- **Full-text Search**: Migrated to **Pagefind** for high-performance static full-text indexing.
+- **Metadata Inheritance**: Implemented logic for posts to inherit attributes from series metadata.
+
+### Changed
+- **Major Tech Upgrade**: Modernized architecture to **Next.js 16 (App Router)** and **React 19**.
+- **UI Overhaul**: Redesigned homepage with horizontal scroll featured sections and distinct card styles.
+- **Austere Elegance**: New design for Archive and Tags pages focusing on minimalism.
+
+## [1.4.0] - 2026-02-10
+
+### Added
+- **Books Feature**: Support for structured, multi-chapter long-form content.
+- **Reading Progress**: Integrated sticky progress bar and scroll tracking.
+- **Import Tooling**: New CLI commands for PDF and image folder ingestion.
+
+## [1.3.0] - 2026-02-05
+
+### Added
+- **Internationalization (i18n)**: Native support for English and Chinese with language switching.
+- **Smart Reading Time**: Multilingual character counting for accurate estimates.
+- **Author Pages**: Detailed statistics and contribution tracking.
+
+## [1.2.0] - 2026-01-30
+
+### Added
+- **Series Management**: Robust support for manual ordering and folder-based structures.
+- **Rich Code Blocks**: Syntax highlighting for 11+ languages with copy-to-clipboard.
+
+## [1.1.0] - 2026-01-20
+
+### Added
+- **Testing Suite**: Integrated Vitest/Bun Test with 64+ automated tests.
+- **Integrations**: Support for Giscus comments and multiple analytics providers (Umami/Plausible).
+
+## [1.0.0] - 2026-01-12
+
+### Added
+- **Initial Release**: Launch of **Amytis**, a high-performance digital garden and blog engine.
+- **Next.js Foundation**: Built on App Router for optimal static site generation (SSG).
+- **Advanced Markdown**: Native support for GFM, Mermaid diagrams, and LaTeX math.
+- **Refined Typography**: High-contrast typefaces and optimized readability.
+- **Theming System**: Four built-in palettes (`default`, `blue`, `rose`, `amber`) with Dark Mode.
+- **Content Organization**: Flexible flat-file and nested-folder post structures.
+- **Smart Discovery**: Client-side search, tag clouds, and chronological archives.
+- **SEO & Performance**: Automated Sitemap/RSS generation and optimized WebP delivery.

package/CLAUDE.md

@@ -22,7 +22,7 @@ bun test path/to/file.test.ts  # Run a single test file
 
 # Build
 bun run build              # Full production build (copies assets, builds Next.js, optimizes images)
-bun run build:dev          # Development build (no image optimization, faster)
+bun run build:dev          # Development build (no image optimization, faster) — also regenerates Pagefind search index in public/pagefind/
 bun run clean              # Remove .next, out, public/posts directories
 
 # Content creation
@@ -58,6 +58,7 @@ bun run new-flow --mdx              # Use .mdx format instead
 
 - `site.config.ts` - Site configuration (nav, social, pagination, themes, i18n, analytics, comments)
 - `src/lib/markdown.ts` - Data access layer with all content query functions
+- `src/lib/search-utils.ts` - Pure search utilities (URL type detection, date extraction, title cleaning, markdown stripping) shared by `Search` and the search index route
 - `src/app/globals.css` - Theme CSS variables and color palettes
 - `src/components/MarkdownRenderer.tsx` - MDX rendering with all plugins
 - `src/i18n/translations.ts` - Language strings for i18n
@@ -187,7 +188,7 @@ chapters:
 - `SeriesCatalog` - Timeline-style series post listing with numbered entries and progress indicator
 - `SeriesSidebar` - Series navigation sidebar with progress bar and color-coded states
 - `SeriesList` - Mobile-optimized series navigation matching sidebar design
-- `Search` - Client-side fuzzy search (Cmd/Ctrl+K) using Fuse.js
+- `Search` - Full-text search (Cmd/Ctrl+K) powered by Pagefind (build-time index); features type filter tabs (All/Post/Flow/Book), recent searches, keyboard navigation (arrows + number keys), debounced input, body scroll lock, focus trap, ARIA accessibility, and search syntax tips (`"phrase"`, `-exclude`)
 - `TableOfContents` - Sticky TOC with scroll tracking, reading progress, and back-to-top
 - `MarkdownRenderer` - MDX rendering with GFM, math, syntax highlighting, diagrams
 - `CoverImage` - Optimized image component with WebP support

package/GEMINI.md

@@ -1,14 +1,16 @@
 # Amytis Project Context
 
 ## Project Overview
-**Amytis** is a high-performance, elegant digital garden and blog engine built with **Next.js 16 (App Router)**, **React 19**, and **Tailwind CSS v4**. It is designed for cultivating thoughts and sharing knowledge with a focus on typography, readability, and flexible content organization.
+**Amytis** (@hutusi/amytis) is a high-performance, elegant digital garden and blog engine built with **Next.js 16 (App Router)**, **React 19**, and **Tailwind CSS v4**. It is designed for cultivating thoughts and sharing knowledge with a focus on typography, readability, and flexible content organization.
+
+The package is officially published to both **npm** and **GitHub Packages** with automated **Trusted Publishing** (OIDC).
 
 ### Main Technologies
 - **Framework**: Next.js 16 (App Router)
 - **Runtime/Package Manager**: [Bun](https://bun.sh/)
 - **Styling**: Tailwind CSS v4 with CSS-variable based themes and `@tailwindcss/typography`.
 - **Content**: Local MDX/Markdown files with Zod-validated frontmatter.
-- **Search**: Client-side fuzzy search using `Fuse.js`.
+- **Search**: Static full-text search using `Pagefind`.
 - **Diagrams**: Native support for `Mermaid` diagrams.
 - **Math**: LaTeX support via `rehype-katex`.
 
@@ -23,7 +25,7 @@ bun dev
 ```bash
 bun run build
 ```
-Generates a fully optimized static site in the `out/` directory.
+Generates a fully optimized static site in the `out/` directory with Pagefind search index.
 
 ### Linting & Testing
 ```bash
@@ -37,10 +39,10 @@ bun test
   - `posts/`: Paginated post listing and individual post routes.
   - `flows/`: Stream-style daily notes or micro-blogging (`[year]/[month]/[day]`).
   - `series/`: Series overview and individual series catalog pages with pagination support.
+  - `books/`: Books overview and individual book/chapter pages (`[slug]/[chapter]`).
   - `archive/`: Timeline-based chronological archive grouped by year and month.
   - `tags/`: Popularity-sorted tag cloud and filtered listings.
   - `authors/`: Posts filtered by individual authors.
-  - `search.json/`: Static search index generator.
 - `src/lib/`: Core logic and utilities.
   - `markdown.ts`: Advanced parsing for posts/series/flows, sorting, reading time calculation (multilingual), and metadata inheritance.
 - `src/components/`: Modular UI blocks (Hero, HorizontalScroll, Search, CoverImage, etc.).
@@ -70,6 +72,7 @@ bun test
 ### Build Pipeline
 - **Asset Mapping**: `scripts/copy-assets.ts` mirrors content assets to the public folder, handling relative path resolution for both flat and nested structures.
 - **Image Optimization**: Fully integrated with `next-image-export-optimizer` for optimized WebP delivery in static exports.
+- **Search Indexing**: `Pagefind` runs after build to generate a static search index from the output directory.
 
 ## Recent Updates
 - Added **Flows** feature: a stream for daily notes and micro-blogging.

package/README.md

@@ -9,7 +9,7 @@
 ## Features
 
 - **Digital Garden Philosophy:** Non-linear navigation through tags, series, authors, books, flows, and chronological archives.
-- **Fuzzy Search:** Instant, client-side search across all posts (Cmd/Ctrl+K) powered by Fuse.js.
+- **Full-text Search:** Fast, static client-side search across all content (Cmd/Ctrl+K) powered by Pagefind.
 - **Structured Content:**
   - **Series:** Multi-part content organization with manual or automatic ordering.
   - **Books:** Long-form content with explicit chapters, parts, and a dedicated reading interface.

package/TODO.md

@@ -1,76 +1,25 @@
-# Future Roadmap
-
-## 🚀 High Priority (Next Steps)
-
-- [ ] **User Experience (UX)**
-  - [ ] **Code Blocks**: Add a "Copy to Clipboard" button.
-  - [ ] **Images**: Implement a Lightbox or Zoom-on-click feature.
-  - [ ] **Navigation**: Add Breadcrumbs (e.g., `Home > Category > Post`).
-  - [ ] **Navigation**: Add Previous/Next post links at the bottom of articles.
-
-## 🌿 Digital Garden Features
-
-- [ ] **Knowledge Graph**:
-  - [ ] **Backlinks**: Show "Pages that link here" at the bottom of posts.
-  - [ ] **Wiki-links**: Support `[[Internal Link]]` syntax.
-
-## 🔮 Future Enhancements
-
-- [ ] **Performance & App**
-  - [ ] **PWA**: Add `manifest.json` and service workers for offline support.
-  - [ ] **Search Optimization**: Optimize search index for large gardens (e.g. content segmentation).
-
-- [ ] **Visuals**
-  - [ ] **Dynamic OG Images**: Generate custom social cards with post title using `@vercel/og` (Satori).
-
-- [ ] **CLI Enhancements**
-  - [ ] **Interactive Mode**: Use prompts to select series, tags, and layouts when creating new posts.
-
-## ✅ Completed
-
-- [x] **Content Types**
-  - [x] **Flows**: Stream-style daily notes or micro-blogging.
-  - [x] **Books**: Structured long-form content with chapters.
-
-- [x] **Engagement**
-  - [x] **Comments**: Integrate Giscus (GitHub Discussions) for comments.
-
-- [x] **Engineering**
-  - [x] **Validation**: Add Zod schema validation for content frontmatter to prevent build errors.
-  - [x] **Testing**: Add E2E tests for the new search and navigation features.
-
-- [x] **SEO & Discovery**
-  - [x] Generate `sitemap.xml` for search engines.
-  - [x] Generate `rss.xml` / `atom.xml` for feed readers.
-  - [x] Add Open Graph (OG) meta tags for social sharing.
-
-- [x] **Navigation & UX**
-  - [x] Implement a client-side fuzzy Search bar (Command+K).
-  - [x] Add a sticky Table of Contents (TOC) with Unicode/Multilingual support.
-  - [x] Add "Reading Time" estimate to post headers.
-  - [x] Refine link styling (clean default, underline on hover).
-  - [x] **Hero Section**: Configurable, collapsible welcome mat.
-  - [x] **Themes**: Configurable color palettes (default, blue, rose, amber).
-  - [x] **i18n**: Client-side language switcher infrastructure.
-
-- [x] **Content & Architecture**
-  - [x] **Series**: Robust support for grouping related posts (file-based & folder-based).
-  - [x] **Series**: Manual sorting, cross-referencing, and configurable order.
-  - [x] **Related Posts**: Auto-suggest relevant articles.
-  - [x] **Cover Images**: Support local paths, external URLs, and generated text covers.
-  - [x] **Analytics**: Privacy-friendly configuration (Umami/Plausible/Google).
-
-- [x] **Performance**
-  - [x] Static Image Optimization (`next-image-export-optimizer`).
-  - [x] Automated image dimension injection.
-
-- [x] **CLI Tools**
-  - [x] `bun run new` script for scaffolding posts.
-  - [x] `bun run new-series` script for scaffolding series.
-
-- [x] **UI Polish & Refinements**
-  - [x] **Animations**: Define missing animation classes.
-  - [x] **Color Contrast**: Improve accessibility.
-  - [x] **Responsive Grids**: Improve mobile/tablet layouts.
-  - [x] **Archive Timeline**: Refine CSS.
-  - [x] **Loading States**: Add skeleton loaders.
+# Amytis Roadmap
+
+## 🚀 Immediate UX & Polish
+- [ ] **Interactive Code**: Add "Copy to Clipboard" buttons to code blocks.
+- [ ] **Image Zoom**: Implement medium-zoom or a lightbox for MDX images.
+- [ ] **Breadcrumbs**: Add path navigation (e.g., `Home > Books > Chapter`) to all pages.
+- [ ] **Smart Nav**: Add "Previous" and "Next" article links at the bottom of posts.
+
+## 🌿 Digital Garden Evolution
+- [ ] **Backlinks**: Automatically list "Pages that link here" at the bottom of articles.
+- [ ] **Wiki-links**: Support `[[internal-link]]` syntax for easier cross-referencing.
+- [ ] **Recent Notes**: Integrate a "Recent Flows" section on the homepage.
+
+## 🛠 Performance & Social
+- [ ] **Dynamic OG**: Generate automated social cards with Satori based on post titles.
+- [ ] **PWA**: Add a manifest and service worker for basic offline reading support.
+- [ ] **Search UI**: Refine Pagefind results with highlighted context and better mobile layout.
+
+## ✅ Completed Highlights
+- [x] **Full-text Search**: Migrated to **Pagefind** for high-performance static indexing.
+- [x] **Multi-format Content**: Native support for **Posts**, **Series**, **Books**, and **Flows**.
+- [x] **Scoped Publishing**: Official release as `@hutusi/amytis` on npm and GitHub.
+- [x] **Robust Engineering**: Zero hydration mismatches, full Zod validation, and 64+ automated tests.
+- [x] **Refined UI**: High-contrast typography, four color palettes, and horizontal featured scrolling.
+- [x] **Asset Pipeline**: Automatic co-located image mapping and WebP optimization.

package/bun.lock

@@ -7,7 +7,6 @@
       "dependencies": {
         "@giscus/react": "^3.1.0",
         "@tailwindcss/typography": "^0.5.19",
-        "fuse.js": "^7.1.0",
         "github-slugger": "^2.0.0",
         "gray-matter": "^4.0.3",
         "image-size": "^2.0.2",
@@ -38,6 +37,7 @@
         "babel-plugin-react-compiler": "1.0.0",
         "eslint": "^9.0.0",
         "eslint-config-next": "16.1.6",
+        "pagefind": "^1.4.0",
         "pdf-to-img": "^5.0.0",
         "tailwindcss": "^4.1.18",
         "typescript": "^5.9.3",
@@ -257,6 +257,18 @@
 
     "@nolyfill/is-core-module": ["@nolyfill/is-core-module@1.0.39", "", {}, "sha512-nn5ozdjYQpUCZlWGuxcJY/KpxkWQs4DcbMCmKojjyrYDEAGy4Ce19NN4v5MduafTwJlbKc99UA8YhSVqq9yPZA=="],
 
+    "@pagefind/darwin-arm64": ["@pagefind/darwin-arm64@1.4.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-2vMqkbv3lbx1Awea90gTaBsvpzgRs7MuSgKDxW0m9oV1GPZCZbZBJg/qL83GIUEN2BFlY46dtUZi54pwH+/pTQ=="],
+
+    "@pagefind/darwin-x64": ["@pagefind/darwin-x64@1.4.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-e7JPIS6L9/cJfow+/IAqknsGqEPjJnVXGjpGm25bnq+NPdoD3c/7fAwr1OXkG4Ocjx6ZGSCijXEV4ryMcH2E3A=="],
+
+    "@pagefind/freebsd-x64": ["@pagefind/freebsd-x64@1.4.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-WcJVypXSZ+9HpiqZjFXMUobfFfZZ6NzIYtkhQ9eOhZrQpeY5uQFqNWLCk7w9RkMUwBv1HAMDW3YJQl/8OqsV0Q=="],
+
+    "@pagefind/linux-arm64": ["@pagefind/linux-arm64@1.4.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-PIt8dkqt4W06KGmQjONw7EZbhDF+uXI7i0XtRLN1vjCUxM9vGPdtJc2mUyVPevjomrGz5M86M8bqTr6cgDp1Uw=="],
+
+    "@pagefind/linux-x64": ["@pagefind/linux-x64@1.4.0", "", { "os": "linux", "cpu": "x64" }, "sha512-z4oddcWwQ0UHrTHR8psLnVlz6USGJ/eOlDPTDYZ4cI8TK8PgwRUPQZp9D2iJPNIPcS6Qx/E4TebjuGJOyK8Mmg=="],
+
+    "@pagefind/windows-x64": ["@pagefind/windows-x64@1.4.0", "", { "os": "win32", "cpu": "x64" }, "sha512-NkT+YAdgS2FPCn8mIA9bQhiBs+xmniMGq1LFPDhcFn0+2yIUEiIG06t7bsZlhdjknEQRTSdT7YitP6fC5qwP0g=="],
+
     "@rtsao/scc": ["@rtsao/scc@1.1.0", "", {}, "sha512-zt6OdqaDoOnJ1ZYsCYGt9YmWzDXl4vQdKTyJev62gFhRGKdx7mcT54V9KIjg+d2wi9EXsPvAPKe7i7WjfVWB8g=="],
 
     "@swc/helpers": ["@swc/helpers@0.5.15", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-JQ5TuMi45Owi4/BIMAJBoSQoOJu12oOk/gADqlcUL9JEdHB8vyjUSsxqeNXnmXHjYKMi2WcYtezGEEhqUI/E2g=="],
@@ -767,8 +779,6 @@
 
     "functions-have-names": ["functions-have-names@1.2.3", "", {}, "sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ=="],
 
-    "fuse.js": ["fuse.js@7.1.0", "", {}, "sha512-trLf4SzuuUxfusZADLINj+dE8clK1frKdmqiJNb1Es75fmI5oY6X2mxLVUciLLjxqw/xr72Dhy+lER6dGd02FQ=="],
-
     "generator-function": ["generator-function@2.0.1", "", {}, "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g=="],
 
     "gensync": ["gensync@1.0.0-beta.2", "", {}, "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg=="],
@@ -1173,6 +1183,8 @@
 
     "package-manager-detector": ["package-manager-detector@1.6.0", "", {}, "sha512-61A5ThoTiDG/C8s8UMZwSorAGwMJ0ERVGj2OjoW5pAalsNOg15+iQiPzrLJ4jhZ1HJzmC2PIHT2oEiH3R5fzNA=="],
 
+    "pagefind": ["pagefind@1.4.0", "", { "optionalDependencies": { "@pagefind/darwin-arm64": "1.4.0", "@pagefind/darwin-x64": "1.4.0", "@pagefind/freebsd-x64": "1.4.0", "@pagefind/linux-arm64": "1.4.0", "@pagefind/linux-x64": "1.4.0", "@pagefind/windows-x64": "1.4.0" }, "bin": { "pagefind": "lib/runner/bin.cjs" } }, "sha512-z2kY1mQlL4J8q5EIsQkLzQjilovKzfNVhX8De6oyE6uHpfFtyBaqUpcl/XzJC/4fjD8vBDyh1zolimIcVrCn9g=="],
+
     "parent-module": ["parent-module@1.0.1", "", { "dependencies": { "callsites": "^3.0.0" } }, "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g=="],
 
     "parse-entities": ["parse-entities@4.0.2", "", { "dependencies": { "@types/unist": "^2.0.0", "character-entities-legacy": "^3.0.0", "character-reference-invalid": "^2.0.0", "decode-named-character-reference": "^1.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0", "is-hexadecimal": "^2.0.0" } }, "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw=="],

package/docs/ARCHITECTURE.md

@@ -75,7 +75,7 @@ src/app/
 
 ### Navigation & Discovery
 - **`TableOfContents`** - Sticky TOC with scroll-based tracking.
-- **`Search`** - Client-side fuzzy search modal (Cmd/Ctrl+K).
+- **`Search`** - Full-text search modal (Cmd/Ctrl+K) powered by Pagefind. Supports type filter tabs (All/Post/Flow/Book), recent searches, keyboard navigation, debounced input, focus trap, and ARIA accessibility. Search syntax: `"exact phrase"`, `word1 word2` (AND), `-exclude`.
 - **`Pagination`** - Previous/Next page navigation.
 - **`ReadingProgressBar`** - Top-of-page progress bar for book chapters.
 
@@ -100,4 +100,5 @@ Theming is handled by `next-themes` and Tailwind CSS v4. `src/app/globals.css` d
 
 1. **`scripts/copy-assets.ts`** - Copies images from content directories (`posts/`, `series/`, `books/`, `flows/`) to `public/posts/` for static hosting.
 2. **`next build`** - Next.js static export to `out/`.
-3. **`next-image-export-optimizer`** - Generates optimized WebP variants.
+3. **`next-image-export-optimizer`** - Generates optimized WebP variants (production build only).
+4. **`pagefind --site out`** - Crawls the exported HTML and builds a full-text search index in `out/pagefind/`. The index is loaded at runtime by `src/components/Search.tsx` via a dynamic import. Pure utility functions used by the search component and the search index route live in `src/lib/search-utils.ts`.

package/docs/CONTRIBUTING.md

@@ -13,6 +13,8 @@
    ```
    Open [http://localhost:3000](http://localhost:3000).
 
+   > **Search in dev:** The search index is generated by `pagefind` at build time. Run `bun run build:dev` once to generate `public/pagefind/`. After that, the search modal (Cmd/Ctrl+K) will work while `bun dev` is running. Re-run `bun run build:dev` whenever content changes.
+
 ## Writing Content
 
 ### Creating Posts
@@ -74,8 +76,8 @@ bun run test:e2e           # Run end-to-end tests
 ## Building
 
 ```bash
-bun run build              # Production build
-bun run build:dev          # Development build (faster)
+bun run build              # Production build (includes image optimization and Pagefind index)
+bun run build:dev          # Development build (faster, no image optimization; also generates Pagefind index)
 ```
 
 ## Code Style

package/docs/deployment.md

@@ -17,7 +17,7 @@ bun run build:dev
 bun run clean && bun run build
 ```
 
-The `out/` directory contains plain HTML, CSS, JS, and images — ready to be served by any static file server.
+The `out/` directory contains plain HTML, CSS, JS, images, and the Pagefind search index (`out/pagefind/`) — ready to be served by any static file server.
 
 ### Preview Locally
 
@@ -190,6 +190,11 @@ server {
         add_header Cache-Control "public";
     }
 
+    # Cache Pagefind search index (regenerated on each build, so short TTL is fine)
+    location /pagefind/ {
+        add_header Cache-Control "public, max-age=3600";
+    }
+
     # trailingSlash is true, so pages are slug/index.html
     # Redirect URLs without trailing slash to add one (except files)
     location / {
@@ -228,6 +233,9 @@ yourdomain.com {
     @postassets path /posts/*
     header @postassets Cache-Control "public, max-age=2592000"
 
+    @pagefind path /pagefind/*
+    header @pagefind Cache-Control "public, max-age=3600"
+
     handle_errors {
         rewrite * /404/index.html
         file_server

package/eslint.config.mjs

@@ -12,6 +12,8 @@ const eslintConfig = defineConfig([
     "out/**",
     "build/**",
     "next-env.d.ts",
+    // Generated at build time — not authored code
+    "public/pagefind/**",
   ]),
 ]);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hutusi/amytis",
-  "version": "1.5.6",
+  "version": "1.6.0",
   "description": "A high-performance digital garden and blog engine with Next.js 16 and Tailwind CSS v4",
   "repository": {
     "type": "git",
@@ -14,8 +14,8 @@
   "packageManager": "bun@1.3.4",
   "scripts": {
     "dev": "next dev",
-    "build": "bun scripts/copy-assets.ts && next build && next-image-export-optimizer",
-    "build:dev": "bun scripts/copy-assets.ts && next build",
+    "build": "bun scripts/copy-assets.ts && next build && next-image-export-optimizer && pagefind --site out",
+    "build:dev": "bun scripts/copy-assets.ts && next build && pagefind --site out --output-path public/pagefind",
     "validate": "bun run lint && bun run test && bun run build:dev",
     "clean": "rm -rf .next out public/posts public/books public/flows",
     "new": "bun scripts/new-post.ts",
@@ -35,7 +35,6 @@
   "dependencies": {
     "@giscus/react": "^3.1.0",
     "@tailwindcss/typography": "^0.5.19",
-    "fuse.js": "^7.1.0",
     "github-slugger": "^2.0.0",
     "gray-matter": "^4.0.3",
     "image-size": "^2.0.2",
@@ -66,6 +65,7 @@
     "babel-plugin-react-compiler": "1.0.0",
     "eslint": "^9.0.0",
     "eslint-config-next": "16.1.6",
+    "pagefind": "^1.4.0",
     "pdf-to-img": "^5.0.0",
     "tailwindcss": "^4.1.18",
     "typescript": "^5.9.3"

package/public/next-image-export-optimizer-hashes.json

@@ -1,7 +1,4 @@
 {
     "posts/02-routing-mastery/assets/m-p-model.png": "fDmvlEkZnE-UCvPK4gmDkJD7SU8coOTl4iw5hpsmcWI=",
-    "posts/advanced-markdown/images/m-p-model.png": "BdYG3Wq+FcOnoSrZeJeb6x2V-LsB-gwvms3WQJFq+Wg=",
-    "posts/part-1/images/m-p-model.png": "94OaqjvkCmDcz+Iuhw14vHXYUzYl3Y8+wwoU1CQZ6l0=",
-    "posts/part-2-rich-content/images/m-p-model.png": "Vp5bOs9N2OHHjMM2PFntkkCl1uY7DleLymwrSHbecOA=",
     "/screenshot.png": "dGCNrjp1oMIL3NrVh1VDW0K+7Pp-cI5KH6tW4-6o9zg="
 }

package/src/app/flows/[year]/[month]/[day]/page.tsx

@@ -62,7 +62,7 @@ export default async function FlowPage({ params }: { params: Promise<{ year: str
         <article className="flex-1 min-w-0">
           {/* Header */}
           <header className="mb-8">
-            <time className="text-sm font-mono text-accent">{flow.date}</time>
+            <time className="text-sm font-mono text-accent" data-pagefind-meta="date[content]">{flow.date}</time>
             <h1 className="mt-2 text-3xl md:text-4xl font-serif font-bold text-heading">{flow.title}</h1>
           </header>
 

package/src/app/layout.tsx

@@ -88,6 +88,7 @@ export default function RootLayout({
       <body
         className={`${inter.variable} ${baskerville.variable} font-sans min-h-screen transition-colors duration-300`}
         data-palette={siteConfig.themeColor}
+        suppressHydrationWarning
       >
         {/* Skip to main content link for accessibility */}
         <a

package/src/app/search.json/route.ts

@@ -1,4 +1,5 @@
 import { getAllPosts, getAllBooks, getBookChapter, getAllFlows } from '@/lib/markdown';
+import { stripMarkdown } from '@/lib/search-utils';
 
 export const dynamic = 'force-static';
 
@@ -12,6 +13,7 @@ export async function GET() {
     excerpt: post.excerpt,
     category: post.category,
     tags: post.tags,
+    content: stripMarkdown(post.content),
   }));
 
   // Add book chapters to search index
@@ -27,6 +29,7 @@ export async function GET() {
           excerpt: chapter.excerpt || '',
           category: 'Book',
           tags: [],
+          content: stripMarkdown(chapter.content),
         });
       }
     }
@@ -42,6 +45,7 @@ export async function GET() {
       excerpt: flow.excerpt,
       category: 'Flow',
       tags: flow.tags,
+      content: stripMarkdown(flow.content),
     });
   }