@hutusi/amytis 1.9.0 → 1.10.0

package/.entire/settings.json

@@ -0,0 +1,4 @@
+{
+  "enabled": true,
+  "telemetry": false
+}

package/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.10.0] - 2026-03-02
+
+### Added
+- **Configurable URL Topology**: Added support for `posts.basePath` and `series.customPaths` so posts and series can be served under custom prefixes.
+- **Single-Language Mode**: Added `i18n.enabled` to disable multilingual routing/UI when running a single-locale site.
+- **Homepage Content Controls**: Added pinned-post support and optional post subtitles for improved featured and latest sections.
+- **Author Profile Expansion**: Added configurable default authors plus optional author avatar/social images and header/card visibility toggles.
+- **Publishing Controls**: Added `posts.excludeFromListing` to keep selected series posts out of the main `/posts` feed.
+- **Deployment & Media**: Added one-command Linux/nginx deploy script and `images.cdnBaseUrl` support for serving images from a CDN.
+- **Branding Controls**: Added configurable logo and favicon paths in `site.config.ts`.
+
+### Changed
+- **Homepage Design System**: Refined homepage layout and card hierarchy across hero, featured content, latest writing, and series sections.
+- **Subscribe Surface**: Moved `/subscribe` to content-driven authoring so users can fully edit subscription copy in Markdown/MDX.
+- **Documentation**: Updated architecture, deployment, and configuration guides to reflect current routing and feature behavior.
+
+### Fixed
+- **Static Export Stability**: Fixed `output: "export"` edge cases by returning placeholder params for empty/disabled dynamic routes.
+- **Dynamic Routing Conflicts**: Resolved route naming and generation conflicts for custom prefixes and static params.
+- **Navigation Consistency**: Fixed mismatch between navigation post URL and configured posts base path.
+- **Book Route Safety**: Prevented invalid book chapter params by validating chapter existence before route generation.
+- **Image Handling**: Fixed markdown image path resolution across content types and ensured CDN prefixing is applied consistently.
+- **Rendering & Type Safety**: Fixed TypeScript handling for custom `rss-feed` element and addressed dev-time WebP 404 behavior.
+
 ## [1.9.0] - 2026-02-28
 
 ### Added

package/CLAUDE.md

@@ -25,6 +25,9 @@ bun run build              # Full production build (copies assets, builds Next.j
 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
 
+# Deploy
+bun run deploy             # Deploy out/ to Linux/nginx server via rsync+sshpass (reads .env.local)
+
 # Content creation
 bun run new "Post Title"              # Create new post
 bun run new-series "Series Name"      # Create new series
@@ -49,6 +52,7 @@ bun run sync-book <slug>              # Sync chapters list for one book
 
 - `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/urls.ts` - Central URL helpers (`getPostUrl`, `getPostsBasePath`, `getSeriesCustomPaths`, etc.) — always use these instead of hardcoding `/posts/[slug]`
 - `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
@@ -74,7 +78,9 @@ bun run sync-book <slug>              # Sync chapters list for one book
 - `/flows/[year]` - Flows filtered by year
 - `/flows/[year]/[month]` - Flows filtered by month
 - `/flows/[year]/[month]/[day]` - Single flow detail page
-- `/[slug]` - Static pages (about, etc.)
+- `/[slug]` - Static pages (about, subscribe, etc.) and custom posts/series listing pages
+- `/[prefix]/[slug]` - Posts at custom URL prefixes (e.g. `/articles/my-post`, `/weeklies/my-post`)
+- `/[prefix]/page/[page]` - Paginated listing at custom URL prefixes
 
 ### Content Structure
 
@@ -96,6 +102,7 @@ Key configuration options:
 - `nav` - Navigation links with weights
 - `social` - GitHub, Twitter, email links for footer
 - `series.navbar` - Series slugs to show in navbar dropdown
+- `series.customPaths` - Per-series custom URL prefix e.g. `{ 'weeklies': 'weeklies' }` → posts at `/weeklies/[slug]`
 - `pagination.posts`, `pagination.series` - Items per page
 - `themeColor` - 'default' | 'blue' | 'rose' | 'amber'
 - `hero` - Homepage hero title and subtitle
@@ -104,6 +111,12 @@ Key configuration options:
 - `featured.stories` - Scrollable stories: `scrollThreshold` (default: 1), `maxItems` (default: 5)
 - `analytics.provider` - 'umami' | 'plausible' | 'google' | null
 - `comments.provider` - 'giscus' | 'disqus' | null
+- `posts.basePath` - Custom URL prefix for all posts (default: `'posts'`); e.g. `'articles'` → posts at `/articles/[slug]`
+- `posts.authors.default` - Fallback authors when a post has none set in frontmatter
+- `posts.authors.showInHeader` - Show author byline below post title (default: true)
+- `posts.authors.showAuthorCard` - Show author card at end of post (default: true)
+- `posts.excludeFromListing` - Series slugs whose posts are hidden from `/posts` listing pages
+- `authors` - Per-author profiles: `bio`, `avatar` (image path), `social` (array of `{ image, description }`)
 
 ## Content Frontmatter
 
@@ -120,6 +133,7 @@ authors: ["Author Name"]
 series: "series-slug"      # Link to a series
 draft: true                # Hidden in production
 featured: true             # Show in featured section
+pinned: true               # Always shown in featured section; never shuffled away (hero = most recent pinned)
 coverImage: "./images/cover.jpg"  # Local or external URL
 latex: true                # Enable KaTeX math
 toc: false                 # Hide table of contents

package/README.md

@@ -1,11 +1,24 @@
 # Amytis
 
-**Amytis** is a high-performance, elegant digital garden built with Next.js 16, React 19, and Tailwind CSS v4. It is designed for cultivating thoughts, sharing knowledge, and growing ideas with a focus on typography and readability.
+[English](README.md) | [简体中文](README.zh.md)
+
+**Amytis** is an elegant, open-source framework for building a personal digital garden: a living knowledge space where ideas grow from raw notes to refined writing. It is built with Next.js 16, React 19, and Tailwind CSS v4, with a strong focus on readability, structure, and long-term content ownership.
 
 [**Live Demo**](https://amytis.vercel.app/)
 
 ![Amytis Screenshot](public/screenshot.png)
 
+## The Knowledge Ladder
+
+Amytis is built around a simple path from rough to refined:
+
+- **Flow**: Capture raw daily thoughts and fragments.
+- **Articles**: Refine one idea into a clear essay.
+- **Series**: Connect related articles into a curated narrative.
+- **Books**: Distill mature knowledge into structured chapters and parts.
+
+Each stage builds on the previous one, so your garden can evolve naturally.
+
 ## Features
 
 - **Digital Garden Philosophy:** Non-linear navigation through tags, series, authors, books, flows, and chronological archives.
@@ -48,6 +61,14 @@
 - **Content CLI Tools:** Create posts, series, and import from PDFs or image folders.
 - **Modern Stack:** Next.js 16, React 19, Tailwind CSS v4, TypeScript 5, Bun.
 
+## Design Philosophy
+
+- **Elegance by default**: Typography, spacing, and color should feel intentional out of the box.
+- **Content over configuration**: Writing and publishing should be simple file-based workflows, not CMS-heavy setup.
+- **Markdown-first, not markdown-limited**: Keep authoring portable while supporting rich output (math, diagrams, code, wikilinks).
+- **Ship what you need**: Features are modular through `site.config.ts`; disable sections you do not use.
+- **Plain text, long-term ownership**: Content stays in Markdown/MDX so it remains versionable and portable.
+
 ## Quick Start
 
 1. **Install Dependencies:**
@@ -75,67 +96,48 @@
 ## CLI Commands
 
 ```bash
-# Development
-bun dev                    # Start dev server at localhost:3000
-bun run lint               # Run ESLint
-
-# Build
-bun run build              # Full production build (copy assets + Next.js build + image optimization)
-bun run build:dev          # Development build (no image optimization, faster)
-bun run clean              # Remove .next, out, public/posts directories
-
-# Testing
-bun test                   # Run all tests
-bun run test:unit          # Run unit tests (src/)
-bun run test:int           # Run integration tests
-bun run test:e2e           # Run end-to-end tests
-
-# Content creation
-bun run new "Post Title"                          # Create new post (flat file)
-bun run new "Title" --folder                      # Create as folder with index.mdx
-bun run new "Title" --prefix weekly               # Create with prefix (e.g., weekly-title)
-bun run new "Title" --template custom             # Use custom template from templates/
-bun run new "Title" --md                          # Create as .md instead of .mdx
-bun run new "Title" --series my-series            # Create post in a series directory
-bun run new-series "Series Name"                  # Create new series with cover image placeholder
-bun run new-from-pdf doc.pdf                      # Create post from PDF (converts pages to images)
-bun run new-from-pdf doc.pdf --title "My Doc"     # With custom title
-bun run new-from-pdf doc.pdf --scale 3.0          # Higher resolution (default: 2.0)
-bun run new-from-images ./photos                  # Create post from image folder
-bun run new-from-images ./photos --title "Gallery" # With custom title
-bun run new-from-images ./photos --sort date      # Sort by date (default: name)
-bun run new-from-images ./photos --no-copy        # Reference images instead of copying
-bun run new-note "Concept"                        # Create a new atomic note
-bun run new-flow-from-chat                        # Import all new files in imports/chats/
-bun run sync-book                                 # Sync book chapters with files on disk
-bun run series-draft "series-slug"                # Set all posts in a series to draft
-bun run series-draft "series-slug" --undraft      # Remove draft status from series posts
+## Core
+bun dev
+bun run lint
+bun run validate
+
+## Build & Deploy
+bun run build
+bun run build:dev
+bun run clean
+bun run deploy                 # Deploy to Linux/nginx server (requires .env.local)
+
+## Test
+bun test
+bun run test:unit
+bun run test:int
+bun run test:e2e
+
+## Create Content
+bun run new "Post Title"
+bun run new-series "Series Name"
+bun run new-note "Concept"
+bun run new-flow
+
+## Import / Maintain
+bun run new-from-pdf ./doc.pdf
+bun run new-from-images ./photos
+bun run new-flow-from-chat
+bun run import-book
+bun run sync-book
+bun run series-draft "series-slug"
 ```
 
 ### Importing Chat Logs to Flows
 
-Amytis includes a powerful script to convert chat logs (like those from LLMs or messaging apps) into Flow entries.
+Drop `.txt` or `.log` files into `imports/chats/`, then run:
 
-1. Place your `.txt` or `.log` files in `imports/chats/`.
-2. Ensure the format is:
-   ```
-   Author Name YYYY-MM-DD HH:mm:ss
-   Message content line 1
-   Message content line 2
-   ```
-3. Run the importer:
-   ```bash
-   bun run new-flow-from-chat
-   ```
-
-Options:
-- `--all`: Re-import every file (ignores history).
-- `--dry-run`: Preview changes without writing files.
-- `--author "Name"`: Only include messages from a specific author.
-- `--append`: Append to existing flow files instead of skipping.
-- `--timestamp`: Include timestamps in the rendered blocks.
+```bash
+bun run new-flow-from-chat
+```
 
-Import history is tracked in `imports/chats/.imported`.
+Common flags: `--all`, `--dry-run`, `--author "Name"`, `--append`, `--timestamp`.
+Import history is stored in `imports/chats/.imported`.
 
 ## Configuration
 
@@ -208,6 +210,7 @@ amytis/
 ## Documentation
 
 - [Architecture Overview](docs/ARCHITECTURE.md)
+- [Deployment Guide](docs/deployment.md)
 - [Digital Garden Guide](docs/DIGITAL_GARDEN.md)
 - [Contributing Guide](docs/CONTRIBUTING.md)
 

package/README.zh.md

@@ -0,0 +1,172 @@
+# Amytis
+
+[English](README.md) | [简体中文](README.zh.md)
+
+**Amytis** 是一个优雅的开源数字花园框架，用于构建个人知识空间。它基于 Next.js 16、React 19 和 Tailwind CSS v4，强调可读性、结构化表达与长期内容所有权。
+
+[**在线演示**](https://amytis.vercel.app/)
+
+![Amytis 截图](public/screenshot.png)
+
+## 知识阶梯
+
+Amytis 围绕一条从粗糙到精炼的知识路径构建：
+
+- **Flow（随笔）**：记录每日想法与碎片。
+- **Articles（文章）**：将单个想法打磨成清晰文章。
+- **Series（系列）**：把相关文章串联为一条主题叙事。
+- **Books（书籍）**：将成熟知识沉淀为章节化结构。
+
+每个阶段都建立在上一阶段之上，花园会自然生长。
+
+## 功能特性
+
+- **数字花园体验**：通过标签、系列、作者、书籍、Flow 和归档进行非线性导航。
+- **互联知识网络**：
+  - **双向链接**：支持 `[[Slug]]` 跨内容类型关联。
+  - **反向链接**：在笔记页自动显示“Linked References”。
+  - **知识图谱**：以可视化方式展示内容连接关系。
+- **全文搜索**：基于 Pagefind 的静态搜索，支持 Cmd/Ctrl+K 快捷键。
+- **结构化内容体系**：
+  - **Series**：支持手动或自动排序的多篇集合。
+  - **Books**：支持章节与分部的长篇阅读界面。
+  - **Notes**：原子化常青笔记。
+  - **Flows**：流式日记/微记录。
+- **富文本 MDX 能力**：
+  - GitHub Flavored Markdown（表格、任务列表等）
+  - 代码高亮
+  - Mermaid 图表
+  - KaTeX 数学公式
+  - 原生 HTML 支持
+- **阅读体验与设计**：
+  - 高可读排版与响应式布局
+  - 自动系统主题检测（明/暗）
+  - 四套配色主题：default、blue、rose、amber
+  - 吸顶目录与阅读进度跟踪
+- **性能与 SEO**：
+  - 全静态导出与 WebP 优化
+  - 自动 sitemap 与 RSS
+  - 支持 Latin/CJK 的多语言阅读时长估算
+- **集成能力**：
+  - 统计：Umami / Plausible / Google Analytics
+  - 评论：Giscus / Disqus
+  - i18n：`site.config.ts` 中配置多语言（en / zh）
+
+## 设计理念
+
+- **默认优雅**：排版、间距、色彩开箱即用且有审美一致性。
+- **内容优先**：通过文件化写作与发布流程完成创作，不依赖重型 CMS。
+- **Markdown 优先但不受限**：保持可迁移写作体验，同时支持数学、图表、代码和双向链接。
+- **按需启用**：`site.config.ts` 提供模块化开关，仅启用你需要的能力。
+- **纯文本长期所有权**：内容存储于 Markdown/MDX，便于版本管理与长期迁移。
+
+## 快速开始
+
+1. **安装依赖**
+   ```bash
+   bun install
+   ```
+
+2. **启动开发环境**
+   ```bash
+   bun dev
+   ```
+   打开 [http://localhost:3000](http://localhost:3000)。
+
+3. **生产构建（静态导出）**
+   ```bash
+   bun run build
+   ```
+   产物位于 `out/` 目录。
+
+4. **开发构建（更快，无图片优化）**
+   ```bash
+   bun run build:dev
+   ```
+
+## CLI 命令
+
+```bash
+## Core
+bun dev
+bun run lint
+bun run validate
+
+## Build & Deploy
+bun run build
+bun run build:dev
+bun run clean
+bun run deploy                 # 部署到 Linux/nginx 服务器（需要 .env.local 配置）
+
+## Test
+bun test
+bun run test:unit
+bun run test:int
+bun run test:e2e
+
+## Create Content
+bun run new "Post Title"
+bun run new-series "Series Name"
+bun run new-note "Concept"
+bun run new-flow
+
+## Import / Maintain
+bun run new-from-pdf ./doc.pdf
+bun run new-from-images ./photos
+bun run new-flow-from-chat
+bun run import-book
+bun run sync-book
+bun run series-draft "series-slug"
+```
+
+### 导入聊天记录到 Flows
+
+将 `.txt` 或 `.log` 文件放入 `imports/chats/` 后执行：
+
+```bash
+bun run new-flow-from-chat
+```
+
+常用参数：`--all`、`--dry-run`、`--author "Name"`、`--append`、`--timestamp`。  
+导入历史记录位于 `imports/chats/.imported`。
+
+## 配置
+
+所有站点配置集中在 `site.config.ts`。
+
+## 内容写作
+
+- **Posts**：创建到 `content/posts/`
+- **Flows**：创建到 `content/flows/YYYY/MM/DD.mdx`（或文件夹模式）
+- **Series**：创建 `content/series/<slug>/index.mdx`
+- **Books**：创建到 `content/books/<slug>/`
+- **Notes**：创建到 `content/notes/`，支持 `[[wiki-links]]`
+
+## 项目结构
+
+```text
+amytis/
+  content/
+    posts/
+    series/
+    books/
+    notes/
+    flows/
+  public/
+  src/
+    app/
+    components/
+    lib/
+  site.config.ts
+```
+
+## 文档
+
+- [架构说明](docs/ARCHITECTURE.md)
+- [部署指南](docs/deployment.md)
+- [数字花园指南](docs/DIGITAL_GARDEN.md)
+- [贡献指南](docs/CONTRIBUTING.md)
+
+## 许可证
+
+MIT

package/content/books/sample-book/images/digital-garden.svg

@@ -0,0 +1,25 @@
+<svg width="800" height="400" xmlns="http://www.w3.org/2000/svg">
+  <rect width="800" height="400" rx="12" fill="#f0fdf4"/>
+  <rect x="1" y="1" width="798" height="398" rx="12" fill="none" stroke="#86efac" stroke-width="2"/>
+
+  <!-- Decorative circles -->
+  <circle cx="120" cy="200" r="60" fill="#bbf7d0" opacity="0.6"/>
+  <circle cx="680" cy="200" r="60" fill="#bbf7d0" opacity="0.6"/>
+  <circle cx="400" cy="100" r="40" fill="#86efac" opacity="0.4"/>
+
+  <!-- Simple tree/plant shapes -->
+  <polygon points="120,220 95,270 145,270" fill="#4ade80"/>
+  <rect x="113" y="268" width="14" height="20" fill="#166534"/>
+  <polygon points="120,190 90,240 150,240" fill="#22c55e"/>
+
+  <polygon points="680,220 655,270 705,270" fill="#4ade80"/>
+  <rect x="673" y="268" width="14" height="20" fill="#166534"/>
+  <polygon points="680,190 650,240 710,240" fill="#22c55e"/>
+
+  <!-- Title text -->
+  <text x="400" y="175" text-anchor="middle" font-family="Georgia, serif" font-size="42" font-weight="bold" fill="#14532d">The Digital Garden</text>
+  <text x="400" y="225" text-anchor="middle" font-family="Georgia, serif" font-size="22" font-style="italic" fill="#166534">A place for ideas to grow</text>
+
+  <!-- Subtitle -->
+  <text x="400" y="310" text-anchor="middle" font-family="Arial, sans-serif" font-size="16" fill="#4ade80">✦ cultivate · connect · contribute ✦</text>
+</svg>

package/content/books/sample-book/index.mdx

@@ -2,7 +2,7 @@
 title: "The Digital Garden Handbook"
 excerpt: "A comprehensive guide to building and maintaining your own digital garden, from initial setup to advanced techniques."
 date: "2026-01-15"
-coverImage: "text:DG"
+coverImage: "/images/flowers.jpg"
 featured: true
 draft: false
 authors: ["Amytis"]

package/content/books/sample-book/introduction.mdx

@@ -3,6 +3,8 @@ title: "Introduction to Digital Gardens"
 excerpt: "Understanding the philosophy and history behind digital gardens."
 ---
 
+![The Digital Garden](./images/digital-garden.svg)
+
 ## What is a Digital Garden?
 
 A digital garden is a personal online space where ideas are cultivated over time. Unlike a traditional blog with polished, finished posts, a digital garden embraces the concept of learning in public.

package/content/posts/legacy-markdown.md

@@ -5,8 +5,6 @@ excerpt: "Demonstrating support for standard .md files."
 category: "Meta"
 tags: ["markdown", "legacy"]
 author: "Old Timer"
-featured: true
-coverImage: "text:Legacy Markdown"
 ---
 
 # Legacy Markdown Support

package/content/posts/markdown-features.mdx

@@ -5,8 +5,8 @@ excerpt: "Testing tables, task lists, and other GFM features."
 category: "Test"
 tags: ["markdown", "gfm"]
 author: "Tester"
-coverImage: "text:Markdown"
 featured: true
+coverImage: "/images/cappadocia.jpg"
 ---
 
 # Extended Markdown Features

package/content/posts/multilingual-test.mdx

@@ -6,7 +6,6 @@ category: "测试"
 tags: ["chinese", "multilingual", "test"]
 authors: ["Amytis Team"]
 latex: true
-featured: true
 coverImage: "text:Multilingual"
 ---
 

package/content/posts/syntax-highlighting-showcase.mdx

@@ -6,6 +6,7 @@ category: "Showcase"
 tags: ["test", "code", "syntax-highlighting"]
 authors: ["Amytis Team"]
 featured: true
+coverImage: "/images/antelope-canyon.jpg"
 toc: true
 externalLinks:
   - name: "Prism.js"

package/content/posts/understanding-react-hooks.mdx

@@ -6,6 +6,7 @@ category: "Engineering"
 tags: ["react", "hooks", "frontend"]
 author: "Code Gardener"
 featured: true
+coverImage: "/images/antelope-canyon.jpg"
 ---
 
 React Hooks revolutionized how we write components. Let's explore the core hooks.

package/content/series/ai-nexus-weekly/index.mdx

@@ -2,7 +2,7 @@
 title: "AI Nexus Weekly"
 excerpt: "A curated weekly digest exploring the rapidly evolving landscape of Artificial Intelligence, from large language models to robotics."
 date: "2026-02-17"
-coverImage: "text:AI Nexus"
+coverImage: "/images/galaxy.jpg"
 featured: true
 sort: "date-desc"
 ---

package/content/series/digital-garden/01-philosophy.mdx

@@ -5,6 +5,8 @@ excerpt: "How ideas evolve from raw daily flows into articles, series, and books
 category: "Philosophy"
 tags: ["pkm", "knowledge management", "learning"]
 authors: ["Amytis Team"]
+featured: true
+coverImage: "/images/mountains.jpg"
 ---
 
 # The Philosophy of Digital Gardening

package/content/series/digital-garden/index.mdx

@@ -2,7 +2,7 @@
 title: "The Digital Garden"
 excerpt: "Exploring the philosophy and architecture of modern digital gardens. A journey from linear blogs to non-linear knowledge systems."
 date: "2026-02-11"
-coverImage: "text:Digital Garden"
+coverImage: "/images/mountains.jpg"
 featured: true
 sort: "manual"
 posts: ["01-philosophy", "02-architecture"]

package/content/series/markdown-showcase/index.mdx

@@ -2,7 +2,7 @@
 title: "Markdown Showcase"
 excerpt: "A comprehensive tour of the rich content features supported by Amytis, from Mermaid diagrams to LaTeX math."
 date: "2026-02-13"
-coverImage: "text:MDX Showcase"
+coverImage: "/images/lake.jpg"
 featured: true
 sort: "manual"
 posts: ["visuals-and-diagrams", "mathematical-notation", "syntax-highlighting"]

package/content/series/markdown-showcase/syntax-highlighting.mdx

@@ -3,6 +3,8 @@ title: "Syntax Highlighting"
 date: "2026-02-15"
 category: "Engineering"
 tags: ["code", "typescript"]
+featured: true
+coverImage: "/images/vibrant-waves.avif"
 ---
 
 Amytis provides beautiful syntax highlighting for dozens of programming languages. Here are a few examples within the series context.

package/content/series/nextjs-deep-dive/01-getting-started.mdx

@@ -2,7 +2,8 @@
 title: "Part 1: Getting Started with Next.js 15"
 date: "2026-01-30"
 excerpt: "Setting up the environment and understanding the core philosophy."
-coverImage: "text:Part 1"
+featured: true
+coverImage: "/images/vibrant-waves.avif"
 ---
 
 # Getting Started

package/content/series/nextjs-deep-dive/index.mdx

@@ -2,8 +2,8 @@
 title: "Next.js Deep Dive"
 excerpt: "A comprehensive guide to mastering Next.js 15, including advanced routing, data fetching, and performance optimization."
 date: "2026-01-30"
-coverImage: "https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?auto=format&fit=crop&w=800&q=80"
 sort: "manual"
+coverImage: "/images/cappadocia.jpg"
 posts:
   - "01-getting-started"
   - "02-routing-mastery"

package/content/subscribe.mdx

@@ -0,0 +1,27 @@
+---
+title: "Subscribe"
+excerpt: "Stay updated with new posts and notes."
+---
+
+Choose how you'd like to follow along.
+
+## RSS Feed
+
+RSS is an open standard — no account required. Paste the feed URL into any reader app, or use one of the quick-subscribe links below.
+
+<rss-feed></rss-feed>
+
+**Popular readers:** [Follow](https://app.follow.is) · [Feedly](https://feedly.com) · [Inoreader](https://www.inoreader.com) · [NetNewsWire](https://netnewswire.com) · [NewsBlur](https://newsblur.com)
+
+## Newsletter
+
+Subscribe via email to get new posts delivered to your inbox.
+
+[Subscribe →](https://example.com)
+
+## Social
+
+Follow for updates and discussions.
+
+- [X (Twitter)](https://twitter.com)
+- [GitHub](https://github.com)