changelog.md

# 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/).

## [Unreleased]

### Changed

- Agent-ready widget now opts into the `@waynesutton/agent-ready@0.2.4` desktop collapse behavior, giving desktop users the caret toggle while keeping the existing floating bottom-right placement
- Agent-ready widget now opts into the `@waynesutton/agent-ready@0.2.0` mobile collapse behavior with a 480px breakpoint and collapsed initial state on phones
- FeaturedCards accepts optional `featuredPosts`/`featuredPages` props to avoid duplicate Convex subscriptions when parent already has the data
- FeaturedCards skips `getAllPosts`/`getAllPages` queries in frontmatter mode (the default) since those queries are only needed for legacy items mode
- Layout skips `getDocsPages`/`getDocsPosts` subscriptions when `siteConfig.docsSection.enabled` is false
- Home skips `isCurrentUserAuthenticated` subscription unless the `?dashboardNotice=not-admin` query param is present
- Home passes its fetched featured data to FeaturedCards as props, cutting 2 duplicate subscriptions per page load
- Home page Convex subscriptions reduced from 11-15 to ~7, reducing log noise from auth-triggered re-evaluation bursts

### Added

- Created `prds/agent-ready-desktop-collapse-widget.md` documenting the host app update for the latest agent-ready desktop widget prop
- Created `prds/agent-ready-mobile-widget.md` documenting the host app update for the new agent-ready mobile widget props
- Installed `@waynesutton/agent-ready@0.1.7` Convex component with peer deps `@convex-dev/crons` and `@convex-dev/workpool` for auto-generated llms.txt, agents.md, and llms-full.txt
- Registered `agentReady`, `crons`, and `workpool` components in `convex/convex.config.ts`
- Mounted agent-ready HTTP routes in `convex/http.ts` with `skipRoutes: ["/sitemap.xml"]` to avoid conflict with existing dynamic sitemap
- Added `AgentReadyWidget` and `UpdateBanner` from `@waynesutton/agent-ready/react` to `src/App.tsx` (floating bottom-right, dark theme)
- Scaffolded `convex/agentReady/content.ts` and `convex/agentReady/analytics.ts` wrapper files via `npx agent-ready setup`
- Created `agent-ready.config.json` with app name, URL, analytics, Claude AI descriptions, and `sitemapEnabled: false`
- Added `agent-ready.config.json` to `.gitignore` (deployment-specific, generated by CLI wizard)
- Created `prds/agent-ready-route-conflicts.md` documenting the `/sitemap.xml` route conflict and proposed fix (shipped in 0.1.7 as `skipRoutes`)
- Populated `agent-ready.config.json` with 28 pages (site sections, docs, tutorials, blog posts) and 16 API endpoints so the generated llms.txt and agents.md reflect the full site content
- All agent-ready generated URLs now use `https://www.markdown.fast` instead of the raw Convex deployment URL
- Enabled `fullTxtEnabled: true` for richer llms-full.txt output
- Created `prds/agent-ready-improvements.md` with 7 component improvement suggestions (auto-discover, content sync hooks, sections, URL resolution, route conflict warnings)
- Created `prds/agent-ready-widget-url-feedback.md` documenting the widget URL mismatch where production builds baked in the dev Convex site URL, proposed component-side fixes (prefer config appUrl, dev URL warning, scan check), and the host app workaround
- Fixed the agent-ready widget URL resolver in `src/App.tsx` so production builds use `VITE_SITE_URL` or the live browser origin instead of baking in the dev Convex site URL from `.env.local`
- Added `VITE_SITE_URL=https://www.markdown.fast` to `.env.production.local` for correct production widget URLs
- Deployed updated static bundle to production via `npm run deploy:static` with the widget URL fix and full agent-ready config

### Changed

- Updated `scripts/configure-fork.ts` to support all fork-config.json fields: `statsPage`, `imageLightbox`, `semanticSearch`, `dashboard`, `mcpServer`, `newsletter`, `contactForm`, `newsletterAdmin`, `aiChat`, `askAI`, plus canonical URL and hreflang updates in `index.html`
- Changed configure script "Next steps" from "Deploy to Netlify" to "Deploy when ready: npm run deploy"
- Updated generated `llms.txt` template from "Hosting: Netlify with edge functions" to "Hosting: Convex self-hosted (default) or Netlify (legacy)"
- Updated `sync-discovery-files.ts` project overview and llms.txt description from "Built on Convex and Netlify" to "Built on Convex"
- Updated all site description strings in `index.html`, `convex/http.ts`, and `convex/rss.ts` from "Built on Convex and Netlify" to "Built on Convex"
- Moved `vite` from runtime dependencies to devDependencies in `packages/create-markdown-sync/package.json` (CLI does not import vite)
- Bumped `@types/node` to `^22.0.0` in `packages/create-markdown-sync/package.json`
- Upgraded `@robelest/convex-auth` to `^0.0.4-preview.30`. Removed direct `arctic` dependency since the published package now ships first-party `github()` provider with built-in profile fetch
- Rewrote `convex/auth.ts` to use lowercase factory functions: `password()` and `github({ clientId, clientSecret })` instead of `new Password()` and `OAuth(new GitHub(...), { profile })`
- Switched `createAuth` import to `@robelest/convex-auth/server` (the `/component` entry imports but does not re-export `createAuth` in preview.30, while `/server` does)
- `convex/dashboardAuth.ts` `isDashboardAdmin()` now treats `DASHBOARD_PRIMARY_ADMIN_EMAIL` as the sole admin gate when set. The `dashboardAdmins` table is bypassed entirely so that a single env var enforces "exactly one human admin" without database state. The table fallback only runs when the env var is unset
- Non-admin authenticated dashboard users now render the demo view with a denied-state banner. The banner shows the signed-in GitHub email, the expected `DASHBOARD_PRIMARY_ADMIN_EMAIL`, and a visible "Sign out and retry" button
- Frontend auth client setup now uses `getConvexAuthClient()` in `src/utils/convexAuthClient.ts` to keep a singleton Robel auth client per `ConvexReactClient`. This prevents multiple components from verifying the same OAuth callback code and spamming `Invalid verification code`
- `getConvexAuthClient()` now imports from `@robelest/convex-auth/browser`, the docs-recommended entrypoint for web apps. This supplies local storage, URL handling, and `ConvexHttpClient` defaults that the framework-neutral `/client` entrypoint does not provide
- `DASHBOARD_PRIMARY_ADMIN_EMAIL` is now read at request time instead of captured at module load, so Convex env updates are picked up without stale strict-admin state
- Denied dashboard users now see a safe debug banner showing the signed-in GitHub email and expected strict admin email, plus a visible "Sign out and retry" button
- OAuth callback cleanup now stays owned by `@robelest/convex-auth` during normal login. The app only removes stale failed callback params after a five-second unauthenticated grace period, so old broken `?code=` URLs do not poison retries
- Removed unsupported React `fetchPriority` props from image tags to silence the DOM warning in local development
- `SignInResult` no longer exposes a top-level `redirect` property. Dashboard GitHub sign-in now narrows on `result.kind === "redirect"` before reading `result.redirect`
- Earlier in this unreleased block: bumped from preview.11 through preview.25 with manual GitHub profile callback and `arctic`. Preview.30 supersedes that interim state and removes the workaround
- Demo mode Write tab uses dedicated `DEMO_POST_FIELDS` and `DEMO_PAGE_FIELDS` frontmatter lists that hide admin-only fields (`showInNav`, `featured`, `featuredOrder`, `blogFeatured`, `order`, `docsSection`, layout, navbar). `generateWriteTemplate(type, isDemo)` emits a demo-safe template with the 30-minute reset note

### Fixed

- Convex push failure caused by duplicate `GET /sitemap.xml` registration between the app's dynamic sitemap and `@waynesutton/agent-ready`. The app now keeps its existing sitemap route and passes `skipRoutes: ["/sitemap.xml"]` when registering agent-ready routes
- Blank page on load caused by the auth client throwing during SPA-mode init when localStorage held a stale `__convexAuthRefreshToken`
- Repeated `[convex-auth] Invalid verification code` logs caused by multiple Robel auth client instances trying to consume the same OAuth callback verifier
- Strict admin mode incorrectly falling into first-admin bootstrap when no `dashboardAdmins` rows existed. When `DASHBOARD_PRIMARY_ADMIN_EMAIL` is configured, denied users now go to demo mode with the mismatch banner
- Convex push failure `Class constructor T1 cannot be invoked without 'new'` caused by calling `Password()` instead of `new Password()` (no longer relevant in preview.30 since `password()` is a factory)
- Three pre-existing TS6133 unused-variable warnings cleaned up: dropped unused `ConvexError` import in `convex/wiki.ts`, prefixed unused `source` parameter in `scripts/sync-wiki.ts`, removed unused `sourceDetail` query in `src/pages/Dashboard.tsx`

### Documentation

- Linked the Convex Static Hosting component docs from `content/blog/convex-first-architecture.md`, `content/pages/docs-deployment.md`, and `content/pages/docs.md`
- Documented the production static hosting shape: `@convex-dev/self-hosting` in `convex/convex.config.ts`, upload helpers in `convex/staticHosting.ts`, and `registerStaticRoutes(http, components.selfHosting)` in `convex/http.ts`
- Updated deployment docs with production env requirements for Robel Auth, GitHub OAuth, and `DASHBOARD_PRIMARY_ADMIN_EMAIL`
- Updated `.cursor/skills/robel-auth/SKILL.md` "Published package reality check" section for `0.0.4-preview.30`: lowercase factory exports are now real, `arctic` is no longer required for GitHub, `password()` is a factory function (not a class), and `client` imports from `@robelest/convex-auth/client` or `/browser`. Older release notes preserved as legacy migration context
- Added "Denied session pattern" section to the skill documenting the upstream-recommended `signOut + render denied UI` flow for app-level allowlists
- Created `prds/robel-auth-preview-30-and-admin-lockdown.md` documenting the upgrade and admin email lockdown

### Added

- Markdown slide presentations: `slides: true` frontmatter enables fullscreen presentation mode on any post or page
- New `SlidePresentation` component with keyboard navigation (arrows, space, escape, home, end), progress bar, and slide counter
- Content splits on `---` horizontal rules into slides; code blocks are safely skipped during parsing
- Present button in post/page header when slides are enabled
- New blog post: "Markdown slides" documenting the feature
- New slide template example post with a working 10-slide deck
- `slides` field added to posts and pages tables in `convex/schema.ts`, sync mutations in `convex/posts.ts` and `convex/pages.ts`, and `scripts/sync-posts.ts`
- Application-level rate limiting across all 4 tiers using `@convex-dev/rate-limiter` component
  - Tier 1: Ask AI stream, source ingest, wiki compilation, AI image generation, AI chat (LLM cost protection)
  - Tier 2: VFS exec/tree, API export, full-content RSS (compute-heavy reads)
  - Tier 3: Heartbeat, page views, newsletter subscribe (public mutation abuse prevention)
  - Tier 4: API posts/post, sitemap, KB endpoints, RSS, raw markdown (standard reads)
- `convex/rateLimits.ts` with centralized rate limit definitions and HTTP action bridge mutation
- Rate limiter component registered in `convex/convex.config.ts`
- HTTP 429 responses with `Retry-After` headers on all rate-limited endpoints
- Rate limiting documentation and patterns added to `convex-virtual-fs/` README
- `llms.txt` and `AGENTS.md` links in SocialFooter between social icons and copyright, with Robot and FileText Phosphor icons
- Sync discovery script now fetches wiki pages from Convex and includes wiki knowledge base section in both `llms.txt` and `AGENTS.md`
- `AGENTS.md` automatically copied to `public/` directory during sync so it is web-accessible at `/AGENTS.md`
- `convex-virtual-fs/` standalone Convex component package (`@convex-dev/virtual-fs`) with shell commands, HTTP endpoints, client class, test helpers, example app, and full docs for publishing to npm
- New blog post: "Wiki, knowledge bases, and virtual filesystem" covering LLM wiki, KBs, VFS, and demo mode
- SVG featured image at `public/images/wiki-kb-vfs.svg` for the new blog post
- README features section rewritten to match homepage feature list with all current capabilities
- README "Recent updates" section updated with wiki, KBs, VFS, demo mode, and convex-doctor 100/100
- "Accessing wiki data" section added to `docs.md`, `docs-dashboard.md`, and `AGENTS.md` documenting authenticated vs. unauthenticated access patterns
- AGENTS.md key features list expanded with knowledge bases, semantic search, Ask AI, demo mode, newsletter, and knowledge graph
- Homepage tagline rewritten to include wikis and knowledge bases with link to docs

### Changed

- Migrated all OpenAI model references from deprecated `gpt-4o` to `gpt-4.1-mini` across 6 Convex backend files, frontend config, fork config, create-markdown-sync, and 8 content docs
- Wiki compiler now uses `gpt-4.1-mini` for compilation
- AI chat and Ask AI backends updated to `gpt-4.1-mini` model validator and API calls
- Dashboard wiki section copy updated from GPT-4o to GPT-4.1 mini

### Fixed

- `docs-dashboard.md` demo mode section still said "Hourly" instead of "every 30 minutes"
- `about.md` demo mode missing 30-minute cleanup detail

- Knowledge bases system: create, manage, and share multiple LLM knowledge bases from the dashboard
- Upload markdown files or Obsidian vaults as knowledge base projects via `convex/kbUpload.ts`
- Per-KB visibility (public/private) and API controls (public/private/off) in `convex/knowledgeBases.ts`
- HTTP API endpoints: `/api/kb`, `/api/kb/pages`, `/api/kb/page` for per-KB content access
- KB switcher in public Wiki page lets visitors browse between site wiki and uploaded knowledge bases
- Wiki full-text search scoped by knowledge base via `searchWikiPages` query
- `--kb=<id>` flag for `npm run sync:wiki` to sync content into a specific knowledge base
- Knowledge graph visualization scoped per knowledge base
- New schema tables: `knowledgeBases`, `kbUploadJobs` with full indexes
- `kbId` foreign key added to `wikiPages`, `wikiIndex`, `wikiCompilationJobs` for backward-compatible scoping
- convex-doctor score maintained at 100/100 after all changes

- Wiki sync command: `npm run sync:wiki` and `npm run sync:wiki:prod` to build wiki from local markdown content
- Wiki sync script at `scripts/sync-wiki.ts` reads `content/blog/` and `content/pages/`, infers types/categories, extracts backlinks
- Public `syncWikiPages` mutation in `convex/wiki.ts` for CLI-driven wiki population
- `sync:all` and `sync:all:prod` now include wiki sync automatically

- Anonymous dashboard demo mode for unauthenticated visitors to explore all dashboard features
- Demo users can create, edit, and delete temporary posts/pages (tagged `source: "demo"`)
- Content sanitization in `convex/demo.ts` strips scripts, iframes, event handlers, and dangerous HTML
- Hourly cron job to clean up all demo content automatically
- "Dashboard" text label added to nav icon in Layout.tsx (desktop and mobile)
- Demo source badge (amber) for demo-created content in post/page lists
- Sign-in with GitHub button in demo sidebar footer for upgrading to full admin
- PRD at `prds/anonymous-demo-mode.md`

- Virtual filesystem HTTP interface (`/vfs/tree`, `/vfs/exec`) for shell-like access to all site content via `convex/virtualFs.ts`
- Source ingest pipeline with queued job pattern: `convex/sources.ts`, `convex/sourceActions.ts` (Firecrawl scraping + OpenAI embeddings)
- LLM wiki compilation system: `convex/wiki.ts`, `convex/wikiCompiler.ts`, `convex/wikiJobs.ts` (GPT-4o driven synthesis)
- Five new database tables: `sources`, `sourceIngestJobs`, `wikiPages`, `wikiIndex`, `wikiCompilationJobs`
- Daily wiki compilation cron job (4:00 AM UTC) in `convex/crons.ts`
- Wiki resources page at `content/pages/wiki-resources.md` with reference links
- PRD at `prds/virtual-filesystem.md` covering all three phases
- Dashboard "Sources" tab with URL ingest form, source list, status indicators, and content preview
- Dashboard "Wiki" tab with compile/lint buttons, job status polling, lint report viewer, wiki pages list with rendered markdown detail, backlink navigation, and wiki index display
- New "Knowledge" sidebar section in Dashboard with Sources and Wiki nav items

### Changed

- `convex/virtualFs.ts` uses shared helper functions for `buildPathTree`, `readFile`, and `grepContent` so `executeCommand` avoids `ctx.runQuery` within the same file (convex-doctor `perf/helper-vs-run` compliance)
- Wiki compilation batches all page upserts, index regeneration, and job finalization into single mutations (convex-doctor `perf/loop-run-mutation` and `perf/sequential-run-calls` compliance)
- Source processing batches `markSourceProcessed` and job finalization into one mutation
- `convex-doctor` maintained at **100/100** with **0 errors**, **0 warnings** after all new files

### Security

- Added auth-awareness to `search`, `recordPageView`, `heartbeat`, and `versions.isEnabled` so intentional public flows remain non-blocking while clearing more `convex-doctor` auth warnings
- Added auth-awareness to `syncPostsPublic` and `syncPagesPublic` so content sync keeps its existing non-blocking behavior while reducing false-positive unauthenticated write warnings
- Added non-breaking auth-awareness checks to additional public content and stats queries in `convex/posts.ts`, `convex/pages.ts`, and `convex/stats.ts` so `convex-doctor` better distinguishes intentional public reads from accidental anonymous access
- Added auth-awareness checks to public utility flows in `convex/embeddings.ts`, `convex/files.ts`, and `convex/newsletter.ts` to reduce false-positive unauthenticated access warnings without changing intended public setup behavior
- Added authentication to `streamResponse` HTTP action in `convex/askAI.node.ts` (returns 401 for unauthenticated callers)
- Added authentication to `generateResponse` public action in `convex/aiChatActions.ts`
- Replaced all server-to-server `api.*` calls with `internal.*` in `convex/http.ts`, `convex/rss.ts`, `convex/dashboardAuth.ts`, `convex/importAction.ts`
- Created `isCurrentUserDashboardAdminInternal` internal query to eliminate public API exposure for admin checks
- Added authenticated ownership checks for AI chat sessions, Ask AI sessions, and generated AI image records
- Hardened public AI chat and image endpoints so logged-in users cannot mutate or read another user's queued AI state by default

### Added

- New featured blog post: "How convex-doctor took markdown.fast from 42 to 100" covering the full 17-pass remediation journey, AI model usage, and convex-doctor recommendation
- Generated before/after comparison image, added benchmark and 100/100 score screenshots to `public/images/`
- New convex-doctor skill (`.cursor/skills/convex-doctor/SKILL.md`) and always-on rule (`.cursor/rules/convex-doctor.mdc`)

### Fixed

- Reverted `.unique()` back to `.first()` in `convex/authAdmin.ts` and `convex/dashboardAuth.ts` to fix runtime errors when duplicate `dashboardAdmins` rows exist for the same subject or email

### Changed

- Added `by_storageid` index on `aiImageGenerationJobs` so the `_storage` foreign key field has a lookup path
- Extracted `buildContactHtml` and `buildContactText` helpers from `sendContactEmail` in `contactActions.ts`, reducing the handler body from 60 to 25 lines
- Extracted `updatePageViewAggregates`, `buildPageStats`, `collectVisitorLocations`, and `getTopPathStats` helpers in `stats.ts` so `recordPageView` and `getStats` handlers focus on orchestration
- Added 7 rule suppressions to `convex-doctor.toml` for patterns that are by design: auth awareness per public handler, schema nesting for chat attachments, 94 optional frontmatter fields, intentional ordered `.first()` picks, domain-organized file layout, and multi-step email/sync/search handlers
- Seventeenth-pass `convex-doctor` cleanup reached **100/100** with **0 errors**, **0 warnings**, and **18 infos** (up from 92/100 with 39 warnings)
- Semantic search action `semanticSearchJob` now batches post and page doc fetches into one `fetchSearchDocsByIds` internal query, uses a unified `finalizeSemanticSearchJob` mutation for both success and failure, and routes finalization through a local helper, cutting `ctx.run*` call sites from 7 to 4 in the handler
- Auth component wrappers in `authComponent.ts` are now plain async helpers instead of registered `internalQuery` functions so callers share the same transaction without a double `runQuery` hop; fixes `perf/helper-vs-run`
- Sixteenth-pass `convex-doctor` cleanup improved the score from **91/100** with **0 errors / 43 warnings** to **92/100** with **0 errors / 39 warnings**
- Post newsletter sends batch prefetch through `getPostNewsletterSendContextInternal` so `sendPostNewsletter` uses one internal query before mail delivery and only calls `recordPostSent` when at least one send succeeds
- Auth bootstrap listing and dashboard admin email lookup use `authComponent.*` helpers instead of direct `components.auth.public.*` references
- `viewCounts` reads in `incrementViewCount` and `getViewCount` now use `.unique()` on `by_slug`
- Added `convex-doctor.toml` to tune `convex-doctor` (ignore `convex/_generated/**` and `convex/authComponent.ts`, disable `correctness/generated-code-modified`); fifteenth pass reached **91/100** with **0 errors** and **43 warnings**
- Queued URL import now passes the job snapshot into `importFromUrlJob`, completes imported post creation plus job completion through one internal mutation, and routes repeated failure finalization through helpers
- Markdown export queries in `convex/cms.ts` now build post and page frontmatter through shared helper functions without changing the exported document format
- Fourteenth-pass `convex-doctor` cleanup improved the score from `85/100` with `1 error / 54 warnings` to `86/100` with `1 error / 49 warnings`
- AI chat response generation now runs from the queued mutation snapshot instead of re-querying chat state inside the internal action, and it finalizes success or failure through one internal mutation
- Queued image generation now runs from the scheduled job snapshot and finalizes generated-image metadata plus job status through one internal finalizer, which also removes the remaining `replace` usage in that flow
- Thirteenth-pass `convex-doctor` cleanup improved the score from `84/100` with `1 error / 60 warnings` to `85/100` with `1 error / 54 warnings`, moving the repo into the `Healthy` band
- Direct Convex storage uploads in the media library and image modal now resolve preview URLs through the existing `getDirectStorageUrl` query, and `media.resolveDirectUpload` is internal-only
- Semantic search now runs through a queued `semanticSearchJobs` flow instead of a browser-called public action, with `SearchModal` rendering pending and completed state from the active job
- Newsletter sent-post slug checks now use `.unique()` to match the app's one-record-per-post convention
- Eleventh- and twelfth-pass `convex-doctor` cleanup improved the score from `80/100` with `1 error / 68 warnings` to `84/100` with `1 error / 60 warnings`
- Dashboard URL import now runs through a queued `importUrlJobs` flow instead of calling `importFromUrl` as a public browser action, preserving success and failure UX through reactive job state
- `versions.getStats` now uses `.unique()` for the `versionControlSettings.by_key` lookup, which matches the table's single-setting convention
- Tenth-pass `convex-doctor` cleanup removed the `importFromUrl` public action warning and held findings at `1 error / 68 warnings`, with the score settling at `80/100`
- `files.setFileExpiration` is now an internal action instead of a public action, removing the remaining browser-callable file-maintenance action path
- Added auth-awareness to `posts.incrementViewCount` so the intentional public counter flow is analyzer-visible without changing runtime behavior
- Converted clearly unique-by-design indexed lookups from `.first()` to `.unique()` across version control settings, CMS slug checks, newsletter subscriber email lookups, dashboard admin identity checks, and embedding slug lookup
- Ninth-pass `convex-doctor` cleanup held the score at `81/100` while reducing findings from `1 error / 84 warnings` to `1 error / 68 warnings`
- `files.getDownloadUrl` is now an internal action instead of a public action, removing an unused browser-callable action path without changing current UI behavior
- RSS handlers in `convex/rss.ts` now use the same plain-helper-plus-`httpAction(...)` registration pattern as Ask AI, which clears the legacy handler syntax warning while preserving XML output and cache headers
- Eighth-pass `convex-doctor` cleanup improved the score from `78/100` to `81/100` and reduced findings from `1 error / 89 warnings` to `1 error / 84 warnings`
- Batched version snapshot scheduling in `syncPostsPublic` and `syncPagesPublic` through `versions.createVersionsBatch`, removing per-item scheduler calls without changing pre-update snapshot behavior
- `files.commitFile` is now a public mutation instead of a public action, and the Dashboard upload UIs now call it through `useMutation`
- Added explicit high `.take(...)` bounds to the remaining safe collect-based paths touched in `convex/posts.ts`, `convex/pages.ts`, `convex/newsletter.ts`, and `convex/authAdmin.ts`
- Added explicit return validators across `convex/files.ts` so file list, info, download, delete, expiration, and count flows have validated response shapes
- Seventh-pass `convex-doctor` cleanup improved the score from `67/100` to `78/100` and reduced findings from `17 errors / 98 warnings` to `1 error / 89 warnings`
- Ask AI stream handlers now live as plain helpers in `convex/askAI.node.ts` and are wrapped at registration time in `convex/http.ts`, which removes the old exported `streamResponse` function warning without changing the endpoint behavior
- Embedding refresh entrypoints moved to `convex/embeddingsAdmin.ts`, so the sync script now queues internal embedding work via mutations instead of calling public actions directly
- Sixth-pass `convex-doctor` cleanup improved the score from `66/100` to `67/100` and reduced warnings from `110` to `98`
- Dashboard image generation now queues work through `aiImageJobs.requestImageGeneration` and a persisted `aiImageGenerationJobs` table instead of calling a public generation action directly
- Dashboard image results now render from reactive job state so pending, success, and failure states survive the server round trip cleanly
- Fifth-pass `convex-doctor` cleanup reduced findings from `28 errors / 130 warnings` to `17 errors / 110 warnings` while returning to `66/100`
- Added explicit `.take(...)` limits to remaining public list-style queries touched in `convex/posts.ts`, `convex/pages.ts`, `convex/newsletter.ts`, `convex/stats.ts`, and `convex/authAdmin.ts`
- Refactored `convex/aiChatActions.ts` so `generateResponse` now delegates attachment enrichment, storage URL resolution, message formatting, and provider invocation to local helper functions
- `generateResponse` now resolves storage URLs directly inside the action instead of using the `getStorageUrlsBatch` internal query, reducing the Convex call chain from 5 to 4 and shrinking the handler from 209 lines to 69
- Removed the now-unused `getStorageUrlsBatch` internal query from `convex/aiChats.ts`
- Fourth-pass `convex-doctor` cleanup reduced warnings from `136` to `130` while holding the score at `68/100`
- Third-pass `convex-doctor` cleanup replaced remaining safe post/page/stats `collect then filter` pipelines with explicit iteration while preserving existing query shapes
- Safe unique-by-design lookups now use `.unique()` for slugs, Ask AI stream ids, AI chat session/context pairs, generated image storage ids, dashboard admin identifiers, and active session ids
- Added auth-awareness checks to intentional public setup flows in `convex/authAdmin.ts`, `convex/contact.ts`, and `convex/embeddings.ts` so analyzer warnings reflect actual risk more closely
- `convex-doctor` score improved from `66/100` to `68/100` during the third pass
- `stats.getStats` query now accepts `now` argument instead of using `Date.now()` internally (fixes non-deterministic query caching)
- `newsletter.getStatsForSummary` query now accepts `now` argument for deterministic behavior
- Stats.tsx and Dashboard StatsSection pass 60-second rounded timestamps for stable Convex subscriptions
- Replaced collect-then-filter with async iteration in `embeddingsQueries.ts` (stops early instead of scanning all published content)
- Eliminated N+1 query pattern in `/api/export` and `/rss-full.xml` using batch `getAllPostsWithContentInternal` query
- Batch-resolve storage URLs in `generateResponse` using `getStorageUrlsBatch` instead of per-image queries
- Renamed `by_docsSection` index to `by_docs_section` across posts and pages tables (schema convention alignment)
- Removed redundant `by_session` index from `aiChats` table (prefix of `by_session_and_context`)
- Replaced `throw new Error(...)` with `ConvexError` in `dashboardAuth.ts`, `authAdmin.ts`, and `aiChatActions.ts` for structured client error handling
- Removed debug `console.log` statements from `dashboardAuth.ts`
- AI chat now queues assistant generation through `aiChats.requestAIResponse` and an internal `aiChatActions.generateResponse` action
- AI chat UI loading and error state now follows persisted backend generation state instead of awaiting a direct browser action
- Added CORS preflight handlers for public HTTP endpoints flagged during the second `convex-doctor` pass
- Post queries now sort ISO date strings directly instead of constructing `Date` objects inside Convex queries
- `convex-doctor` score improved from `42/100` to `66/100` across the two remediation passes

### Added

- `convex/authComponent.ts` with internal forwarders for Robelest auth component `userGetById` and `userList` queries
- Root `convex-doctor.toml` for local `convex-doctor` ignores and rule toggles
- `convex/semanticSearchJobs.ts` with public request or status functions and internal completion or failure handlers for queued semantic search
- `semanticSearchJobs` table in `convex/schema.ts` for persisted semantic search request state
- `convex/importJobs.ts` with queued URL import request, status, and internal completion or failure handlers
- `importUrlJobs` table in `convex/schema.ts` for persisted Dashboard URL import state
- `versions.createVersionsBatch` internal mutation in `convex/versions.ts` for batched sync snapshot creation
- `convex/embeddingsAdmin.ts` with queued mutation entrypoints for bulk and per-post embedding refreshes
- `convex/aiImageJobs.ts` with public request/status functions and internal completion/failure helpers for queued image generation
- `aiImageGenerationJobs` table in `convex/schema.ts` for persisted image generation state
- Internal query equivalents for server-to-server usage: `getAllPostsInternal`, `getPostBySlugWithContent`, `getAllTagsInternal`, `getAllAuthorsInternal`, `getAllPostsWithContentInternal` in `convex/posts.ts`
- Internal query equivalents: `getAllPagesInternal`, `getPageBySlugInternal` in `convex/pages.ts`
- `createPostInternal` internal mutation in `convex/cms.ts` for action-to-mutation server calls
- `getStorageUrlsBatch` internal query in `convex/aiChats.ts` for batch URL resolution
- PRD: `prds/convex-doctor-remediation.md` documenting the full remediation plan
- PRD: `prds/convex-doctor-second-pass.md` documenting the second remediation pass
- PRD: `prds/convex-doctor-third-pass.md` documenting the third remediation pass
- `aiChats.requestAIResponse` public mutation and internal failure tracking for queued AI responses
- Public HTTP `OPTIONS` routes for `/raw/`, `/rss.xml`, `/rss-full.xml`, `/sitemap.xml`, `/api/posts`, `/api/post`, `/api/export`, and `/meta/post`

- Rybbit analytics integration:
  - Added Rybbit analytics script to `index.html` with site ID `24731ca420a4`
  - Script loads with `defer` attribute to avoid blocking page rendering

### Fixed

- Improved WSL 2 setup resilience for Convex onboarding:
  - Verified open issue #7 behavior against current setup docs and kept normal flow unchanged
  - Added WSL 2 manual login fallback (`npx convex login --no-open --login-flow paste`) in `content/blog/setup-guide.md`
  - Added WSL 2 fallback setup commands in `README.md` with `npx convex dev --once` for first-time initialization

- Fixed TypeScript errors for cleaner builds:
  - Removed unused variables `pathsWithCounts` and `allPathsFromAggregate` in `convex/stats.ts`
  - Fixed `fetchpriority` to `fetchPriority` (React camelCase) in `Layout.tsx`, `Home.tsx`, and `Post.tsx`

- Fixed button border-radius inconsistency across Write page and Dashboard:
  - Added missing CSS variables `--border-radius-sm: 4px`, `--border-radius-md: 6px`, `--border-radius-lg: 8px` to `:root`
  - Dashboard mode toggles (Markdown/Rich Text/Preview) and action buttons now have consistent 6px border radius

- Fixed Media Library upload and preview for `convex` and `r2` providers:
  - Uploads now show image preview with MD/HTML/URL copy buttons after upload completes
  - Recent uploads persist to `sessionStorage` (survive page refreshes within tab session)
  - Image previews use real Convex storage URLs instead of ephemeral blob URLs
  - Usage text now dynamically reflects the active media provider
- Fixed image preview clipping in Media Library grid:
  - Changed from square aspect ratio with cover crop to 4:3 aspect ratio with contain fit
- Fixed ImageUploadModal Media Library tab being disabled when Bunny CDN not configured:
  - Tab now only requires `convexfs` provider, not Bunny CDN configuration
- Fixed React Router v7 deprecation warnings:
  - Added `v7_startTransition` and `v7_relativeSplatPath` future flags to `BrowserRouter`
- Fixed logo preload warning in browser console:
  - Removed unused `<link rel="preload">` for logo.svg from `index.html`

- Eliminated `activeSessions` write conflicts in `stats:heartbeat` mutation:
  - Increased backend dedup window from 20s to 45s in `convex/stats.ts`
  - Increased frontend heartbeat interval from 30s to 45s in `usePageTracking.ts`
  - Added BroadcastChannel cross-tab coordination so only leader tab sends heartbeats
  - Tab leadership election with automatic handoff when tabs close
  - Heartbeat completely disabled when `statsPage.enabled: false` in siteConfig
  - See `prds/fix-heartbeat-write-conflicts.md` for full details

### Changed

- Updated `create-markdown-sync` CLI to v0.2.0:
  - Properly handles `convex-auth` mode as default (no longer only disables for non-workos)
  - Updated auth config comments to reference `@robelest/convex-auth` as primary auth system
  - Updated README with new deployment commands and optional auth setup instructions
  - Version bump to 0.2.0 to reflect v2.21.x architecture changes

- Stats performance optimizations for faster loading and reduced Convex usage:
  - Stats tracking now respects `statsPage.enabled` config in `usePageTracking.ts` (no DB writes when disabled)
  - Removed expensive full table scan fallback in `getStats` query (O(n) to O(log n))
  - Added `uniquePaths` aggregate component for efficient path tracking
  - Paginated `pageStats` to return top 50 pages by views instead of all paths
  - Updated Stats page UI to show "Top Pages by Views" with "(showing X of Y)" count indicator

- Updated docs content pages to use Convex-first deployment language while preserving legacy compatibility notes:
  - `content/pages/about.md`
  - `content/pages/docs.md`
  - `content/pages/docs-content.md`
  - `content/pages/footer.md`

- Improved one-click deploy onboarding for Convex-first setup:
  - `package.json` deploy scripts now use upstream self-hosting flow directly
  - Added one-click path docs in `README.md` and `FORK_CONFIG.md` for GitHub template and CLI setup
  - Updated fork guide URL examples to Convex-first neutral domains (`*.example.com`) instead of Netlify-first defaults
- Improved `create-markdown-sync` onboarding output with explicit deferred-auth next steps and deploy verification commands.
- Added dashboard auth setup visibility:
  - New query `authAdmin:getAuthSetupStatus` exposes auth/setup readiness signals
  - `src/pages/Dashboard.tsx` now shows auth setup status in login UI and a first-admin bootstrap guidance screen when no admins exist
- Added validation scripts for setup and deploy verification:
  - `scripts/validate-env.ts`
  - `scripts/verify-deploy.ts`
  - New npm scripts: `validate:env`, `validate:env:prod`, `verify:deploy`, `verify:deploy:prod`

- Added migration baseline for default `@robelest/convex-auth` + `@convex-dev/self-hosting` architecture while preserving legacy WorkOS and Netlify compatibility.
- Added dual mode config surface in `siteConfig`:
  - `auth.mode`: `convex-auth | workos | none`
  - `hosting.mode`: `convex-self-hosted | netlify`
  - `media.provider`: `convex | convexfs | r2`
- Added backend auth and hosting wiring:
  - `convex/auth.ts` with Convex Auth exports
  - `convex/staticHosting.ts` for static asset deployment APIs
  - `convex/http.ts` now registers `auth.http.add(http)` and `registerStaticRoutes(...)`
  - `convex/convex.config.ts` now registers Convex Auth, Self Hosting, and R2 components
- Added optional media backends:
  - `convex/r2.ts` for Cloudflare R2 uploads with admin checks
  - `convex/media.ts` for provider resolution and direct Convex upload helpers
  - Dashboard upload flows updated in `ImageUploadModal` and `MediaLibrary` for `convex`, `convexfs`, and `r2` modes
- Refactored frontend auth bootstrap:
  - `src/main.tsx` now always uses centralized auth wrapper
  - `src/AppWithWorkOS.tsx` now handles convex-auth, WorkOS legacy, and no-auth fallback with proper `ConvexAuthWrapper` component
  - `src/utils/workos.ts` now exports auth mode aware behavior
- Added custom domain override support in frontend route helpers via `VITE_CONVEX_SITE_URL` and `VITE_SITE_URL`.
- Aligned default/legacy/local mode wording across `README.md`, `FORK_CONFIG.md`, and `fork-config.json.example`.

- Replaced the Dashboard rich text editor implementation to remove Quill dependencies.
  - `src/pages/Dashboard.tsx` now uses a lightweight `contentEditable` rich text editor with a simple formatting toolbar.
  - Preserved existing three-mode workflow in Write sections: Markdown, Rich Text, Preview.
  - Preserved markdown <-> rich text conversion using existing Showdown and Turndown conversion flow.
  - Enabled image insertion in rich text mode through the existing `ImageUploadModal` flow.
- Updated rich text editor styles in `src/styles/global.css` for the new toolbar and editing surface.

### Fixed

- Fixed `@robelest/convex-auth` integration for dashboard admin access:
  - Auth client now properly initialized in `ConvexAuthWrapper` component to call `convex.setAuth()`
  - Added email lookup from auth component since JWT only contains subject (userId|sessionId)
  - Admin matching now works with `components.auth.public.userGetById` to fetch user email
  - Added `extractUserId()` helper to parse userId from subject format
- Fixed `versions:getStats` read-limit crash in Dashboard Version Control card by removing unbounded `contentVersions` table scan and switching to index-based oldest/newest lookups.
- Fixed dashboard sign-out in `convex-auth` mode by using the `@robelest/convex-auth` client sign-out flow in `src/pages/Dashboard.tsx`.
- Fixed false "Dashboard access is open" banner in `convex-auth` mode when `dashboard.requireAuth` is enabled.
- Resolved project typecheck failures in these files:
  - `src/components/AskAIModal.tsx`
  - `src/components/Layout.tsx`
  - `src/hooks/useSearchHighlighting.ts`
  - `src/pages/Post.tsx`
- Restored clean checks:
  - `npm run lint` passes
  - `npm run typecheck` passes
- Fixed strict typing in auth helpers:
  - `convex/auth.ts` now uses typed constructor parameter casting instead of `any`
  - `convex/dashboardAuth.ts` now uses generated `ActionCtx` and `QueryCtx` types

### Security

- Added optional strict dashboard email gate in `convex/dashboardAuth.ts` via `DASHBOARD_PRIMARY_ADMIN_EMAIL`.
- Added server-side dashboard admin authorization with new `dashboardAdmins` table and admin APIs in `convex/authAdmin.ts`.
- Enforced admin checks for dashboard-facing backend functions (`cms`, `posts.listAll`, `pages.listAll`, `newsletter` admin APIs, `versions`, `files`, and `importAction`).
- Locked down ConvexFS upload route authorization in `convex/http.ts` to require dashboard admin identity.
- Removed Quill-related vulnerable dependency chain from production dependencies.
- `npm audit --omit=dev` now reports `found 0 vulnerabilities`.

### Documentation

- Created `prds/adding-robel-auth.md` with complete migration guide including:
  - The fix summary (email lookup from auth component)
  - All problems encountered and solutions
  - Admin setup instructions for fork users
  - Non-admin user behavior documentation
  - Environment variables reference
  - GitHub OAuth setup guide
- Updated `FORK_CONFIG.md` with detailed admin setup instructions for fork users including bootstrap commands.

### Validation

- Ran runtime smoke checks for Ask AI modal and docs navigation flow in local development.
- Tested full GitHub OAuth flow with admin email verification.
- Re-ran migration validation checks:
  - `npm run lint`
  - `npm run typecheck`
  - `npx convex codegen`
  - `npm run build`

## [2.20.1] - 2026-01-11

### Added

- True delete for AI generated images in Dashboard AI Agent
  - Delete button with confirmation dialog replaces clear button
  - Removes image from both `aiGeneratedImages` table and Convex Storage
  - Added `by_storageId` index to `aiGeneratedImages` table for efficient lookup
  - Added `deleteGeneratedImage` mutation to `aiChats.ts`

### Technical

- Updated `convex/schema.ts` with `by_storageId` index on `aiGeneratedImages` table
- Added `deleteGeneratedImage` mutation in `convex/aiChats.ts`
- Updated `AIAgentSection` in Dashboard.tsx with delete confirmation modal
- Added delete button styles and confirmation dialog CSS in global.css
- Removed unused "Save to Media Library" feature (users can download and re-upload)

## [2.20.0] - 2026-01-11

### Added

- Dashboard frontmatter field synchronization
  - All 30+ frontmatter fields now sync between Dashboard UI and schema
  - Posts and pages editor supports all available frontmatter options
  - ContentItem interface updated with 19 new fields
  - postFrontmatterFields and pageFrontmatterFields arrays fully aligned

- Sync warning modal for synced content
  - Warning displayed when editing content created via `npm run sync`
  - Explains that local file changes will overwrite dashboard edits
  - Download button to save markdown file before editing
  - Copy button to copy markdown to clipboard
  - "Save Anyway" option for intentional edits
  - Dashboard-created content (`source: "dashboard"`) bypasses warning

- RC1 release blog post at /version-rc1
  - Documents semantic search, ConvexFS Media Library, OpenCode integration
  - Covers Ask AI, version control, and npx create-markdown-sync CLI

### Fixed

- Missing `unlisted` field in sync-posts.ts PostFrontmatter interface

### Technical

- Updated `ContentItem` interface in Dashboard.tsx with showImageAtTop, showInNav, readTime, layout, rightSidebar, aiChat, blogFeatured, newsletter, contactForm, unlisted, showFooter, footer, showSocialFooter, textAlign, docsSection, docsSectionGroup, docsSectionOrder, docsSectionGroupOrder, docsSectionGroupIcon, docsLanding, source
- Updated `postFrontmatterFields` array with all post-specific fields
- Updated `pageFrontmatterFields` array with all page-specific fields
- Created `SyncWarningModal` component in Dashboard.tsx
- Added `doSavePost` and `doSavePage` internal save functions
- Added `syncWarningModal` state for modal control
- Added `handleSyncWarningDownload`, `handleSyncWarningCopy`, `handleSaveAnywayFromModal` handlers
- Added CSS styles for sync warning modal in global.css

## [2.19.0] - 2026-01-10

### Added

- `npx create-markdown-sync` CLI for scaffolding new projects
  - Interactive wizard with 13 sections covering all configuration options
  - Clones template from GitHub via giget
  - Configures site settings automatically
  - Installs dependencies
  - Sets up Convex project (optional WorkOS auth disabled by default)
  - Starts dev server and opens browser
  - Clear next steps with docs, deployment, and WorkOS setup links

### Technical

- New `packages/create-markdown-sync/` monorepo package
- CLI files: index.ts, wizard.ts, clone.ts, configure.ts, install.ts, convex-setup.ts, utils.ts
- Template fixes for siteConfig.ts embedded quotes
- Empty auth.config.ts when auth not required (prevents WorkOS blocking)
- Added workspaces to root package.json
- Updated .gitignore for packages/_/dist/ and packages/_/node_modules/

## [2.18.2] - 2026-01-10

### Added

- Related posts thumbnail view with toggle
  - New thumbnail view shows post image, title, description, author, and date
  - Toggle button to switch between thumbnail and list views (same icons as homepage featured)
  - View preference saved to localStorage
  - Default view mode and toggle visibility configurable via siteConfig.relatedPosts
  - Dashboard Config section for related posts settings

### Changed

- Updated getRelatedPosts query to return image, excerpt, authorName, authorImage fields
- Related posts section now has header with title and optional toggle button

### Technical

- Added `RelatedPostsConfig` interface to siteConfig.ts
- Added `relatedPosts` configuration to SiteConfig interface
- Updated convex/posts.ts getRelatedPosts query with additional return fields
- Added related posts thumbnail CSS styles (~100 lines)
- Added relatedPostsDefaultViewMode and relatedPostsShowViewToggle to Dashboard ConfigSection

## [2.18.1] - 2026-01-10

### Changed

- README.md streamlined from 609 lines to 155 lines
  - Removed detailed feature documentation (now links to live docs)
  - Kept sync commands, setup, and Netlify deployment sections
  - Added Documentation section with links to markdown.fast/docs
  - Added Guides subsection with links to specific doc pages
  - Simplified Features section with link to About page
  - Simplified Fork Configuration to quick commands with doc link

## [2.18.0] - 2026-01-10

### Added

- OpenCode AI development tool integration
  - Full `.opencode/` directory structure for OpenCode CLI compatibility
  - 3 specialized agents: orchestrator, content-writer, sync-manager
  - 6 commands: /sync, /sync-prod, /create-post, /create-page, /import, /deploy
  - 4 skills: frontmatter, sync, convex, content
  - sync-helper plugin for content change reminders
  - Works alongside Claude Code and Cursor without conflicts

- OpenCode documentation page at /docs-opencode
  - How OpenCode integration works
  - Directory structure reference
  - Command and agent descriptions
  - Getting started guide

### Technical

- `opencode.json` - Root OpenCode project configuration
- `.opencode/config.json` - OpenCode app configuration
- `.opencode/agent/orchestrator.md` - Main routing agent
- `.opencode/agent/content-writer.md` - Content creation specialist
- `.opencode/agent/sync-manager.md` - Sync and deployment specialist
- `.opencode/command/sync.md` - /sync command definition
- `.opencode/command/sync-prod.md` - /sync-prod command
- `.opencode/command/create-post.md` - /create-post command
- `.opencode/command/create-page.md` - /create-page command
- `.opencode/command/import.md` - /import command
- `.opencode/command/deploy.md` - /deploy command
- `.opencode/skill/frontmatter.md` - Frontmatter reference (adapted from .claude/skills/)
- `.opencode/skill/sync.md` - Sync system reference
- `.opencode/skill/convex.md` - Convex patterns reference
- `.opencode/skill/content.md` - Content management guide
- `.opencode/plugin/sync-helper.ts` - Minimal reminder plugin
- `content/pages/docs-opencode.md` - Documentation page
- `files.md` - Added OpenCode Configuration section

## [2.17.0] - 2026-01-10

### Added

- ConvexFS Media Library with Bunny CDN integration
  - Upload images via drag-and-drop or click to upload
  - Copy as Markdown, HTML, or direct URL
  - Bulk select and delete multiple images
  - File size display and pagination
  - Configuration warning when Bunny CDN not configured

- Enhanced Image Insert Modal in Write Post/Page
  - Two tabs: "Upload New" and "Media Library" for selecting existing images
  - Image dimensions display (original size with aspect ratio)
  - Size presets: Original, Large (1200px), Medium (800px), Small (400px), Thumbnail (200px), Custom
  - Custom dimensions input with automatic aspect ratio preservation
  - Alt text field for accessibility
  - Calculated dimensions shown before insert

- File expiration support via ConvexFS
  - `setFileExpiration` action to set time-based auto-deletion
  - Pass `expiresInMs` for automatic cleanup after specified time
  - Pass `null` to remove expiration and make file permanent

### Technical

- `convex/convex.config.ts` - Added ConvexFS component registration
- `convex/fs.ts` - ConvexFS instance with Bunny CDN configuration, conditional instantiation
- `convex/files.ts` - File mutations/queries: commitFile, listFiles, deleteFile, deleteFiles, setFileExpiration, isConfigured
- `convex/http.ts` - ConvexFS routes for /fs/upload and /fs/blobs/{blobId}
- `src/components/MediaLibrary.tsx` - Media library gallery with bulk select/delete
- `src/components/ImageUploadModal.tsx` - Enhanced modal with library selection and size presets
- `src/styles/global.css` - Added ~400 lines for media library and image modal styles
- `content/pages/docs-media-setup.md` - Setup documentation with ConvexFS links

## [2.16.4] - 2026-01-10

### Added

- AI image generation download and copy options
  - Download button to save generated image to computer
  - MD button to copy Markdown code (`![prompt](url)`) to clipboard
  - HTML button to copy HTML code (`<img src="url" alt="prompt" />`) to clipboard
  - Code preview section showing both Markdown and HTML snippets
  - Filename generated from prompt (sanitized and truncated)

### Technical

- `src/pages/Dashboard.tsx` - Added copiedFormat state, getMarkdownCode/getHtmlCode helpers, handleCopyCode, handleDownloadImage functions, updated generated image display JSX
- `src/styles/global.css` - Added CSS for .ai-image-actions, .ai-image-action-btn, .ai-image-code-preview, .ai-image-code-block

## [2.16.3] - 2026-01-10

### Added

- Social icons in hamburger menu (MobileMenu)
  - Social icons now appear below navigation links in mobile menu
  - Only shows when `socialFooter.enabled` and `socialFooter.showInHeader` are true
  - Imported `platformIcons` from SocialFooter for consistent icon rendering

- Dashboard Config options for social and AI features
  - Added `socialFooter.showInHeader` toggle to Social Footer config card
  - Added new Ask AI config card with `askAI.enabled` toggle
  - Generated siteConfig.ts includes both new options

- Configuration alignment documentation for AI/LLMs
  - Added "Configuration alignment" section to CLAUDE.md
  - Added sync comment to top of `src/config/siteConfig.ts`
  - Added JSDoc comment to ConfigSection in Dashboard.tsx
  - Explains relationship between siteConfig.ts and Dashboard Config

### Changed

- Removed social icons from mobile header
  - Social icons no longer display in `mobile-nav-controls` (header on mobile)
  - Social icons now exclusively in hamburger menu for cleaner mobile header
  - Added comment in Layout.tsx noting social icons are in MobileMenu

### Technical

- `src/components/MobileMenu.tsx` - Added social icons section with platformIcons import
- `src/components/Layout.tsx` - Removed social icons from mobile-nav-controls
- `src/pages/Dashboard.tsx` - Added socialFooterShowInHeader and askAIEnabled to ConfigSection
- `src/styles/global.css` - Added mobile-menu-social CSS styles
- `src/config/siteConfig.ts` - Added alignment comment header
- `CLAUDE.md` - Added Configuration alignment section and Dashboard.tsx to key files

## [2.16.2] - 2026-01-10

### Added

- Ask AI configuration documentation alignment
  - Added `askAI` config to `fork-config.json.example` with enabled, defaultModel, and models fields
  - Added Ask AI Configuration section to `FORK_CONFIG.md` with fork-config.json and manual configuration examples
  - Added Ask AI (header chat) section to `docs-dashboard.md` with configuration and requirements
  - Added Ask AI (header chat) section to `how-to-use-the-markdown-sync-dashboard.md` with step-by-step setup

### Technical

- `fork-config.json.example` now includes askAI config matching siteConfig.ts structure
- All dashboard documentation now includes Ask AI feature alongside AI Agent and AI Dashboard sections

## [2.16.1] - 2026-01-10

### Fixed

- Docs layout scrollbar hiding for cleaner UI
  - Hidden scrollbars on left sidebar, right sidebar, and main docs content
  - Scrolling still works via trackpad, mouse wheel, and touch
  - Added `body:has(.docs-layout)` to prevent page-level scrolling on docs pages
  - Cross-browser support: `-ms-overflow-style: none` (IE/Edge), `scrollbar-width: none` (Firefox), `::-webkit-scrollbar { width: 0 }` (Chrome/Safari)

### Technical

- Updated `src/styles/global.css`:
  - Added `body:has(.docs-layout) { overflow: hidden; }` rule
  - Added scrollbar hiding rules for `.docs-sidebar-left`, `.docs-sidebar-right`, `.docs-content`
  - Existing scrollbar thumb/track styles remain but are invisible with width: 0

## [2.16.0] - 2026-01-09

### Added

- Sync version control system
  - 3-day version history for posts, pages, home content, and footer
  - Dashboard toggle to enable/disable version control
  - Version history modal with unified diff visualization using DiffCodeBlock component
  - Preview mode to view previous version content
  - One-click restore with automatic backup of current state
  - Automatic cleanup of versions older than 3 days (daily cron at 3 AM UTC)
  - Version stats display in Config section (total, posts, pages)

### Technical

- New `convex/versions.ts` with 7 functions:
  - `isEnabled` / `setEnabled` - Toggle version control
  - `createVersion` - Capture content snapshot (internal mutation)
  - `getVersionHistory` / `getVersion` - Query version data
  - `restoreVersion` - Restore with backup creation
  - `cleanupOldVersions` - Batch delete old versions
  - `getStats` - Version count statistics
- New `contentVersions` table in schema with indexes:
  - `by_content` - Query by content type and ID
  - `by_slug` - Query by content type and slug
  - `by_createdAt` - For cleanup queries
  - `by_content_createdAt` - Compound index for history
- New `versionControlSettings` table for toggle state
- New `src/components/VersionHistoryModal.tsx` component
- Updated `convex/cms.ts` to capture versions before dashboard edits
- Updated `convex/posts.ts` to capture versions before sync updates
- Updated `convex/pages.ts` to capture versions before sync updates
- Updated `convex/crons.ts` with daily cleanup job
- Added ~370 lines of CSS for version modal UI

## [2.15.3] - 2026-01-09

### Fixed

- Footer not displaying on `/docs` landing page when `showFooter: true` in frontmatter
  - `DocsPage.tsx` was missing the Footer component entirely
  - Added Footer import, footerPage query, and footer rendering logic to DocsPage.tsx
  - Footer now respects `showFooter` frontmatter field on docs landing pages
  - AI chat support added to DocsLayout via `aiChatEnabled` and `pageContent` props

### Changed

- Updated `getDocsLandingPage` query in `convex/pages.ts` to return `showFooter`, `footer`, `excerpt`, and `aiChat` fields
- Updated `getDocsLandingPost` query in `convex/posts.ts` to return `showFooter`, `footer`, and `aiChat` fields

## [2.15.2] - 2026-01-08

### Fixed

- Docs section layout CSS conflict with main-content container
  - Fixed `.main-content` max-width: 800px constraint preventing docs layout from being full width
  - Added `.main-content:has(.docs-layout)` rule to expand to 100% width when docs layout is used
  - Updated Layout.tsx to use `main-content-wide` class for docs pages
  - Fixed left sidebar not flush left and right sidebar not flush right
  - Fixed responsive margins for docs layout (280px desktop, 240px tablet, 0 mobile)

### Technical

- Updated `src/styles/global.css`:
  - Added `.main-content:has(.docs-layout) { max-width: 100%; padding: 0; }`
  - Fixed `.docs-content` margins: 280px left/right for fixed sidebars
  - Added responsive margin adjustments at 1200px, 900px, 768px breakpoints
- Updated `src/components/Layout.tsx`:
  - Added `isDocsPage` check to className logic for main element
  - Docs pages now use `main-content-wide` class for full width layout

## [2.15.1] - 2026-01-08

### Fixed

- Additional Core Web Vitals improvements for CLS and INP
  - Added `aspect-ratio: 16/10` to `.blog-image` to reserve space before images load
  - Added `aspect-ratio: 16/9` to `.post-header-image-img` to prevent layout shift
  - Added `contain: layout style` to `.main-content` and `.main-content-wide` to isolate layout recalculations
  - Added `fetchPriority="high"` to logo image for faster LCP
  - Added `fetchPriority="high"` to header images (`showImageAtTop`) for faster LCP
  - Added `will-change: transform` to continuous spin animations (`.spinner-icon`, `.animate-spin`, `.ai-chat-spinner`, `.ai-image-spinner`, `.spinning`, `.dashboard-import-btn .spin`)
  - Added `will-change: transform` to `.logo-marquee-track` for smoother marquee animation
  - Added `will-change: opacity` to `.visitor-map-badge-dot` for smoother pulse animation

### Technical

- Updated `src/styles/global.css` with CLS prevention and animation optimization
- Updated `src/components/Layout.tsx` with fetchPriority on logo
- Updated `src/pages/Post.tsx` with fetchPriority on header images

## [2.15.0] - 2026-01-07

### Added

- Export as PDF option in CopyPageDropdown
  - Browser-based print dialog for saving pages as PDF
  - Clean formatted output (no markdown syntax visible)
  - Title displayed as proper heading
  - Metadata shown as clean line (date, read time, tags)
  - Content with markdown stripped for readable document
  - Uses Phosphor FilePdf icon
  - Positioned at end of dropdown menu

### Technical

- Added `formatForPrint` function to strip markdown syntax from content
- Added `handleExportPDF` handler with styled print window
- Imports `FilePdf` from `@phosphor-icons/react` (already installed)

## [2.14.1] - 2026-01-07

### Fixed

- Additional Core Web Vitals animation fixes
  - Fixed `docs-skeleton-pulse` animation (converted from `background-position` to `transform: translateX()` via pseudo-element)
  - Added `will-change` hints to 6 more animated elements for GPU compositing

### Technical

- Updated `src/styles/global.css`:
  - Converted docs-loading-skeleton from background animation to pseudo-element with translateX
  - Added `will-change` to `.image-lightbox-backdrop`, `.search-modal`, `.ai-chat-message`, `.dashboard-toast`, `.ask-ai-modal`, `.docs-article`

## [2.14.0] - 2026-01-07

### Fixed

- Core Web Vitals performance optimizations
  - Fixed non-composited animations in visitor map (SVG `r` attribute changed to `transform: scale()`)
  - Removed 5 duplicate `@keyframes spin` definitions from global.css
  - Added `will-change` hints to animated elements for GPU compositing

### Added

- Critical CSS inlined in index.html for faster first paint
  - Theme variables (dark/light/tan/cloud)
  - Reset and base body styles
  - Layout skeleton and navigation styles
- Additional resource hints in index.html
  - Preconnect to convex.site for faster API calls

### Technical

- Updated `src/styles/global.css`:
  - Converted visitor-pulse animations from SVG `r` to `transform: scale()` (GPU-composited)
  - Added `transform-origin`, `transform-box`, and `will-change` to pulse ring elements
  - Added `will-change` to `.theme-toggle`, `.copy-page-menu`, `.search-modal-backdrop`, `.scroll-to-top`
  - Removed duplicate `@keyframes spin` at lines 9194, 10091, 10243, 10651, 13726
- Updated `src/components/VisitorMap.tsx`:
  - Changed pulse ring `r` values from 12/8 to base value 5 (scaling handled by CSS)
- Updated `index.html`:
  - Added inline critical CSS (~2KB) for instant first contentful paint
  - Added preconnect/dns-prefetch for convex.site

## [2.13.0] - 2026-01-07

### Added

- Enhanced diff code block rendering with @pierre/diffs library
  - Diff and patch code blocks now render with Shiki-based syntax highlighting
  - Unified and split (side-by-side) view modes with toggle button
  - Theme-aware colors (dark/light/tan/cloud support)
  - Copy button for diff content
  - Automatic routing: `diff and `patch blocks use enhanced renderer
- New blog post: "How to Use Code Blocks" with syntax highlighting and diff examples
- DiffCodeBlock component (`src/components/DiffCodeBlock.tsx`)

### Technical

- Added `@pierre/diffs` package for enhanced diff visualization
- Updated `BlogPost.tsx` to route diff/patch language blocks to DiffCodeBlock
- Added diff block CSS styles to `global.css`
- Added `vendor-diffs` chunk to Vite config for code splitting
- Updated `files.md` with DiffCodeBlock documentation

## [2.12.0] - 2026-01-07

### Fixed

- Canonical URL mismatch between raw and rendered HTML (GitHub Issue #6)
  - Raw HTML was showing homepage canonical URL instead of page-specific canonical
  - Added search engine bot detection to serve pre-rendered HTML with correct canonical URLs
  - Search engines (Google, Bing, DuckDuckGo, etc.) now receive correct canonical tags in initial HTML

### Added

- SEO Bot Configuration section in FORK_CONFIG.md for developers who fork the app
- SEO and Bot Detection section in setup-guide.md with configuration examples
- `SEARCH_ENGINE_BOTS` array in `netlify/edge-functions/botMeta.ts` for customizable bot detection
- `isSearchEngineBot()` helper function for search engine crawler detection
- Documentation header in botMeta.ts explaining bot detection configuration

### Technical

- Updated `netlify/edge-functions/botMeta.ts`:
  - Added configuration documentation header explaining three bot categories
  - Added SEARCH_ENGINE_BOTS array (googlebot, bingbot, yandexbot, duckduckbot, baiduspider, sogou, yahoo! slurp, applebot)
  - Added isSearchEngineBot() function
  - Updated condition to serve pre-rendered HTML to both social preview and search engine bots

## [2.11.0] - 2026-01-06

### Added

- Ask AI header button with RAG-based Q&A about site content
  - Header button with sparkle icon (before search button, after social icons)
  - Keyboard shortcuts: Cmd+J or Cmd+/ (Mac), Ctrl+J or Ctrl+/ (Windows/Linux)
  - Real-time streaming responses via Convex Persistent Text Streaming
  - Model selector: Claude Sonnet 4 (default) or GPT-4o
  - Markdown rendering with syntax highlighting in responses
  - Internal links use React Router for seamless navigation
  - Source citations with links to referenced posts/pages
  - Copy response button (hover to reveal) for copying AI answers
  - Clear chat button to reset conversation
- AskAIConfig in siteConfig.ts for configuration
  - `enabled`: Toggle Ask AI feature
  - `defaultModel`: Default model ID
  - `models`: Array of available models with id, name, and provider

### How It Works

1. User question stored in database with session ID
2. Query converted to embedding using OpenAI text-embedding-ada-002
3. Vector search finds top 5 relevant posts/pages
4. Content sent to selected AI model with RAG system prompt
5. Response streams in real-time with source citations appended

### Technical

- New component: `src/components/AskAIModal.tsx` with StreamingMessage subcomponent
- New file: `convex/askAI.ts` - Session mutations and queries (regular runtime)
- New file: `convex/askAI.node.ts` - HTTP streaming action (Node.js runtime)
- New table: `askAISessions` with question, streamId, model, createdAt, sources fields
- New HTTP endpoint: `/ask-ai-stream` for streaming responses
- Updated `convex/convex.config.ts` with persistentTextStreaming component
- Updated `convex/http.ts` with /ask-ai-stream route and OPTIONS handler
- Updated `src/components/Layout.tsx` with Ask AI button and modal
- Updated `src/styles/global.css` with Ask AI modal styles

### Requirements

- `semanticSearch.enabled: true` in siteConfig (for embeddings)
- `OPENAI_API_KEY` in Convex (for embedding generation)
- `ANTHROPIC_API_KEY` in Convex (for Claude models)
- Run `npm run sync` to generate embeddings for content

## [2.10.2] - 2026-01-06

### Added

- SEO fixes for GitHub Issue #4 (7 issues resolved)
  - Canonical URL: Client-side dynamic canonical link tags for posts and pages
  - Single H1 per page: Markdown H1s demoted to H2 (`.blog-h1-demoted` class with H1 visual styling)
  - DOM order fix: Article loads before sidebar in DOM for SEO (CSS `order` property maintains visual layout)
  - X-Robots-Tag: HTTP header added via netlify.toml (`index, follow` for public, `noindex` for dashboard/api)
  - Hreflang tags: Self-referencing hreflang (en, x-default) for all pages
  - og:url consistency: Uses same canonicalUrl variable as canonical link
  - twitter:site meta tag: New TwitterConfig in siteConfig.ts for Twitter Cards

### Technical

- New `TwitterConfig` interface in `src/config/siteConfig.ts` with site and creator fields
- Updated `src/pages/Post.tsx` with SEO meta tags for both posts and pages (canonical, hreflang, og:url, twitter)
- Updated `src/pages/Post.tsx` DOM order: article before sidebar with CSS order for visual positioning
- Updated `src/components/BlogPost.tsx` h1 renderer outputs h2 with `.blog-h1-demoted` class
- Updated `src/styles/global.css` with `.blog-h1-demoted` styling and CSS order properties for sidebar
- Updated `convex/http.ts` generateMetaHtml() with hreflang and twitter:site tags
- Updated `netlify.toml` with X-Robots-Tag headers for public, dashboard, and API routes
- Updated `index.html` with canonical, hreflang, and twitter:site placeholder tags
- Updated `fork-config.json.example` with twitter configuration fields

## [2.10.1] - 2026-01-05

### Added

- Optional semantic search configuration via `siteConfig.semanticSearch`
  - New `enabled` toggle (default: `false` to avoid blocking forks without API key)
  - When disabled, search modal shows only keyword search (no mode toggle)
  - Embedding generation skipped during sync when disabled (saves API costs)
  - Existing embeddings preserved in database when disabled (no data loss)
  - Tab key shortcut hints hidden when semantic search is disabled
  - Dashboard config generator includes semantic search toggle

### Technical

- New `SemanticSearchConfig` interface in `src/config/siteConfig.ts`
- Updated `src/components/SearchModal.tsx` to conditionally render mode toggle
- Updated `scripts/sync-posts.ts` to check config before embedding generation
- Updated `src/pages/Dashboard.tsx` with semantic search config option
- Updated `FORK_CONFIG.md` with semantic search configuration section
- Updated `fork-config.json.example` with semanticSearch option
- Updated documentation: `docs-semantic-search.md`, `docs.md`

## [2.10.0] - 2026-01-05

### Added

- Semantic search using vector embeddings to complement existing keyword search
  - Toggle between "Keyword" and "Semantic" modes in search modal (Cmd+K)
  - Keyword search: exact word matching via Convex full-text search indexes (instant, free)
  - Semantic search: finds content by meaning using OpenAI text-embedding-ada-002 embeddings (~300ms, ~$0.0001/query)
  - Similarity scores displayed as percentages (90%+ = very similar, 70-90% = related)
  - Graceful fallback: semantic search returns empty results if OPENAI_API_KEY not configured
- Embedding generation during content sync
  - Embeddings generated automatically for posts and pages during `npm run sync`
  - Title and content combined for embedding generation
  - Content truncated to 8000 characters to stay within token limits
- New documentation pages
  - `docs-search.md`: Keyword search implementation with ASCII flowchart
  - `docs-semantic-search.md`: Semantic search guide with comparison table

### Technical

- New file: `convex/embeddings.ts` - Actions for embedding generation (Node.js runtime)
- New file: `convex/embeddingsQueries.ts` - Queries and mutations for embedding storage
- New file: `convex/semanticSearch.ts` - Vector search action with similarity scoring
- New file: `convex/semanticSearchQueries.ts` - Internal queries for hydrating search results
- Added `embedding` field (optional float64 array) to posts and pages tables in schema
- Added `by_embedding` vector index (1536 dimensions, filterFields: ["published"]) to posts and pages
- Updated `src/components/SearchModal.tsx` with mode toggle (TextAa/Brain icons) and semantic search integration
- Updated `scripts/sync-posts.ts` to call `generateMissingEmbeddings` after content sync
- Added search mode toggle CSS styles (.search-mode-toggle, .search-mode-btn)

### Environment Variables

- `OPENAI_API_KEY`: Required for semantic search (set via `npx convex env set OPENAI_API_KEY sk-xxx`)

## [2.9.0] - 2026-01-04

### Added

- Dashboard Cloud CMS features for WordPress-style content management
  - Dual source architecture: dashboard-created content (`source: "dashboard"`) and synced content (`source: "sync"`) coexist independently
  - Source badges in Posts and Pages list views (blue "Dashboard", gray "Synced")
  - Direct database operations: "Save to DB" button in Write sections, "Save Changes" in editor
  - Delete button for dashboard-created content with confirmation modal
  - Server-side URL import via Firecrawl (direct to database, no file sync needed)
  - Export to markdown functionality for backup or converting to file-based workflow
  - Bulk export script: `npm run export:db` and `npm run export:db:prod`
- Rich Text Editor in Write Post/Page sections
  - Three editing modes: Markdown (default), Rich Text (Quill WYSIWYG), Preview
  - Quill toolbar: headers, bold, italic, strikethrough, blockquote, code, lists, links
  - Automatic HTML-to-Markdown conversion when switching modes
  - Theme-aware styling
- Delete confirmation modal for posts and pages
  - Warning icon and danger-styled delete button
  - Shows item name and type being deleted
  - Backdrop click and Escape key to cancel

### Changed

- Posts and Pages list view grid layout adjusted for source badges
  - Column widths: title (1fr), date (110px), status (170px), actions (110px)
  - Added flex-wrap and gap for status column content
- Sync mutations now preserve dashboard-created content
  - Only affects content with `source: "sync"` or no source field

### Technical

- New file: `convex/cms.ts` with CRUD mutations for dashboard content
- New file: `convex/importAction.ts` with Firecrawl server-side action
- New file: `scripts/export-db-posts.ts` for bulk markdown export
- Added `source` field (optional union: "dashboard" | "sync") to posts and pages tables
- Added `by_source` index to posts and pages tables in schema
- Added ConfirmDeleteModal component with Warning icon from Phosphor
- Added source-badge CSS styles (.source-badge, .source-badge.dashboard, .source-badge.sync)
- Added delete modal styles (.dashboard-modal-delete, .dashboard-modal-icon-warning, .dashboard-modal-btn.danger)

## [2.8.7] - 2026-01-04

### Fixed

- Write page frontmatter sidebar toggle now works outside focus mode
  - Grid layout adjusts properly when frontmatter sidebar is collapsed
  - Previously only worked in focus mode due to missing CSS rules

### Technical

- Added `.write-layout.frontmatter-collapsed` CSS rule (grid-template-columns: 220px 1fr 56px)
- Added `.write-layout.sidebar-collapsed.frontmatter-collapsed` CSS rule for both sidebars collapsed
- Added responsive tablet styles for frontmatter collapsed state

## [2.8.6] - 2026-01-04

### Changed

- Fork configuration script now updates 14 files (was 11)
  - Added `src/pages/DocsPage.tsx` (SITE_URL constant)
  - Added `netlify/edge-functions/mcp.ts` (SITE_URL, SITE_NAME, MCP_SERVER_NAME)
  - Added `scripts/send-newsletter.ts` (default SITE_URL)
  - Improved `public/openapi.yaml` handling for all example URLs
- Logo gallery hrefs now use relative URLs instead of hardcoded markdown.fast URLs
  - Links like `/how-to-use-firecrawl`, `/docs`, `/setup-guide` work on any forked site
- Updated `fork-config.json.example` with missing options (statsPage, mcpServer, imageLightbox)

### Technical

- Updated `scripts/configure-fork.ts` with new update functions: `updateDocsPageTsx()`, `updateMcpEdgeFunction()`, `updateSendNewsletter()`
- Updated `FORK_CONFIG.md` with complete file list and updated AI agent prompt
- Updated `content/blog/fork-configuration-guide.md` with accurate file count and output example

## [2.8.5] - 2026-01-03

### Added

- Search result highlighting and scroll-to-match feature
  - Clicking a search result navigates to the exact match location (not just the heading)
  - All matching text is highlighted with theme-appropriate colors
  - Highlights pulse on arrival, then fade to subtle background after 4 seconds
  - Press Escape to clear highlights
  - Works across all four themes (dark, light, tan, cloud)

### Technical

- Created `src/hooks/useSearchHighlighting.ts` hook with polling mechanism to wait for content load
- Updated `src/components/SearchModal.tsx` to pass search query via `?q=` URL parameter
- Updated `src/components/BlogPost.tsx` with article ref for highlighting
- Updated `src/pages/Post.tsx` to defer scroll handling to highlighting hook when `?q=` present
- Added `.search-highlight` and `.search-highlight-active` CSS styles with theme-specific colors

## [2.8.4] - 2026-01-03

### Changed

- AI service links (ChatGPT, Claude, Perplexity) now use local `/raw/{slug}.md` URLs instead of GitHub raw URLs
- Simplified AI prompt from multi-line instructions to "Read this URL and summarize it:"

### Technical

- Updated `src/components/CopyPageDropdown.tsx` to construct URLs using `window.location.origin`
- Removed unused `siteConfig` import and `getGitHubRawUrl` function

## [2.8.3] - 2026-01-03

### Changed

- `raw/index.md` now includes home.md and footer.md content
  - Home intro content from `content/pages/home.md` (slug: home-intro) displays at top
  - Footer content from `content/pages/footer.md` (slug: footer) displays at bottom
  - Mirrors the actual homepage structure for AI agents reading raw markdown
  - Falls back to generic message if home-intro page not found

### Technical

- Updated `generateHomepageIndex` function in `scripts/sync-posts.ts`
- Finds home-intro and footer pages from published pages array
- Adds horizontal rule separators between sections

## [2.8.2] - 2026-01-03

### Fixed

- Footer not displaying on docs section posts/pages even with `showFooter: true` in frontmatter
  - Post.tsx now fetches footer.md content from Convex (matching Home.tsx and Blog.tsx pattern)
  - Footer falls back to footer.md content when no per-post `footer:` frontmatter is specified
  - Priority order: per-post frontmatter `footer:` field > synced footer.md content > siteConfig.footer.defaultContent

### Technical

- Added `useQuery(api.pages.getPageBySlug, { slug: "footer" })` to Post.tsx
- Updated all 4 Footer component calls to use `post.footer || footerPage?.content` pattern

## [2.8.1] - 2026-01-03

### Changed

- Centralized `defaultTheme` configuration in `siteConfig.ts`
  - Theme is now configured via `defaultTheme` field in siteConfig instead of ThemeContext.tsx
  - ThemeContext.tsx now imports and uses `siteConfig.defaultTheme` with fallback to "tan"
  - Fork configuration script (`configure-fork.ts`) now updates siteConfig.ts for theme changes
  - Backward compatible: existing sites work without changes

### Technical

- Added `Theme` type export to `src/config/siteConfig.ts`
- Added `defaultTheme?: Theme` field to SiteConfig interface
- Updated `src/context/ThemeContext.tsx` to import from siteConfig
- Renamed `updateThemeContext` to `updateThemeConfig` in `scripts/configure-fork.ts`
- Updated documentation: `docs.md`, `setup-guide.md`, `FORK_CONFIG.md`, `fork-configuration-guide.md`

## [2.8.0] - 2026-01-03

### Added

- `docsSectionGroupIcon` frontmatter field for docs sidebar group icons
  - Display Phosphor icons next to docs sidebar group titles
  - Icon appears left of the expand/collapse chevron
  - 55 supported icon names (Rocket, Book, PuzzlePiece, Gear, Code, etc.)
  - Icon weight: regular, size: 16px
  - Only one item per group needs to specify the icon
  - Graceful fallback if icon name not recognized

### Technical

- Updated `convex/schema.ts` to include `docsSectionGroupIcon` field in posts and pages tables
- Updated `convex/posts.ts` and `convex/pages.ts` queries and mutations to handle `docsSectionGroupIcon`
- Updated `scripts/sync-posts.ts` to parse `docsSectionGroupIcon` from frontmatter
- Updated `src/components/DocsSidebar.tsx` with Phosphor icon imports and rendering
- Added CSS styles for `.docs-sidebar-group-icon` in `src/styles/global.css`
- Updated `.claude/skills/frontmatter.md` with icon documentation and supported icon list

## [2.7.0] - 2026-01-02

### Added

- `docsSectionGroupOrder` frontmatter field for controlling docs sidebar group order
  - Groups are sorted by the minimum `docsSectionGroupOrder` value among items in each group
  - Lower numbers appear first, groups without this field sort alphabetically
  - Works alongside `docsSection`, `docsSectionGroup`, and `docsSectionOrder` fields

### Technical

- Updated `convex/schema.ts` to include `docsSectionGroupOrder` field in posts and pages tables
- Updated `convex/posts.ts` and `convex/pages.ts` queries and mutations to handle `docsSectionGroupOrder`
- Updated `scripts/sync-posts.ts` to parse `docsSectionGroupOrder` from frontmatter
- Updated `src/components/DocsSidebar.tsx` to sort groups by `docsSectionGroupOrder`

## [2.6.0] - 2026-01-01

### Added

- Multi-model AI chat support in Dashboard
  - Model dropdown selector to choose between Anthropic (Claude Sonnet 4), OpenAI (GPT-4o), and Google (Gemini 2.0 Flash)
  - Lazy API key validation: errors only shown when user tries to use a specific model
  - Each provider has friendly setup instructions with links to get API keys
- AI Image Generation tab in Dashboard
  - Generate images using Gemini models (Nano Banana and Nano Banana Pro)
  - Aspect ratio selector (1:1, 16:9, 9:16, 4:3, 3:4)
  - Generated images stored in Convex storage with session tracking
  - Markdown-rendered error messages with setup instructions
- New `aiDashboard` configuration in siteConfig
  - `enableImageGeneration`: Toggle image generation tab
  - `defaultTextModel`: Set default AI model for chat
  - `textModels`: Configure available text chat models
  - `imageModels`: Configure available image generation models

### Technical

- Updated `convex/aiChatActions.ts` to support multiple AI providers
  - Added `callAnthropicApi`, `callOpenAIApi`, `callGeminiApi` helper functions
  - Added `getProviderFromModel` to determine provider from model ID
  - Added `getApiKeyForProvider` for lazy API key retrieval
  - Added `getNotConfiguredMessage` for provider-specific setup instructions
- Updated `src/components/AIChatView.tsx` with `selectedModel` prop
- Updated `src/pages/Dashboard.tsx` with new `AIAgentSection`
  - Tab-based UI for Chat and Image Generation
  - Model dropdowns with provider labels
  - Aspect ratio selector for image generation
- Added CSS styles for AI Agent section in `src/styles/global.css`
  - `.ai-agent-tabs`, `.ai-agent-tab` for tab navigation
  - `.ai-model-selector`, `.ai-model-dropdown` for model selection
  - `.ai-aspect-ratio-selector` for aspect ratio options
  - `.ai-generated-image`, `.ai-image-error`, `.ai-image-loading` for image display

### Environment Variables

- `ANTHROPIC_API_KEY`: Required for Claude models
- `OPENAI_API_KEY`: Required for GPT-4o
- `GOOGLE_AI_API_KEY`: Required for Gemini text chat and image generation

## [2.5.0] - 2026-01-01

### Added

- Social footer icons in header navigation
  - New `showInHeader` option in `siteConfig.socialFooter` to display social icons in the header
  - Social icons appear left of the search icon on desktop viewports
  - Uses same icons and links as the social footer component
  - Configurable via siteConfig, FORK_CONFIG.md, and fork-config.json
  - Disabled by default (set `showInHeader: true` to enable)

### Technical

- Exported `platformIcons` from `SocialFooter.tsx` for reuse in Layout component
- Added social icon rendering in `Layout.tsx` header controls
- Added `.header-social-links` and `.header-social-link` CSS styles in `global.css`
- Updated `SocialFooterConfig` interface with `showInHeader: boolean`
- Added socialFooter support to `configure-fork.ts` script
- Updated documentation: FORK_CONFIG.md, fork-config.json.example, docs.md, setup-guide.md

## [2.4.0] - 2026-01-01

### Added

- YouTube and Twitter/X embed support with domain whitelisting
  - Embed YouTube videos and Twitter/X posts directly in markdown
  - Domain whitelisting for security (only trusted domains allowed)
  - Whitelisted domains: `youtube.com`, `www.youtube.com`, `youtube-nocookie.com`, `www.youtube-nocookie.com`, `platform.twitter.com`, `platform.x.com`
  - Auto-adds `sandbox="allow-scripts allow-same-origin allow-popups"` for security
  - Auto-adds `loading="lazy"` for performance
  - Non-whitelisted iframes silently blocked
  - Works on both blog posts and pages
- Embeds section in markdown-with-code-examples.md with YouTube and Twitter/X examples

### Technical

- Added `ALLOWED_IFRAME_DOMAINS` constant in `src/components/BlogPost.tsx`
- Added `iframe` to sanitize schema tagNames with allowed attributes (`src`, `width`, `height`, `allow`, `allowfullscreen`, `frameborder`, `title`, `style`)
- Added custom `iframe` component handler with URL validation against whitelisted domains
- Added `.embed-container` CSS styles to `src/styles/global.css` for responsive embeds

## [2.3.0] - 2025-12-31

### Added

- Author pages at `/author/:authorSlug` with post list
  - Click on any author name in a post to view all their posts
  - View mode toggle (list/cards) with localStorage persistence
  - Mobile responsive layout matching tag pages design
  - Sitemap updated to include all author pages dynamically
- New Convex queries for author data
  - `getAllAuthors`: Returns all unique authors with post counts
  - `getPostsByAuthor`: Returns posts by a specific author slug
- Author name links in post headers
  - Author names now clickable with hover underline effect
  - Works on both blog posts and pages with authorName field

### Technical

- Added `by_authorName` index to posts table in `convex/schema.ts`
- New queries in `convex/posts.ts`: `getAllAuthors`, `getPostsByAuthor`
- New component: `src/pages/AuthorPage.tsx` (based on TagPage.tsx pattern)
- Added route `/author/:authorSlug` in `src/App.tsx`
- Updated `src/pages/Post.tsx` to make authorName a clickable Link
- Added author link and page styles to `src/styles/global.css`
- Added author pages to sitemap in `convex/http.ts`

## [2.2.2] - 2025-12-31

### Fixed

- Homepage intro loading flash
  - Removed "Loading..." text from Suspense fallback in main.tsx to prevent flash on app load
  - Updated Home.tsx to render nothing while homeIntro query loads (prevents bio text flash)
  - Home intro content now appears without any visible loading state or fallback text
  - Matches the same loading pattern used by Post.tsx for docs pages

### Technical

- Updated: `src/main.tsx` - Changed LoadingFallback to render empty div instead of "Loading..." text
- Updated: `src/pages/Home.tsx` - Changed conditional from `homeIntro ?` to `homeIntro === undefined ? null : homeIntro ?`

## [2.2.1] - 2025-12-31

### Fixed

- ES module compatibility for configure-fork.ts
  - Fixed `__dirname is not defined` error when running `npm run configure`
  - Added `fileURLToPath` import from `url` module
  - Created ES module equivalent of `__dirname` using `import.meta.url`
  - Script now works correctly with `"type": "module"` in package.json

### Technical

- Updated: `scripts/configure-fork.ts` - Added ES module compatible \_\_dirname using fileURLToPath

## [2.2.0] - 2025-12-30

### Added

- Footer content via markdown page
  - New `content/pages/footer.md` for managing footer content via markdown sync
  - Footer content syncs with `npm run sync` without redeploy needed
  - Edit footer text, links, and formatting through markdown instead of code
  - Falls back to `siteConfig.footer.defaultContent` when page not found
  - Set `showInNav: false` to hide from navigation (page remains accessible via direct URL)
  - Supports full markdown including links, paragraphs, and line breaks

### Changed

- `src/pages/Home.tsx`: Fetches footer page by slug "footer" and passes content to Footer component
- `src/pages/Blog.tsx`: Fetches footer page by slug "footer" and passes content to Footer component
- Footer component now prioritizes page content over siteConfig.defaultContent

### Technical

- New file: `content/pages/footer.md` with frontmatter (slug: "footer", showInNav: false)
- Uses existing `api.pages.getPageBySlug` query to fetch footer content
- Pattern matches `home-intro` page for consistent content management

## [2.1.0] - 2025-12-30

### Added

- CLAUDE.md for Claude Code project instructions
  - Project context and quick start guide
  - All available npm commands and workflows
  - Code conventions and "do not" list
  - Key file references and project structure
  - Links to detailed skills documentation
- Claude skills documentation in `.claude/skills/` directory
  - `frontmatter.md`: Complete frontmatter syntax with all 25+ field options for posts and pages
  - `convex.md`: Convex patterns specific to this app (indexes, idempotent mutations, write conflict prevention)
  - `sync.md`: How sync commands work and content flow from markdown to Convex database
- Automated CLAUDE.md updates via sync-discovery-files.ts
  - CLAUDE.md status comment updated during `npm run sync:discovery`
  - Includes current site name, post count, page count, and last updated timestamp
- Unlisted posts feature
  - New `unlisted` frontmatter field for blog posts
  - Set `unlisted: true` to hide posts from listings while keeping them accessible via direct link
  - Unlisted posts are excluded from: blog listings, featured sections, tag pages, search results, and related posts
  - Posts remain accessible via direct URL (e.g., `/blog/post-slug`)
  - Useful for draft posts, private content, or posts you want to share via direct link only

### Technical

- New file: `CLAUDE.md` in project root
- New directory: `.claude/skills/` with three markdown files
- Updated: `scripts/sync-discovery-files.ts` to update CLAUDE.md alongside AGENTS.md and llms.txt
- Updated: `convex/schema.ts` - Added `unlisted` optional boolean field to posts table
- Updated: `convex/posts.ts` - All listing queries filter out unlisted posts (getAllPosts, getBlogFeaturedPosts, getFeaturedPosts, getAllTags, getPostsByTag, getRelatedPosts, getRecentPostsInternal)
- Updated: `convex/search.ts` - Search excludes unlisted posts from results
- Updated: `scripts/sync-posts.ts` - Added `unlisted` to PostFrontmatter and ParsedPost interfaces and parsing logic
- Updated: `src/pages/Write.tsx` - Added `unlisted` to POST_FIELDS frontmatter reference
- Updated documentation: `.claude/skills/frontmatter.md`, `content/pages/docs.md`, `content/blog/setup-guide.md`, `files.md`

## [2.0.0] - 2025-12-29

### Added

- Markdown sync v2 complete
  - Full markdown content synchronization system
  - Real-time sync from markdown files to Convex database
  - Dashboard UI for content management
  - Sync server for executing sync commands from UI
  - Complete type safety across all Convex functions
  - Security improvements and optimizations

### Technical

- Optimized `recordPageView` mutation to reduce unnecessary reads
- All mutations follow Convex best practices for write conflict prevention
- Type-safe Convex functions with proper validators
- Security review completed with all endpoints properly secured

## [1.47.0] - 2025-12-29

### Added

- Image lightbox for blog posts and pages
  - Images automatically open in full-screen lightbox when clicked (if enabled)
  - Lightbox includes dark backdrop, close button (X icon), and caption display
  - Keyboard support: Press Escape to close lightbox
  - Click outside image (backdrop) to close
  - Alt text displayed as caption below image in lightbox
  - Images show pointer cursor (`zoom-in`) and subtle hover effect when lightbox is enabled
  - Configurable via `siteConfig.imageLightbox.enabled` (default: `true`)
  - Dashboard config generator includes image lightbox toggle
  - Responsive design: lightbox adapts to mobile screens

### Technical

- New component: `ImageLightbox` in `src/components/BlogPost.tsx`
- New interface: `ImageLightboxConfig` in `src/config/siteConfig.ts`
- Updated: `src/components/BlogPost.tsx` - Added lightbox state management and click handlers
- Updated: `src/styles/global.css` - Added lightbox styles (`.image-lightbox-backdrop`, `.image-lightbox-img`, `.image-lightbox-close`, `.image-lightbox-caption`)
- Updated: `src/pages/Dashboard.tsx` - Added image lightbox configuration option
- Updated: `content/pages/docs.md` - Added image lightbox documentation
- Updated: `content/blog/setup-guide.md` - Added image lightbox documentation

## [1.46.0] - 2025-12-29

### Added

- Dashboard sync server for executing sync commands from UI
  - Local HTTP server (`scripts/sync-server.ts`) runs on localhost:3001
  - Execute sync commands directly from dashboard without opening terminal
  - Real-time output streaming in dashboard terminal view
  - Server status indicator (online/offline) in dashboard sync section
  - Copy and Execute buttons for each sync command
  - Optional token authentication via `SYNC_TOKEN` environment variable
  - Whitelisted commands only (sync, sync:prod, sync:discovery, sync:discovery:prod, sync:all, sync:all:prod)
  - Health check endpoint at `/health` for server availability
  - CORS enabled for localhost:5173 (dev server)
  - Header sync buttons use sync server when available, fallback to command modal
  - Copy icons for `npm run sync-server` command in dashboard sync settings

### Technical

- New file: `scripts/sync-server.ts` - Local HTTP server using Node.js http module
- New npm script: `sync-server` - Start the local sync server
- Updated: `src/pages/Dashboard.tsx` - Sync server integration with health checks, execute functionality, and terminal output display
- Updated: `src/styles/global.css` - Styles for sync server status, terminal output, and copy buttons

## [1.45.0] - 2025-12-29

### Added

- Dashboard and WorkOS authentication integration
  - Dashboard supports optional WorkOS authentication via `siteConfig.dashboard.requireAuth`
  - WorkOS is optional - dashboard works with or without WorkOS configured
  - When `requireAuth` is `false`, dashboard is open access
  - When `requireAuth` is `true` and WorkOS is configured, dashboard requires login
  - Shows setup instructions if `requireAuth` is `true` but WorkOS is not configured
  - Warning banner displayed when authentication is not enabled
- Blog posts
  - "How to use the Markdown sync dashboard" - Complete guide to dashboard features and usage
  - "How to setup WorkOS" - Step-by-step WorkOS AuthKit setup guide
- Documentation updates
  - README.md: Added dashboard and WorkOS section with links to blog posts
  - docs.md: Added dashboard and WorkOS authentication sections
  - setup-guide.md: Added dashboard and WorkOS authentication sections
  - FORK_CONFIG.md: Added dashboard configuration information
  - fork-config.json.example: Added dashboard configuration option
  - files.md: Updated with dashboard and WorkOS file descriptions

### Technical

- New file: `src/utils/workos.ts` - WorkOS configuration utility
- Updated: `src/main.tsx` - Conditional WorkOS providers with lazy loading
- Updated: `src/App.tsx` - Callback route handling for WorkOS OAuth
- Updated: `src/pages/Dashboard.tsx` - Optional WorkOS authentication integration
- Updated: `src/pages/Callback.tsx` - OAuth callback handler for WorkOS
- Updated: `convex/auth.config.ts` - Convex authentication configuration for WorkOS
- Updated: `src/config/siteConfig.ts` - Dashboard configuration with requireAuth option

## [1.44.0] - 2025-12-29

### Added

- Dashboard at `/dashboard` for centralized content management and site configuration
  - Content management: Posts and Pages list views with filtering, search, pagination, and items per page selector (15, 25, 50, 100)
  - Post and Page editor: Markdown editor with live preview, draggable/resizable frontmatter sidebar (200px-600px), independent scrolling, download markdown, copy to clipboard
  - Write Post and Write Page: Full-screen writing interface with markdown editor, frontmatter reference, download markdown, localStorage persistence
  - AI Agent section: Dedicated AI chat separate from Write page, uses Anthropic Claude API, per-session chat history, markdown rendering
  - Newsletter management: All Newsletter Admin features integrated (subscribers, send newsletter, write email, recent sends, email stats)
  - Content import: Firecrawl import UI for importing external URLs as markdown drafts
  - Site configuration: Config Generator UI for all `siteConfig.ts` settings, generates downloadable config file
  - Index HTML editor: View and edit `index.html` content with meta tags, Open Graph, Twitter Cards, JSON-LD
  - Analytics: Real-time stats dashboard (clone of `/stats` page, always accessible in dashboard)
  - Sync commands: UI with buttons for all sync operations (sync, sync:discovery, sync:all for dev and prod)
  - Header sync buttons: Quick sync buttons in dashboard header for `npm run sync:all` (dev and prod)
  - Dashboard search: Search bar in header to search dashboard features, page titles, and post content
  - Toast notifications: Success, error, info, and warning notifications with auto-dismiss
  - Command modal: Shows sync command output with copy to clipboard functionality
  - Mobile responsive: Fully responsive design with mobile-optimized layout
  - Theme and font: Theme toggle and font switcher with persistent preferences

### Technical

- New page: `src/pages/Dashboard.tsx` (4736 lines)
- Dashboard uses Convex queries for real-time data
- All mutations follow Convex best practices (idempotent, indexed queries)
- Frontmatter sidebar width persisted in localStorage
- Editor content persisted in localStorage
- Independent scrolling for editor and sidebar sections
- Preview uses ReactMarkdown with remark-gfm, remark-breaks, rehype-raw, rehype-sanitize
- CSS styles added for dashboard layout, tables, editor, frontmatter sidebar, config generator, newsletter sections, stats sections, sync sections, toast notifications, command modal
- Mobile responsive breakpoints for all dashboard sections

## [1.43.0] - 2025-12-29

### Added

- Stats page configuration option for public/private access
  - New `StatsPageConfig` interface in `siteConfig.ts` with `enabled` and `showInNav` options
  - Stats page can be made private by setting `enabled: false` (similar to NewsletterAdmin pattern)
  - When disabled, route shows "Stats page is disabled" message instead of analytics
  - Navigation item automatically hidden when stats page is disabled
  - Default configuration: `enabled: true` (public), `showInNav: true` (visible in nav)

### Technical

- Updated: `src/config/siteConfig.ts` (added StatsPageConfig interface and default config)
- Updated: `src/App.tsx` (conditionally renders /stats route based on config)
- Updated: `src/pages/Stats.tsx` (checks if enabled, shows disabled message if not)
- Updated: `src/components/Layout.tsx` (hides stats nav item when disabled)

## [1.42.0] - 2025-12-29

### Added

- Honeypot bot protection for contact and newsletter forms
  - Hidden honeypot fields invisible to humans but visible to bots
  - Contact form uses hidden "Website" field for bot detection
  - Newsletter signup uses hidden "Fax" field for bot detection
  - Bots that fill hidden fields receive fake success message (no data submitted)
  - No external dependencies required (client-side only protection)
  - Works with all four themes (dark, light, tan, cloud)

### Technical

- Updated: `src/components/ContactForm.tsx` (added honeypot state, hidden field, bot detection logic)
- Updated: `src/components/NewsletterSignup.tsx` (added honeypot state, hidden field, bot detection logic)
- Honeypot fields use CSS positioning (position: absolute, left: -9999px) to hide from users
- Fields include aria-hidden="true" and tabIndex={-1} for accessibility
- Different field names per form (website/fax) to avoid pattern detection

## [1.41.0] - 2025-12-28

### Added

- Blog heading styles for home intro content
  - Headings (h1-h6) in `content/pages/home.md` now use same styling as blog posts
  - Classes: `blog-h1`, `blog-h2`, `blog-h3`, `blog-h4`, `blog-h5`, `blog-h6`
  - Clickable anchor links (#) appear on hover for each heading
  - Automatic ID generation from heading text for anchor navigation
- Additional blog styling for home intro
  - Lists (`ul`, `ol`, `li`) use `blog-ul`, `blog-ol`, `blog-li` classes
  - Blockquotes use `blog-blockquote` class
  - Horizontal rules use `blog-hr` class
  - Links use `blog-link` class

### Changed

- `src/pages/Home.tsx`: Added custom ReactMarkdown components for headings and other elements
- Home intro headings now match blog post typography and spacing

### Technical

- Updated: `src/pages/Home.tsx` (added generateSlug, getTextContent, HeadingAnchor helper functions, custom ReactMarkdown components for h1-h6, ul, ol, li, blockquote, hr, and updated a component to use blog-link class)
- Headings in home intro content now have IDs and anchor links matching blog post behavior

## [1.40.0] - 2025-12-28

### Added

- Synced home intro content via markdown file
  - New `content/pages/home.md` file for homepage intro/bio text
  - Home intro content now syncs with `npm run sync` like other pages
  - No redeploy needed for homepage text changes
  - Full markdown support: links, headings, lists, blockquotes, horizontal rules
  - External links automatically open in new tab
  - Fallback to `siteConfig.bio` if page not found or while loading
- New `textAlign` frontmatter field for pages
  - Control text alignment: "left", "center", "right"
  - Default: "left" (previously was always centered)
  - Used by `home.md` to control home intro alignment
- New `featuredTitle` config option in siteConfig.ts
  - Customize the featured section title (e.g., "Get started:", "Featured", "Popular")
  - Previously hardcoded as "Get started:" in Home.tsx

### Changed

- `src/pages/Home.tsx`: Now fetches home intro from Convex instead of hardcoded JSX
- Combined `home-intro` and `home-bio` into single markdown-powered section
- Home intro content defaults to left alignment (can be set to center/right via frontmatter)

### Technical

- New file: `content/pages/home.md` (slug: `home-intro`, `showInNav: false`, `textAlign: left`)
- Updated: `src/pages/Home.tsx` (added ReactMarkdown, useQuery for home-intro, textAlign support, featuredTitle from siteConfig)
- Updated: `src/styles/global.css` (added `.home-intro-content` styles)
- Updated: `convex/schema.ts` (added `textAlign` field to pages table)
- Updated: `convex/pages.ts` (added `textAlign` to getPageBySlug and syncPagesPublic)
- Updated: `scripts/sync-posts.ts` (added `textAlign` to PageFrontmatter and ParsedPage)
- Updated: `src/config/siteConfig.ts` (added `featuredTitle` to SiteConfig interface and config object)

## [1.39.0] - 2025-12-28

### Added

- HTTP-based MCP (Model Context Protocol) server deployed on Netlify Edge Functions
  - Accessible 24/7 at `https://www.markdown.fast/mcp`
  - Public access with Netlify built-in rate limiting (50 req/min per IP)
  - Optional API key authentication for higher limits (1000 req/min)
  - Read-only access to blog posts, pages, homepage, and search
  - 7 tools: `list_posts`, `get_post`, `list_pages`, `get_page`, `get_homepage`, `search_content`, `export_all`
  - JSON-RPC 2.0 protocol over HTTP POST
  - CORS support for MCP clients
  - No local machine required (unlike stdio-based MCP servers)
- Blog post: "How to Use the MCP Server" with client configuration examples
- MCP Server section in documentation (docs.md)
- MCP configuration in siteConfig.ts (`mcpServer` object)

### Changed

- Updated setup-guide.md with MCP server section
- Added `@modelcontextprotocol/sdk` to package.json dependencies

### Technical

- New file: `netlify/edge-functions/mcp.ts` (MCP server implementation)
- New file: `content/blog/how-to-use-mcp-server.md`
- Updated: `netlify.toml` (added /mcp edge function route)
- Updated: `src/config/siteConfig.ts` (MCPServerConfig interface and config)
- Updated: `files.md` (mcp.ts entry)

## [1.38.0] - 2025-12-27

### Added

- Newsletter CLI improvements
  - `newsletter:send` now calls `scheduleSendPostNewsletter` mutation directly
  - New `newsletter:send:stats` command to send weekly stats summary
  - Both commands provide clear success/error feedback
- New mutation `scheduleSendStatsSummary` for CLI stats sending
- Blog post: "How to use AgentMail with Markdown Sync" with complete setup guide

### Changed

- `scripts/send-newsletter.ts`: Now calls mutation directly instead of printing instructions
- `convex/newsletter.ts`: Added `scheduleSendStatsSummary` mutation

### Technical

- New script: `scripts/send-newsletter-stats.ts`
- All AgentMail features verified to use environment variables (no hardcoded emails)

## [1.37.0] - 2025-12-27

### Added

- Newsletter Admin UI at `/newsletter-admin`
  - Three-column layout similar to Write page
  - View all subscribers with search and filter (all/active/unsubscribed)
  - Stats showing active, total, and sent newsletter counts
  - Delete subscribers directly from admin
  - Send newsletter panel with two modes:
    - Send Post: Select a blog post to send as newsletter
    - Write Email: Compose custom email with markdown support
  - Markdown-to-HTML conversion for custom emails (headers, bold, italic, links, lists)
  - Copy icon on success messages to copy CLI commands
  - Theme-aware success/error styling (no hardcoded green)
  - Recent newsletters list showing sent history
  - Configurable via `siteConfig.newsletterAdmin`
- Weekly Digest automation
  - Cron job runs every Sunday at 9:00 AM UTC
  - Automatically sends all posts published in the last 7 days
  - Uses AgentMail SDK for email delivery
  - Configurable via `siteConfig.weeklyDigest`
- Developer Notifications
  - New subscriber alerts sent via email when someone subscribes
  - Weekly stats summary sent every Monday at 9:00 AM UTC
  - Uses `AGENTMAIL_CONTACT_EMAIL` or `AGENTMAIL_INBOX` as recipient
  - Configurable via `siteConfig.newsletterNotifications`
- Admin queries and mutations for newsletter management
  - `getAllSubscribers`: Paginated subscriber list with search/filter
  - `deleteSubscriber`: Remove subscriber from database
  - `getNewsletterStats`: Stats for admin dashboard
  - `getPostsForNewsletter`: List of posts with sent status

### Changed

- `convex/newsletter.ts`: Added admin queries (getAllSubscribers, deleteSubscriber, getNewsletterStats, getPostsForNewsletter, getStatsForSummary) and scheduleSendCustomNewsletter mutation
- `convex/newsletterActions.ts`: Added sendWeeklyDigest, notifyNewSubscriber, sendWeeklyStatsSummary, sendCustomNewsletter actions with markdown-to-HTML conversion
- `convex/posts.ts`: Added getRecentPostsInternal query for weekly digest
- `convex/crons.ts`: Added weekly digest (Sunday 9am) and stats summary (Monday 9am) cron jobs
- `src/config/siteConfig.ts`: Added NewsletterAdminConfig, NewsletterNotificationsConfig, WeeklyDigestConfig interfaces
- `src/App.tsx`: Added /newsletter-admin route
- `src/styles/global.css`: Added newsletter admin styles with responsive design

### Technical

- New page: `src/pages/NewsletterAdmin.tsx`
- Newsletter admin hidden from navigation by default (security through obscurity)
- All admin features togglable via siteConfig
- Uses Convex internal actions for email sending (Node.js runtime with AgentMail SDK)
- Cron jobs use environment variables: SITE_URL, SITE_NAME

## [1.36.0] - 2025-12-27

### Added

- Social footer component with customizable social links and copyright
  - Displays social icons on the left (GitHub, Twitter/X, LinkedIn, and more)
  - Shows copyright symbol, site name, and auto-updating year on the right
  - Configurable via `siteConfig.socialFooter` in `src/config/siteConfig.ts`
  - Supports 8 platform types: github, twitter, linkedin, instagram, youtube, tiktok, discord, website
  - Uses Phosphor icons for consistent styling
  - Appears below the main footer on homepage, blog posts, and pages
  - Can work independently of the main footer when set via frontmatter
- Frontmatter control for social footer visibility
  - `showSocialFooter` field for posts and pages to override siteConfig defaults
  - Set `showSocialFooter: false` to hide on specific posts/pages
  - Works like existing `showFooter` field pattern
- Social footer configuration options
  - `enabled`: Global toggle for social footer
  - `showOnHomepage`, `showOnPosts`, `showOnPages`, `showOnBlogPage`: Per-location visibility
  - `socialLinks`: Array of social link objects with platform and URL
  - `copyright.siteName`: Site/company name for copyright display
  - `copyright.showYear`: Toggle for auto-updating year

### Changed

- `src/config/siteConfig.ts`: Added `SocialLink`, `SocialFooterConfig` interfaces and `socialFooter` configuration
- `convex/schema.ts`: Added `showSocialFooter` optional boolean field to posts and pages tables
- `convex/posts.ts` and `convex/pages.ts`: Updated queries and mutations to include `showSocialFooter` field
- `scripts/sync-posts.ts`: Updated to parse `showSocialFooter` from frontmatter for both posts and pages
- `src/pages/Home.tsx`: Added SocialFooter component below Footer
- `src/pages/Post.tsx`: Added SocialFooter component below Footer for both posts and pages
- `src/pages/Blog.tsx`: Added SocialFooter component below Footer
- `src/styles/global.css`: Added social footer styles with flexbox layout and mobile responsive design

### Technical

- New component: `src/components/SocialFooter.tsx`
- Uses Phosphor icons: GithubLogo, TwitterLogo, LinkedinLogo, InstagramLogo, YoutubeLogo, TiktokLogo, DiscordLogo, Globe
- Responsive design: stacks vertically on mobile (max-width: 480px)
- Year automatically updates using `new Date().getFullYear()`

## [1.35.0] - 2025-12-26

### Added

- `showImageAtTop` frontmatter field for posts and pages
  - Set `showImageAtTop: true` to display the `image` field at the top of the post/page above the header
  - Image displays full-width with rounded corners above the post header
  - Default behavior: if `showImageAtTop` is not set or `false`, image only used for Open Graph previews and featured card thumbnails
  - Works for both blog posts and static pages
  - Image appears above the post header when enabled

### Changed

- `convex/schema.ts`: Added `showImageAtTop` optional boolean field to posts and pages tables
- `scripts/sync-posts.ts`: Updated to parse `showImageAtTop` from frontmatter for both posts and pages
- `convex/posts.ts` and `convex/pages.ts`: Updated queries and mutations to include `showImageAtTop` field
- `src/pages/Post.tsx`: Added conditional rendering to display image at top when `showImageAtTop: true`
- `src/pages/Write.tsx`: Added `showImageAtTop` to POST_FIELDS and PAGE_FIELDS frontmatter reference
- `src/styles/global.css`: Added `.post-header-image` and `.post-header-image-img` styles for header image display
- Documentation updated: `content/pages/docs.md`, `content/blog/how-to-publish.md`, `content/blog/using-images-in-posts.md`, `files.md`

### Technical

- Header image displays with full-width responsive layout
- Image appears above post header with 32px bottom margin
- Rounded corners (8px border-radius) for modern appearance
- Maintains aspect ratio with `object-fit: cover`

## [1.34.0] - 2025-12-26

### Added

- Blog page featured layout with hero post
  - `blogFeatured` frontmatter field for posts to mark as featured on blog page
  - First `blogFeatured` post displays as hero card with landscape image, tags, date, title, excerpt, author info, and read more link
  - Remaining `blogFeatured` posts display in 2-column featured row with excerpts
  - Regular (non-featured) posts display in 3-column grid without excerpts
  - New `BlogHeroCard` component (`src/components/BlogHeroCard.tsx`) for hero display
  - New `getBlogFeaturedPosts` query returns all published posts with `blogFeatured: true` sorted by date
  - `PostList` component updated with `columns` prop (2 or 3) and `showExcerpts` prop
  - Card images use 16:10 landscape aspect ratio
  - Footer support on blog page via `siteConfig.footer.showOnBlogPage`

### Changed

- `convex/schema.ts`: Added `blogFeatured` field to posts table with `by_blogFeatured` index
- `convex/posts.ts`: Added `getBlogFeaturedPosts` query, updated sync mutations to handle `blogFeatured` field
- `scripts/sync-posts.ts`: Updated to parse `blogFeatured` from post frontmatter
- `src/pages/Blog.tsx`: Refactored to display hero, featured row, and regular posts sections
- `src/components/PostList.tsx`: Added `columns` and `showExcerpts` props for layout control
- `src/styles/global.css`: Added styles for `.blog-hero-section`, `.blog-hero-card`, `.blog-featured-row`, `.post-cards-2col`

### Technical

- Hero card responsive design: stacks content on mobile, side-by-side on desktop
- Featured row uses 2-column grid with excerpts visible
- Regular posts grid uses 3-column layout without excerpts for cleaner appearance
- Responsive breakpoints: 2 columns at 768px, 1 column at 480px
- Layout class names updated: `blog-page-cards` and `blog-page-list` for view modes

## [1.33.1] - 2025-12-26

### Changed

- Article centering in sidebar layouts
  - Article content now centers in the middle column when sidebars are present
  - Left sidebar stays flush left, right sidebar stays flush right
  - Article uses `margin-left: auto; margin-right: auto` within its `1fr` grid column
  - Works with both two-column (left sidebar only) and three-column (both sidebars) layouts
  - Consistent `max-width: 800px` for article content across all sidebar configurations

### Technical

- Updated `.post-article-with-sidebar` in `src/styles/global.css` with auto margins for centering
- Added `padding-right: 48px` to match left padding for balanced spacing

## [1.33.0] - 2025-12-26

### Added

- AI Chat Write Agent integration with Anthropic Claude
  - New `AIChatView` component (`src/components/AIChatView.tsx`) for AI-powered chat interface
  - AI chat can be toggled on Write page via siteConfig.aiChat.enabledOnWritePage
  - AI chat can appear in RightSidebar on posts/pages via frontmatter `aiChat: true` field
  - Per-session, per-context chat history stored in Convex (aiChats table)
  - Supports page content as context for AI responses
  - Markdown rendering for AI responses with copy functionality
  - Theme-aware styling that matches the site's design system
  - Uses Phosphor Icons for all UI elements

- Convex backend for AI chat
  - New `convex/aiChats.ts` with queries and mutations for chat history
  - New `convex/aiChatActions.ts` with Claude API integration (requires ANTHROPIC_API_KEY environment variable)
  - System prompt configurable via Convex environment variables:
    - `CLAUDE_PROMPT_STYLE`, `CLAUDE_PROMPT_COMMUNITY`, `CLAUDE_PROMPT_RULES` (split prompts, joined with separators)
    - `CLAUDE_SYSTEM_PROMPT` (single prompt, fallback if split prompts not set)
  - Chat history limited to last 20 messages for context efficiency
  - Error handling: displays "API key is not set" message when ANTHROPIC_API_KEY is missing in Convex environment variables

- New configuration options
  - `siteConfig.aiChat` interface with `enabledOnWritePage` and `enabledOnContent` boolean flags
  - Both flags default to false (opt-in feature)
  - New `aiChat` frontmatter field for posts and pages (requires rightSidebar: true)

### Changed

- Write page now supports AI Agent mode toggle (replaces textarea when active)
  - Title changes from "Blog Post" or "Page" to "Agent" when in AI chat mode
  - Toggle button text changes between "Agent" and "Text Editor"
  - Page scroll prevention when switching modes (no page jump)
- RightSidebar component updated to conditionally render AIChatView
- Post.tsx passes pageContent and slug to RightSidebar for AI context
- Schema updated with aiChats table and aiChat fields on posts/pages tables
- sync-posts.ts updated to handle aiChat frontmatter field
- AIChatView displays user-friendly error messages when API key is not configured

### Technical

- Added `@anthropic-ai/sdk` dependency for Claude API integration
- Anonymous session authentication using localStorage session ID
- AI chat CSS styles in global.css with theme variable support
- New convex schema: aiChats table with indexes (by_sessionId_contextId, by_contextId)

## [1.32.0] - 2025-12-25

### Added

- Custom homepage configuration
  - Set any page or blog post to serve as the homepage instead of the default Home component
  - Configure via `siteConfig.homepage` with `type` ("default", "page", or "post"), `slug` (required for page/post), and `originalHomeRoute` (default: "/home")
  - Custom homepage retains all Post component features (sidebar, copy dropdown, author info, footer) but without the featured section
  - Original homepage remains accessible at `/home` route (or configured `originalHomeRoute`) when custom homepage is set
  - SEO metadata uses the page/post's frontmatter when used as homepage
  - Back button hidden when Post component is used as homepage
- Fork configuration support for homepage
  - Added `homepage` field to `fork-config.json.example`
  - Updated `configure-fork.ts` to handle homepage configuration
  - Documentation added to `FORK_CONFIG.md` with usage examples

### Changed

- `src/App.tsx`: Conditionally renders Home or Post component based on `siteConfig.homepage` configuration
- `src/pages/Post.tsx`: Added optional `slug`, `isHomepage`, and `homepageType` props to support homepage mode
- `src/config/siteConfig.ts`: Added `HomepageConfig` interface and default homepage configuration

### Technical

- New interface: `HomepageConfig` in `src/config/siteConfig.ts`
- Conditional routing in `App.tsx` checks `homepage.type` and `homepage.slug` to determine homepage component
- Post component accepts optional props for homepage mode (hides back button when `isHomepage` is true)
- Original homepage route dynamically added when custom homepage is active

## [1.31.1] - 2025-12-25

### Added

- Image support in footer component with size control
  - Footer markdown now supports images using standard markdown syntax or HTML
  - Images can be sized using `width`, `height`, `style`, or `class` HTML attributes
  - Image attributes are sanitized by rehypeSanitize for security (removes dangerous CSS)
  - Footer images support lazy loading and optional captions from alt text
  - CSS styles added for footer images (`.site-footer-image-wrapper`, `.site-footer-image`, `.site-footer-image-caption`)

### Changed

- Footer sanitize schema updated to allow `width`, `height`, `style`, and `class` attributes on images
- Footer image component handler updated to pass through size attributes from HTML

## [1.31.0] - 2025-12-25

### Added

- Customizable footer component with markdown support
  - New `Footer` component (`src/components/Footer.tsx`) that renders markdown content
  - Footer content can be set in frontmatter `footer` field (markdown) or use `siteConfig.footer.defaultContent`
  - Footer can be enabled/disabled globally via `siteConfig.footer.enabled`
  - Footer visibility controlled per-page type via `siteConfig.footer.showOnHomepage`, `showOnPosts`, `showOnPages`
  - New `showFooter` frontmatter field for posts and pages to override siteConfig defaults
  - New `footer` frontmatter field for posts and pages to provide custom markdown content
  - Footer renders inside article at bottom for posts/pages, maintains current position on homepage
  - Footer supports markdown formatting (links, paragraphs, line breaks)
  - Sidebars flush to bottom when footer is enabled (using min-height)

### Changed

- Homepage footer section now uses the new `Footer` component instead of hardcoded HTML
- Post and page views now render footer inside article tag (before closing `</article>`)
- Footer component simplified to accept markdown content instead of structured link arrays
- Footer configuration in `siteConfig.ts` now uses `defaultContent` (markdown string) instead of `builtWith`/`createdBy` objects

## [1.30.2] - 2025-12-25

### Fixed

- Right sidebar no longer appears on pages/posts without explicit `rightSidebar: true` in frontmatter
  - Changed default behavior: right sidebar is now opt-in only
  - Pages like About and Contact now render without the right sidebar as expected
  - `CopyPageDropdown` correctly appears in nav bar when right sidebar is disabled
- Logic in `Post.tsx` changed from `(page.rightSidebar ?? true)` to `page.rightSidebar === true`

## [1.30.1] - 2025-12-25

### Fixed

- TypeScript error in `convex/posts.ts` where `rightSidebar` was used in mutation handlers but missing from args validators
  - Added `rightSidebar: v.optional(v.boolean())` to `syncPosts` args validator
  - Added `rightSidebar: v.optional(v.boolean())` to `syncPostsPublic` args validator

## [1.30.0] - 2025-12-25

### Added

- Right sidebar feature for posts and pages
  - New `RightSidebar` component that displays `CopyPageDropdown` in a right sidebar
  - Appears at 1135px+ viewport width when enabled
  - Controlled by `siteConfig.rightSidebar.enabled` (global toggle)
  - Per-post/page control via `rightSidebar: true` frontmatter field (opt-in only)
  - Three-column layout support: left sidebar (TOC), main content, right sidebar (CopyPageDropdown)
  - CopyPageDropdown automatically moves from nav to right sidebar when enabled
  - Responsive: right sidebar hidden below 1135px, CopyPageDropdown returns to nav
- Right sidebar configuration in siteConfig
  - `rightSidebar.enabled`: Global toggle for right sidebar feature
  - `rightSidebar.minWidth`: Minimum viewport width to show sidebar (default: 1135px)
- `rightSidebar` frontmatter field
  - Available for both blog posts and pages
  - Optional boolean field to enable/disable right sidebar per post/page
  - Defaults to true when `siteConfig.rightSidebar.enabled` is true
  - Added to Write page frontmatter reference with copy button

### Changed

- `Post.tsx`: Updated to support three-column layout with conditional right sidebar rendering
- CSS refactoring: Separated left and right sidebar styles
  - `.post-sidebar-wrapper` is now left-specific with `margin-left` and right border
  - `.post-sidebar-right` has complete independent styles with `margin-right` and left border
  - Both sidebars maintain consistent styling (sticky positioning, background, borders, scrollbar hiding)
- `src/styles/global.css`: Added CSS for right sidebar positioning and 3-column grid layout
- `convex/schema.ts`: Added `rightSidebar` field to posts and pages tables
- `convex/posts.ts` and `convex/pages.ts`: Updated queries and mutations to handle `rightSidebar` field
- `scripts/sync-posts.ts`: Updated parsing logic to include `rightSidebar` frontmatter field
- `src/pages/Write.tsx`: Added `rightSidebar` field to POST_FIELDS and PAGE_FIELDS arrays

### Technical

- Right sidebar uses sticky positioning with top offset matching left sidebar
- CSS grid automatically adjusts from 2-column to 3-column layout when right sidebar is present
- Main content padding adjusts when right sidebar is enabled
- Mobile responsive: right sidebar hidden below 1135px breakpoint

## [1.29.0] - 2025-12-25

### Added

- Font family configuration system
  - Added `fontFamily` option to `siteConfig.ts` with three options: "serif" (New York), "sans" (system fonts), "monospace" (IBM Plex Mono)
  - Created `FontContext.tsx` for global font state management with localStorage persistence
  - Font preference persists across page reloads
  - SiteConfig default font is respected and overrides localStorage when siteConfig changes
  - CSS variable `--font-family` dynamically updates based on selected font
- Monospace font option
  - Added monospace font family to FONT SWITCHER options in `global.css`
  - Monospace uses "IBM Plex Mono", "Liberation Mono", ui-monospace, monospace
  - Write page font switcher now supports all three font options (serif/sans/monospace)
- Fork configuration support for fontFamily
  - Added `fontFamily` field to `fork-config.json.example`
  - Updated `configure-fork.ts` to handle fontFamily configuration

### Changed

- `src/styles/global.css`: Updated body font-family to use CSS variable `--font-family` with fallback
- `src/main.tsx`: Added FontProvider wrapper around app
- `src/pages/Write.tsx`: Updated font switcher to cycle through serif/sans/monospace options
- `content/blog/setup-guide.md`: Updated font configuration documentation with siteConfig option
- `content/pages/docs.md`: Updated font configuration documentation

### Technical

- New context: `src/context/FontContext.tsx` with `useFont()` hook
- Font detection logic compares siteConfig default with localStorage to detect changes
- CSS variable updates synchronously on mount for immediate font application
- Write page font state syncs with global font on initial load

## [1.28.2] - 2025-12-25

### Fixed

- Plain text code blocks now wrap text properly
  - Code blocks without a language specifier were causing horizontal overflow
  - Updated detection logic to distinguish inline code from block code
  - Inline code: short content (< 80 chars), no newlines, no language
  - Block code: longer content or has language specifier
  - Text block wrapping uses `pre-wrap` styling via SyntaxHighlighter `customStyle` and `codeTagProps`
  - Long error messages and prose in code blocks now display correctly

### Technical

- Updated `src/components/BlogPost.tsx`: New detection logic for inline vs block code, added `textBlockStyle` with wrapping properties
- Updated `src/styles/global.css`: Added `.code-block-text` class for CSS fallback wrapping

## [1.28.1] - 2025-12-25

### Fixed

- RSS feed validation errors resolved
  - Standardized all URLs to `www.markdown.fast` across the application
  - Fixed `atom:link rel="self"` attribute mismatch that caused RSS validation failures
  - Updated `index.html` meta tags (og:url, og:image, twitter:domain, twitter:url, twitter:image, JSON-LD)
  - Updated `convex/rss.ts` and `convex/http.ts` SITE_URL constants to use www.markdown.fast
  - Updated `public/robots.txt`, `public/openapi.yaml`, and `public/llms.txt` with www URLs
  - RSS exclusions already present in `netlify.toml` for botMeta edge function

### Technical

- All URL references now consistently use `https://www.markdown.fast`
- RSS feed `rel="self"` attribute now matches actual feed URL
- Build passes successfully with URL standardization

## [1.28.0] - 2025-12-25

### Added

- Discovery files sync script
  - New `sync-discovery-files.ts` script that updates AGENTS.md and llms.txt with current app data
  - Reads from siteConfig.ts and queries Convex for post/page counts and latest post date
  - Preserves existing AGENTS.md instructional content while updating dynamic sections
  - Regenerates llms.txt with current site information and GitHub URLs
- New npm sync commands
  - `npm run sync:discovery` - Update discovery files (development)
  - `npm run sync:discovery:prod` - Update discovery files (production)
  - `npm run sync:all` - Sync content + discovery files together (development)
  - `npm run sync:all:prod` - Sync content + discovery files together (production)
- Fork configuration support for gitHubRepo
  - Added `gitHubRepoConfig` to fork-config.json.example
  - Updated configure-fork.ts to handle gitHubRepo with backward compatibility
  - Legacy githubUsername/githubRepo fields still work

### Changed

- `fork-config.json.example`: Added gitHubRepoConfig object with owner, repo, branch, contentPath
- `scripts/configure-fork.ts`: Added gitHubRepo update logic with legacy field fallback
- `FORK_CONFIG.md`: Added gitHubRepo documentation and sync:discovery command reference
- `files.md`: Added sync-discovery-files.ts entry and sync commands documentation
- Documentation updated across all files with new sync commands

### Technical

- New script: `scripts/sync-discovery-files.ts`
- Uses ConvexHttpClient to query live data from Convex
- Regex-based siteConfig.ts parsing for gitHubRepo extraction
- Selective AGENTS.md updates preserve instructional content
- Error handling with graceful fallbacks for missing data

## [1.27.0] - 2025-12-24

### Added

- Homepage post limit configuration
  - Configurable limit for number of posts shown on homepage via `siteConfig.postsDisplay.homePostsLimit`
  - Default limit set to 10 most recent posts
  - Set to `undefined` to show all posts (no limit)
- Optional "read more" link below limited post list
  - Configurable via `siteConfig.postsDisplay.homePostsReadMore`
  - Customizable link text and destination URL
  - Only appears when posts are limited and there are more posts than the limit
  - Default links to `/blog` page
  - Can be disabled by setting `enabled: false`

### Changed

- `src/config/siteConfig.ts`: Added `homePostsLimit` and `homePostsReadMore` to `PostsDisplayConfig` interface
- `src/pages/Home.tsx`: Post list now respects `homePostsLimit` configuration and shows "read more" link when applicable
- `src/styles/global.css`: Added styles for `.home-posts-read-more` and `.home-posts-read-more-link` with centered button styling and hover effects

### Technical

- New interface: `HomePostsReadMoreConfig` in `src/config/siteConfig.ts`
- Post limiting logic uses `.slice()` to limit array before passing to `PostList` component
- Conditional rendering ensures "read more" link only shows when needed

## [1.26.0] - 2025-12-24

### Added

- Tag pages at `/tags/[tag]` route
  - Dynamic tag archive pages showing all posts with a specific tag
  - View mode toggle (list/cards) with localStorage persistence
  - Mobile responsive layout matching existing blog page design
  - Sitemap updated to include all tag pages dynamically
- Related posts component for blog post footers
  - Shows up to 3 related posts based on shared tags
  - Sorted by relevance (number of shared tags) then by date
  - Only displays on blog posts (not static pages)
- Improved tag links in post footers
  - Tags now link to `/tags/[tag]` archive pages
  - Visual styling consistent with existing theme
- Open in AI service links re-enabled in CopyPageDropdown
  - Uses GitHub raw URLs instead of Netlify paths (bypasses edge function issues)
  - ChatGPT, Claude, and Perplexity links with universal prompt
  - "Requires git push" hint for users (npm sync alone doesn't update GitHub)
  - Visual divider separating AI options from other menu items

### Changed

- `src/config/siteConfig.ts`: Added `gitHubRepo` configuration for constructing raw GitHub URLs
- `convex/schema.ts`: Added `by_tags` index to posts table for efficient tag queries
- `convex/posts.ts`: Added `getAllTags`, `getPostsByTag`, and `getRelatedPosts` queries
- `convex/http.ts`: Sitemap now includes dynamically generated tag pages
- Updated `content/pages/docs.md` and `content/blog/setup-guide.md` with git push requirement for AI links

### Technical

- New component: `src/pages/TagPage.tsx`
- New route: `/tags/:tag` in `src/App.tsx`
- CSS styles for tag pages, related posts, and post tag links in `src/styles/global.css`
- Mobile responsive breakpoints for all new components

## [1.25.4] - 2025-12-24

### Fixed

- Sidebar border width now consistent across all pages
  - Fixed border appearing thicker on changelog page when sidebar scrolls
  - Changed from `border-right` to `box-shadow: inset` for consistent 1px width regardless of scrollbar presence
  - Border now renders correctly on both docs and changelog pages

### Changed

- Sidebar scrollbar hidden while maintaining scroll functionality
  - Scrollbar no longer visible but scrolling still works
  - Applied cross-browser scrollbar hiding (Chrome/Safari/Edge, Firefox, IE)
  - Cleaner sidebar appearance matching Cursor docs style

- Sidebar styling improvements
  - Added top border using CSS variable (`var(--border-sidebar)`) for theme consistency
  - Added border-radius for rounded corners
  - Updated CSS comments to document border implementation approach

### Technical

- `src/styles/global.css`: Changed `.post-sidebar-wrapper` border from `border-right` to `box-shadow: inset -1px 0 0`
- `src/styles/global.css`: Added scrollbar hiding with `-ms-overflow-style: none`, `scrollbar-width: none`, and `::-webkit-scrollbar`
- `src/styles/global.css`: Added `border-top: 1px solid var(--border-sidebar)` and `border-radius: 8px` to sidebar wrapper
- `src/styles/global.css`: Updated CSS comments to explain border implementation choices

## [1.25.3] - 2025-12-24

### Fixed

- Mobile menu now appears correctly at all breakpoints where sidebar is hidden
  - Changed mobile hamburger menu breakpoint from `max-width: 768px` to `max-width: 1024px`
  - Changed desktop hide breakpoint from `min-width: 769px` to `min-width: 1025px`
  - Mobile menu now shows whenever sidebar is hidden (matches sidebar breakpoint)
  - Fixed gap where users had no navigation between 769px and 1024px viewport widths

### Technical

- `src/styles/global.css`: Updated mobile nav controls media query to `max-width: 1024px`
- `src/styles/global.css`: Updated desktop hide media query to `min-width: 1025px`
- `src/styles/global.css`: Updated tablet drawer width breakpoint to `max-width: 1024px`

## [1.25.2] - 2025-12-24

### Changed

- Disabled AI service links (ChatGPT, Claude, Perplexity) in CopyPageDropdown
  - Direct links to AI services removed due to Netlify edge function interception issues
  - AI crawlers cannot reliably fetch `/raw/*.md` files despite multiple configuration attempts
  - Users can still copy markdown and paste directly into AI tools manually
  - "Copy page", "View as Markdown", and "Download as SKILL.md" options remain available

### Removed

- Netlify Function at `/api/raw/:slug` endpoint
  - Removed due to build failures and dependency conflicts
  - Static `/raw/*.md` files still work in browsers but not for AI crawler fetch tools

### Technical

- `src/components/CopyPageDropdown.tsx`: Commented out AI service buttons, kept manual copy/view/download options
- `netlify.toml`: Removed `/api/raw/*` redirect rule
- `netlify/functions/raw.js`: Deleted Netlify Function file
- `content/blog/netlify-edge-excludedpath-ai-crawlers.md`: Updated with detailed log of all attempted solutions and timestamps

## [1.25.1] - 2025-12-24

### Changed

- Logo moved to top navigation header on all pages
  - Logo now appears in the header bar (top-left) on blog posts, pages, and blog page
  - Logo is separate from back button and navigation links
  - Reads from `siteConfig.innerPageLogo` and `siteConfig.logo` configuration
  - Works consistently across all pages (with and without sidebar)
  - Mobile responsive: logo positioned on left in header

### Technical

- `src/components/Layout.tsx`: Added logo to top navigation header, reads from siteConfig
- `src/pages/Post.tsx`: Removed logo from post navigation (was next to back button)
- `src/pages/Blog.tsx`: Removed logo from blog navigation
- `src/styles/global.css`: Added `.top-nav-logo-link` and `.top-nav-logo` styles, updated `.top-nav` layout to span left-to-right, removed old `.inner-page-logo` styles

## [1.25.0] - 2025-12-24

### Changed

- Sidebar styling updated to match Cursor docs style
  - Sidebar now has alternate background color (`--sidebar-alt-bg`) for visual separation
  - Vertical border line on right side of sidebar
  - Theme-aware colors for all four themes (dark, light, tan, cloud)
  - Sidebar width increased to 240px for better readability
  - Mobile responsive: sidebar hidden on screens below 1024px

### Technical

- `src/styles/global.css`: Added `--sidebar-alt-bg` CSS variables for each theme, updated `.post-sidebar-wrapper` with alternate background and right border, adjusted grid layout for wider sidebar

## [1.24.9] - 2025-12-24

### Added

- Safety-net raw markdown endpoint for AI tools (`/api/raw/:slug`)
  - New Netlify Function at `netlify/functions/raw.ts`
  - Returns `text/plain` with minimal headers for reliable AI ingestion
  - Reads from `dist/raw/` (production) or `public/raw/` (dev/preview)
  - Handles 400 (missing slug), 404 (not found), and 200 (success) responses
  - No Link, X-Robots-Tag, or SEO headers that cause AI fetch failures

### Changed

- AI service links (ChatGPT, Claude, Perplexity) now use `/api/raw/:slug` instead of `/raw/:slug.md`
  - Netlify Function endpoint more reliable for AI crawler fetch
  - "View as Markdown" menu item still uses `/raw/:slug.md` for browser viewing

### Technical

- `netlify/functions/raw.ts`: New Netlify Function to serve raw markdown
- `netlify.toml`: Added redirect from `/api/raw/*` to the function
- `src/components/CopyPageDropdown.tsx`: AI services use `/api/raw/:slug` endpoint
- `package.json`: Added `@netlify/functions` dev dependency

## [1.24.8] - 2025-12-23

### Fixed

- Raw markdown URL construction now uses `window.location.origin` instead of `props.url`
  - Prevents incorrect URLs when `props.url` points to canonical/deploy preview domains
  - Uses `new URL()` constructor for proper absolute URL building
  - Ensures raw URLs always match the current page origin
  - Applied to both AI service links and "View as Markdown" option

### Technical

- `src/components/CopyPageDropdown.tsx`: Changed raw URL construction from `new URL(props.url).origin` to `window.location.origin` with `new URL()` constructor

## [1.24.7] - 2025-12-23

### Fixed

- Removed `Link` header from `/raw/*` endpoints to fix AI crawler fetch failures
  - Netlify merges headers, so global `Link` header was being applied to `/raw/*` despite specific block
  - Moved `Link` header from global `/*` scope to `/index.html` only
  - Removed `X-Robots-Tag = "noindex"` from `/raw/*` to allow AI crawlers to index raw content
  - Raw markdown files now have clean headers optimized for AI consumption

### Technical

- `netlify.toml`: Removed `Link` from global headers, added specific `/index.html` block, removed `noindex` from `/raw/*`

## [1.24.6] - 2025-12-23

### Added

- Homepage raw markdown index file (`/raw/index.md`)
  - Automatically generated during `npm run sync` and `npm run sync:prod`
  - Lists all published posts sorted by date (newest first)
  - Lists all published pages sorted by order or alphabetically
  - Includes post metadata: date, reading time, tags, description
  - Provides direct links to all raw markdown files
  - AI crawlers can now access homepage content as markdown

### Technical

- Updated `scripts/sync-posts.ts`: Added `generateHomepageIndex()` function to create `index.md` in `public/raw/`

## [1.24.5] - 2025-12-23

### Fixed

- AI crawlers (ChatGPT, Perplexity) can now fetch raw markdown from `/raw/*.md` URLs
  - Added explicit `/raw/*` redirect passthrough in `netlify.toml` before SPA fallback
  - Expanded `excludedPath` array to cover all static file patterns
  - Refactored `botMeta.ts` edge function:
    - Added hard bypass at top of handler for static file paths
    - Separated social preview bots from AI crawlers
    - AI crawlers (GPTBot, ClaudeBot, PerplexityBot, etc.) now bypass OG interception
    - Only social preview bots (Facebook, Twitter, LinkedIn, etc.) receive OG metadata HTML

### Technical

- `netlify.toml`: Added `force = true` to `/raw/*` redirect, expanded `excludedPath` array
- `botMeta.ts`: Complete refactor with `SOCIAL_PREVIEW_BOTS` and `AI_CRAWLERS` lists, hard path bypass

## [1.24.4] - 2025-12-23

### Added

- `showInNav` field for pages to control navigation visibility
  - Pages can be published and accessible but hidden from navigation menu
  - Set `showInNav: false` in page frontmatter to hide from nav
  - Defaults to `true` for backwards compatibility (all existing pages show in nav)
  - Pages with `showInNav: false` remain:
    - Published and accessible via direct URL
    - Searchable via search indexes
    - Available via API endpoints
    - Just hidden from the navigation menu
  - Matches the pattern used for `blogPage.showInNav` in siteConfig.ts
- Hardcoded navigation items configuration for React routes
  - Add React route pages (like `/stats`, `/write`) to navigation via `siteConfig.hardcodedNavItems`
  - Configure navigation order, title, and visibility per route
  - Set `showInNav: false` to hide from nav while keeping route accessible
  - Navigation combines Blog link, hardcoded nav items, and markdown pages
  - All nav items sorted by `order` field (lower = first)
  - Example: Configure `/stats` and `/write` routes in `siteConfig.ts`

### Technical

- Updated `convex/schema.ts`: Added optional `showInNav` field to pages table
- Updated `convex/pages.ts`: `getAllPages` query filters out pages where `showInNav === false`
- Updated `scripts/sync-posts.ts`: Parses `showInNav` from page frontmatter
- Updated `src/pages/Write.tsx`: Added `showInNav` field to page template and PAGE_FIELDS reference
- Updated `src/config/siteConfig.ts`: Added `HardcodedNavItem` interface and `hardcodedNavItems` config array
- Updated `src/components/Layout.tsx`: Reads `hardcodedNavItems` from siteConfig and combines with Blog link and pages

### Documentation

- Updated `content/pages/docs.md`: Added `showInNav` to static pages frontmatter table
- Updated `content/blog/setup-guide.md`: Added `showInNav` to static pages frontmatter table

## [1.24.3] - 2025-12-23

### Added

- Inner page logo configuration
  - Logo displays in header on blog page, individual posts, and static pages
  - Desktop: logo positioned on the left (before back button)
  - Mobile: logo positioned on the right (smaller size for compact header)
  - Configurable via `siteConfig.innerPageLogo.enabled` and `siteConfig.innerPageLogo.size`
  - Does not affect homepage logo (controlled separately)
  - Logo links to homepage when clicked

### Technical

- Updated `src/config/siteConfig.ts`: Added `InnerPageLogoConfig` interface and `innerPageLogo` config option
- Updated `src/pages/Blog.tsx`: Added logo to header navigation
- Updated `src/pages/Post.tsx`: Added logo to header navigation for both posts and pages
- Updated `src/styles/global.css`: Added CSS for desktop (left) and mobile (right) logo positioning with responsive sizing

## [1.24.2] - 2025-12-23

### Changed

- Mobile menu redesigned for better sidebar integration
  - Mobile navigation controls moved to left side (hamburger, search, theme toggle)
  - Hamburger menu order: hamburger first, then search, then theme toggle
  - Sidebar table of contents now appears in mobile menu when page has sidebar layout
  - Desktop sidebar hidden on mobile (max-width: 768px) since it's accessible via hamburger menu
  - Back button and CopyPageDropdown remain visible above main content on mobile
- Mobile menu typography standardized
  - All mobile menu elements now use CSS variables for font sizes
  - Font-family standardized using `inherit` to match body font from global.css
  - Mobile menu TOC links use consistent font sizing with desktop sidebar
  - Added CSS variables: `--font-size-mobile-toc-title` and `--font-size-mobile-toc-link`

### Technical

- Updated `src/components/Layout.tsx`: Reordered mobile nav controls, added sidebar context integration
- Updated `src/components/MobileMenu.tsx`: Added sidebar headings rendering in mobile menu
- Updated `src/pages/Post.tsx`: Provides sidebar headings to context for mobile menu
- Updated `src/context/SidebarContext.tsx`: New context for sharing sidebar data between components
- Updated `src/styles/global.css`: Mobile menu positioning, sidebar hiding on mobile, font standardization

## [1.24.1] - 2025-12-23

### Fixed

- Sidebar navigation anchor links now work correctly when sections are collapsed or expanded
  - Fixed navigation scroll calculation to use proper header offset (80px)
  - Expand ancestors before scrolling to ensure target is visible
  - Use requestAnimationFrame to ensure DOM updates complete before scrolling
  - Removed auto-expand from scroll handler to prevent interfering with manual collapse/expand
  - Collapse button now properly isolated from link clicks with event handlers

### Changed

- Updated `extractHeadings.ts` to filter out headings inside code blocks
  - Prevents sidebar from showing example headings from markdown code examples
  - Removes fenced code blocks (```) and indented code blocks before extracting headings
  - Ensures sidebar only shows actual page headings, not code examples

### Technical

- Updated `src/components/PageSidebar.tsx`: Improved navigation logic and collapse button event handling
- Updated `src/utils/extractHeadings.ts`: Added `removeCodeBlocks` function to filter code before heading extraction

## [1.24.0] - 2025-12-23

### Added

- Sidebar layout support for blog posts
  - Blog posts can now use `layout: "sidebar"` frontmatter field (previously only available for pages)
  - Enables docs-style layout with table of contents sidebar for long-form posts
  - Same features as page sidebar: automatic TOC extraction, active heading highlighting, smooth scroll navigation
  - Mobile responsive: stacks to single column below 1024px

### Changed

- Updated `Post.tsx` to handle sidebar layout for both posts and pages
- Updated `Write.tsx` to include `layout` field in blog post frontmatter reference

### Technical

- Updated `convex/schema.ts`: Added optional `layout` field to posts table
- Updated `scripts/sync-posts.ts`: Parses `layout` field from post frontmatter
- Updated `convex/posts.ts`: Includes `layout` field in queries, mutations, and sync operations
- Reuses existing sidebar components and CSS (no new components needed)

### Documentation

- Updated `docs.md`: Added `layout` field to blog posts frontmatter table, updated sidebar layout section
- Updated `setup-guide.md`: Clarified sidebar layout works for both posts and pages
- Updated `how-to-publish.md`: Added `layout` field to frontmatter reference table

## [1.23.0] - 2025-12-23

### Added

- Collapsible sections in markdown using HTML `<details>` and `<summary>` tags
  - Create expandable/collapsible content in blog posts and pages
  - Use `<details open>` attribute for sections that start expanded
  - Supports nested collapsible sections
  - Theme-aware styling for all four themes (dark, light, tan, cloud)
  - Works with all markdown content inside: lists, code blocks, bold, italic, etc.

### Technical

- Added `rehype-raw` package to allow raw HTML pass-through in react-markdown
- Added `rehype-sanitize` package to strip dangerous tags while allowing safe ones
- Custom sanitize schema allows `details`, `summary` tags and the `open` attribute
- Updated `src/components/BlogPost.tsx` with rehype plugins
- CSS styles for collapsible sections in `src/styles/global.css`

### Documentation

- Updated `markdown-with-code-examples.md` with collapsible section examples
- Updated `docs.md` with collapsible sections documentation
- Updated `files.md` with BlogPost.tsx description change

## [1.22.0] - 2025-12-21

### Added

- Sidebar layout for pages with table of contents
  - Add `layout: "sidebar"` to page frontmatter to enable docs-style layout
  - Left sidebar displays table of contents extracted from H1, H2, H3 headings
  - Two-column grid layout: 220px sidebar + flexible content area
  - Sidebar only appears if headings exist in the page content
  - Active heading highlighting on scroll
  - Smooth scroll navigation to sections
  - CopyPageDropdown remains in top navigation for sidebar pages
  - Mobile responsive: stacks to single column below 1024px

### Technical

- New utility: `src/utils/extractHeadings.ts` for parsing markdown headings
- New component: `src/components/PageSidebar.tsx` for TOC navigation
- Updated `convex/schema.ts`: Added optional `layout` field to pages table
- Updated `scripts/sync-posts.ts`: Parses `layout` field from page frontmatter
- Updated `convex/pages.ts`: Includes `layout` field in queries and mutations
- Updated `src/pages/Post.tsx`: Conditionally renders sidebar layout
- CSS grid layout with sticky sidebar positioning
- Full-width container breaks out of main-content constraints

## [1.21.0] - 2025-12-21

### Added

- Blog page view mode toggle (list and card views)
  - Toggle button in blog header to switch between list and card views
  - Card view displays posts in a 3-column grid with thumbnails, titles, excerpts, and metadata
  - List view shows year-grouped posts (existing behavior)
  - View preference saved to localStorage
  - Default view mode configurable via `siteConfig.blogPage.viewMode`
  - Toggle visibility controlled by `siteConfig.blogPage.showViewToggle`
- Post cards component
  - Displays post thumbnails, titles, excerpts, read time, and dates
  - Responsive grid: 3 columns (desktop), 2 columns (tablet), 1 column (mobile)
  - Theme-aware styling for all four themes (dark, light, tan, cloud)
  - Square thumbnails with hover zoom effect
  - Cards without images display with adjusted padding

### Changed

- Updated `PostList` component to support both list and card view modes
- Updated `Blog.tsx` to include view toggle button and state management
- Updated `siteConfig.ts` with `blogPage.viewMode` and `blogPage.showViewToggle` options

### Technical

- New CSS classes: `.post-cards`, `.post-card`, `.post-card-image-wrapper`, `.post-card-content`, `.post-card-meta`
- Reuses featured card styling patterns for consistency
- Mobile responsive with adjusted grid columns and image aspect ratios

## [1.20.3] - 2025-12-21

### Fixed

- Raw markdown files now accessible to AI crawlers (ChatGPT, Perplexity)
  - Added `/raw/` path bypass in botMeta edge function
  - AI services were receiving HTML instead of markdown content

### Added

- SEO and AEO improvements
  - Sitemap now includes static pages (about, docs, contact, etc.)
  - Security headers: X-Frame-Options, X-Content-Type-Options, X-XSS-Protection, Referrer-Policy
  - Link header pointing to llms.txt for AI discovery
  - Raw markdown files served with proper Content-Type and CORS headers
  - Preconnect hints for Convex backend (faster API calls)

### Changed

- Fixed URL consistency: openapi.yaml and robots.txt now use www.markdown.fast

## [1.20.2] - 2025-12-21

### Fixed

- Write conflict prevention for heartbeat mutation
  - Increased backend dedup window from 10s to 20s
  - Increased frontend debounce from 10s to 20s to match backend
  - Added random jitter (±5s) to heartbeat intervals to prevent synchronized calls across tabs
  - Simplified early return to skip ANY update within dedup window (not just same path)
  - Prevents "Documents read from or written to the activeSessions table changed" errors

## [1.20.1] - 2025-12-21

### Changed

- Visitor map styling improvements
  - Removed box-shadow from map wrapper for cleaner flat design
  - Increased land dot contrast for better globe visibility on all themes
  - Increased land dot opacity from 0.6 to 0.85
  - Darker/more visible land colors for light, tan, and cloud themes
  - Lighter land color for dark theme to stand out on dark background

## [1.20.0] - 2025-12-21

### Added

- Real-time visitor map on stats page
  - Displays live visitor locations on a dotted world map
  - Uses Netlify's built-in geo detection via edge function (no third-party API needed)
  - Privacy friendly: stores city, country, and coordinates only (no IP addresses)
  - Theme-aware colors for all four themes (dark, light, tan, cloud)
  - Animated pulsing dots for active visitors
  - Visitor count badge showing online visitors
  - Configurable via `siteConfig.visitorMap`
- New Netlify edge function: `netlify/edge-functions/geo.ts`
  - Returns user geo data from Netlify's automatic geo headers
  - Endpoint: `/api/geo`
- New React component: `src/components/VisitorMap.tsx`
  - SVG-based world map with simplified continent outlines
  - Lightweight (no external map library needed)
  - Responsive design scales on mobile

### Changed

- Updated `convex/schema.ts`: Added optional location fields to `activeSessions` table (city, country, latitude, longitude)
- Updated `convex/stats.ts`: Heartbeat mutation accepts geo args, getStats returns visitor locations
- Updated `src/hooks/usePageTracking.ts`: Fetches geo data once on mount, passes to heartbeat
- Updated `src/pages/Stats.tsx`: Displays VisitorMap above "Currently Viewing" section
- Updated `src/config/siteConfig.ts`: Added `VisitorMapConfig` interface and `visitorMap` config option

### Documentation

- Updated setup-guide.md with Visitor Map section
- Updated docs.md with Visitor Map configuration
- Updated FORK_CONFIG.md with visitorMap config
- Updated fork-config.json.example with visitorMap option
- Updated fork-configuration-guide.md with visitorMap example

## [1.19.1] - 2025-12-21

### Added

- GitHub Stars card on Stats page
  - Displays live star count from `waynesutton/markdown-site` repository
  - Fetches from GitHub public API (no token required)
  - Uses Phosphor GithubLogo icon
  - Updates on page load

### Changed

- Stats page now displays 6 cards in a single row (previously 5)
- Updated CSS grid for 6-column layout on desktop
- Responsive breakpoints adjusted for 6 cards (3x2 tablet, 2x3 mobile, 1x6 small mobile)

### Technical

- Added `useState` and `useEffect` to `src/pages/Stats.tsx` for GitHub API fetch
- Added `GithubLogo` import from `@phosphor-icons/react`
- Updated `.stats-cards-modern` grid to `repeat(6, 1fr)`
- Updated responsive nth-child selectors for proper borders

## [1.19.0] - 2025-12-21

### Added

- Author display for posts and pages
  - New optional `authorName` and `authorImage` frontmatter fields
  - Round avatar image displayed next to date and read time
  - Works on individual post and page views (not on blog list)
  - Example: `authorName: "Your Name"` and `authorImage: "/images/authors/photo.png"`
- Author images directory at `public/images/authors/`
  - Place author avatar images here
  - Recommended: square images (they display as circles)
- Write page updated with new frontmatter field reference
  - Shows `authorName` and `authorImage` options for both posts and pages

### Technical

- Updated `convex/schema.ts` with authorName and authorImage fields
- Updated `scripts/sync-posts.ts` interfaces and parsing
- Updated `convex/posts.ts` and `convex/pages.ts` queries and mutations
- Updated `src/pages/Post.tsx` to render author info
- Updated `src/pages/Write.tsx` with new field definitions
- CSS styles for `.post-author`, `.post-author-image`, `.post-author-name`

### Documentation

- Updated frontmatter tables in setup-guide.md, docs.md, files.md, README.md
- Added example usage in about-this-blog.md

## [1.18.1] - 2025-12-21

### Changed

- CopyPageDropdown AI services now use raw markdown URLs for better AI parsing
  - ChatGPT, Claude, and Perplexity receive `/raw/{slug}.md` URLs instead of page URLs
  - AI services can fetch and parse clean markdown content directly
  - Includes metadata headers (type, date, reading time, tags) for structured parsing
  - No HTML parsing required by AI services

### Technical

- Renamed `buildUrlFromPageUrl` to `buildUrlFromRawMarkdown` in AIService interface
- Handler builds raw markdown URL from page origin and slug
- Updated prompt text to reference "raw markdown file URL"

## [1.18.0] - 2025-12-20

### Added

- Automated fork configuration with `npm run configure`
  - Copy `fork-config.json.example` to `fork-config.json`
  - Edit JSON with your site information
  - Run `npm run configure` to apply all changes automatically
  - Updates all 11 configuration files in one command
- Two options for fork setup
  - **Option 1: Automated** (recommended): JSON config + single command
  - **Option 2: Manual**: Follow step-by-step guide in `FORK_CONFIG.md`
- `FORK_CONFIG.md` comprehensive fork guide
  - YAML template for AI agent configuration
  - Manual code snippets for each file
  - AI agent prompt for automated updates
- `fork-config.json.example` template with all configuration options
  - Site name, URL, description
  - Creator social links (Twitter, LinkedIn, GitHub)
  - Bio and intro text
  - Logo gallery settings
  - GitHub contributions config
  - Blog page and theme options

### Technical

- New script: `scripts/configure-fork.ts`
- New npm command: `npm run configure`
- Reads JSON config and updates 11 files with string replacements
- Updates: siteConfig.ts, Home.tsx, Post.tsx, http.ts, rss.ts, index.html, llms.txt, robots.txt, openapi.yaml, ai-plugin.json, ThemeContext.tsx

## [1.17.0] - 2025-12-20

### Added

- GitHub contributions graph on homepage
  - Displays yearly contribution activity with theme-aware colors
  - Fetches data from public API (no GitHub token required)
  - Year navigation with Phosphor icons (CaretLeft, CaretRight)
  - Click graph to visit GitHub profile
  - Configurable via `siteConfig.gitHubContributions`
- Theme-specific contribution colors
  - Dark theme: GitHub green on dark background
  - Light theme: Standard GitHub green
  - Tan theme: Warm brown tones matching site palette
  - Cloud theme: Gray-blue tones
- Mobile responsive design
  - Scales down on tablets and phones
  - Day labels hidden on small screens for space
  - Touch-friendly navigation buttons

### Technical

- New component: `src/components/GitHubContributions.tsx`
- Uses `github-contributions-api.jogruber.de` public API
- CSS variables for contribution level colors per theme
- Configuration interface: `GitHubContributionsConfig`
- Set `enabled: false` in siteConfig to disable

## [1.16.0] - 2025-12-21

### Added

- Public markdown writing page at `/write` (not linked in navigation)
  - Three-column Cursor docs-style layout
  - Left sidebar: Home link, content type selector (Blog Post/Page), actions (Clear, Theme, Font)
  - Center: Full-height writing area with title, Copy All button, and borderless textarea
  - Right sidebar: Frontmatter reference with copy icon for each field
- Font switcher in Actions section
  - Toggle between Serif and Sans-serif fonts
  - Font preference saved to localStorage
- Theme toggle matching the rest of the app (Moon, Sun, Half2Icon, Cloud)
- localStorage persistence for content, type, and font preference
- Word, line, and character counts in status bar
- Warning banner: "Refresh loses content"
- Grammarly and browser spellcheck compatible
- Works with all four themes (dark, light, tan, cloud)

### Technical

- New component: `src/pages/Write.tsx`
- Route: `/write` (added to `src/App.tsx`)
- Three localStorage keys: `markdown_write_content`, `markdown_write_type`, `markdown_write_font`
- CSS Grid layout (220px | 1fr | 280px)
- Uses Phosphor icons: House, Article, File, Trash, CopySimple, Warning, Check
- Uses lucide-react and radix-ui icons for theme toggle (consistent with ThemeToggle.tsx)

## [1.15.1] - 2025-12-21

### Fixed

- Theme toggle icons on `/write` page now match `ThemeToggle.tsx` component
  - dark: Moon icon (lucide-react)
  - light: Sun icon (lucide-react)
  - tan: Half2Icon (radix-ui) - consistent with rest of app
  - cloud: Cloud icon (lucide-react)
- Content type switching (Blog Post/Page) now always updates writing area template

### Technical

- Replaced Phosphor icons (Moon, Sun, Leaf, CloudSun) with lucide-react and radix-ui icons
- `handleTypeChange` now always regenerates template when switching types

## [1.15.0] - 2025-12-21

### Changed

- Redesigned `/write` page with three-column Cursor docs-style layout
  - Left sidebar: Home link, content type selector (Blog Post/Page), actions (Clear, Theme)
  - Center: Full-height writing area with title, Copy All button, and borderless textarea
  - Right sidebar: Frontmatter reference with copy icon for each field
- Frontmatter fields panel with per-field copy buttons
  - Each frontmatter field shows name, example value, and copy icon
  - Click to copy individual field syntax to clipboard
  - Required fields marked with red asterisk
  - Fields update dynamically when switching between Blog Post and Page
- Warning banner for unsaved content
  - "Refresh loses content" warning in left sidebar with warning icon
  - Helps users remember localStorage persistence limitations
- Enhanced status bar
  - Word, line, and character counts in sticky footer
  - Save hint with content directory path

### Technical

- Three-column CSS Grid layout (220px sidebar | 1fr main | 280px right sidebar)
- Theme toggle cycles through dark, light, tan, cloud with matching icons
- Collapsible sidebars on mobile (stacked layout)
- Uses Phosphor icons: House, Article, File, Trash, CopySimple, Warning, Check

## [1.14.0] - 2025-12-20

### Changed

- Redesigned `/write` page with Notion-like minimal UI
  - Full-screen distraction-free writing experience
  - Removed site header for focused writing environment
  - Wider writing area (900px max-width centered)
  - Borderless textarea with transparent background
  - Own minimal header with home link, type selector, and icon buttons
- Improved toolbar design
  - Home icon link to return to main site
  - Clean dropdown for content type selection (no borders)
  - Collapsible frontmatter fields panel (hidden by default)
  - Theme toggle in toolbar (cycles through dark, light, tan, cloud)
  - Icon buttons with subtle hover states
  - Copy button with inverted theme colors
- Enhanced status bar
  - Sticky footer with word/line/character counts
  - Save hint with content directory path
  - Dot separators between stats

### Technical

- Write page now renders without Layout component wrapper
- Added Phosphor icons: House, Sun, Moon, CloudSun, Leaf, Info, X
- CSS restructured for minimal aesthetic (`.write-wrapper`, `.write-header`, etc.)
- Mobile responsive with hidden copy text and save hint on small screens

## [1.13.0] - 2025-12-20

### Added

- Public markdown writing page at `/write` (not linked in navigation)
  - Dropdown to select between "Blog Post" and "Page" content types
  - Frontmatter fields reference panel with required/optional indicators
  - Copy button using Phosphor CopySimple icon
  - Clear button to reset content to template
  - Status bar showing lines, words, and characters count
  - Usage hint with instructions for saving content
- localStorage persistence for writing session
  - Content persists across page refreshes within same browser
  - Each browser has isolated content (session privacy)
  - Content type selection saved separately
- Auto-generated frontmatter templates
  - Blog post template with all common fields
  - Page template with navigation fields
  - Current date auto-populated in templates

### Technical

- New component: `src/pages/Write.tsx`
- Route: `/write` (added to `src/App.tsx`)
- CSS styles added to `src/styles/global.css`
- Works with all four themes (dark, light, tan, cloud)
- Plain textarea for Grammarly and browser spellcheck compatibility
- Mobile responsive design with adjusted layout for smaller screens
- No Convex backend required (localStorage only)

## [1.12.2] - 2025-12-20

### Added

- Centralized font-size configuration using CSS variables in `global.css`
  - Base size scale from 10px to 64px with semantic names
  - Component-specific variables for consistent sizing
  - Mobile responsive overrides at 768px breakpoint
- All hardcoded font sizes converted to CSS variables for easier customization

### Technical

- Font sizes defined in `:root` selector with `--font-size-*` naming convention
- Mobile breakpoint uses same variables with smaller values
- Base scale: 3xs (10px), 2xs (11px), xs (12px), sm (13px), md (14px), base (16px), lg (17px), xl (18px), 2xl (20px), 3xl (24px), 4xl (28px), 5xl (32px), 6xl (36px), hero (64px)

## [1.12.1] - 2025-12-20

### Fixed

- Open Graph images now use post/page `image` field from frontmatter
  - Posts with images in frontmatter display their specific OG image
  - Posts without images fall back to `og-default.svg`
  - Pages now supported with appropriate `og:type` set to "website"
  - Relative image paths resolved to absolute URLs

### Changed

- Renamed `generatePostMetaHtml` to `generateMetaHtml` in `convex/http.ts`
- `/meta/post` endpoint now checks for pages if no post found
- Meta HTML generation accepts optional `image` and `type` parameters

### Technical

- Updated `convex/http.ts` with image resolution logic
- Handles both absolute URLs and relative paths for images
- Deployed to production Convex

## [1.12.0] - 2025-12-20

### Added

- Dedicated blog page at `/blog` with configurable display
  - Enable/disable via `siteConfig.blogPage.enabled`
  - Show/hide from navigation via `siteConfig.blogPage.showInNav`
  - Custom page title via `siteConfig.blogPage.title`
  - Navigation order via `siteConfig.blogPage.order` (lower = first)
- Centralized site configuration in `src/config/siteConfig.ts`
  - Moved all site settings from `Home.tsx` to dedicated config file
  - Easier to customize when forking
- Flexible post display options
  - `displayOnHomepage`: Show posts on the homepage
  - `blogPage.enabled`: Show posts on dedicated `/blog` page
  - Both can be enabled for dual display

### Changed

- Navigation now combines Blog link with pages and sorts by order
  - Blog link position controlled by `siteConfig.blogPage.order`
  - Pages sorted by frontmatter `order` field (lower = first)
  - Items without order default to 999 (appear last, alphabetically)
- `Home.tsx` imports siteConfig instead of defining inline
- `Layout.tsx` uses unified nav item sorting for desktop and mobile

### Technical

- New file: `src/config/siteConfig.ts`
- New page: `src/pages/Blog.tsx`
- Updated: `src/App.tsx` (conditional blog route)
- Updated: `src/components/Layout.tsx` (nav item ordering)
- Updated: `src/styles/global.css` (blog page styles)

## [1.11.1] - 2025-12-20

### Fixed

- Stats page now shows all historical page views correctly
  - Changed `getStats` to use direct counting until aggregates are fully backfilled
  - Ensures accurate stats display even if aggregate backfilling is incomplete

### Changed

- Chunked backfilling for aggregate component
  - Backfill mutation now processes 500 records at a time
  - Prevents memory limit issues with large datasets (16MB Convex limit)
  - Schedules itself to continue processing until complete
  - Progress visible in Convex dashboard logs

### Technical

- `backfillAggregatesChunk` internal mutation handles pagination
- Uses `ctx.scheduler.runAfter` to chain batch processing
- Tracks seen session IDs across chunks for unique visitor counting

## [1.11.0] - 2025-12-20

### Added

- Aggregate component for efficient O(log n) stats counts
  - Replaces O(n) table scans with pre-computed denormalized counts
  - Uses `@convex-dev/aggregate` package for TableAggregate
  - Three aggregates: totalPageViews, pageViewsByPath, uniqueVisitors
- Backfill mutation for existing page view data
  - `stats:backfillAggregates` populates counts from existing data
  - Idempotent and safe to run multiple times

### Changed

- `recordPageView` mutation now updates aggregate components
  - Inserts into pageViewsByPath aggregate for per-page counts
  - Inserts into totalPageViews aggregate for global count
  - Inserts into uniqueVisitors aggregate for new sessions only
- `getStats` query now uses aggregate counts
  - O(log n) count operations instead of O(n) table scans
  - Consistent fast response times regardless of data size
  - Still queries posts/pages for title matching

### Technical

- New file: `convex/convex.config.ts` (updated with aggregate component registrations)
- Three TableAggregate instances with different namespacing strategies
- Performance improvement scales better with growing page view data

### Documentation

- Updated `prds/howstatsworks.md` with old vs new implementation comparison
- Added aggregate component usage examples and configuration

## [1.10.0] - 2025-12-20

### Added

- Fork configuration documentation
  - "Files to Update When Forking" section in docs.md and setup-guide.md
  - Lists all 9 files with site-specific configuration
  - Backend configuration examples for Convex files
  - Code snippets for `convex/http.ts`, `convex/rss.ts`, `src/pages/Post.tsx`
- Same documentation added to README.md for discoverability

### Changed

- Updated site branding across all configuration files
  - `public/robots.txt`: Updated sitemap URL and header
  - `public/llms.txt`: Updated site name and description
  - `public/.well-known/ai-plugin.json`: Updated name and description for AI plugins
  - `public/openapi.yaml`: Updated API title and site name example
  - `convex/http.ts`: Updated SITE_URL and SITE_NAME constants

### Documentation

- Setup guide table of contents now includes fork configuration sections
- Docs page configuration section expanded with backend file list
- All AI discovery files reflect new "markdown sync site" branding

## [1.9.0] - 2025-12-20

### Added

- Scroll-to-top button
  - Appears after scrolling 300px (configurable)
  - Uses Phosphor ArrowUp icon for consistency
  - Smooth scroll animation (configurable)
  - Works with all four themes (dark, light, tan, cloud)
  - Enabled by default (can be disabled in Layout.tsx)
  - Fade-in animation when appearing
  - Responsive sizing for mobile devices

### Technical

- New component: `src/components/ScrollToTop.tsx`
  - Configurable via `ScrollToTopConfig` interface
  - Exports `defaultScrollToTopConfig` for customization
  - Uses passive scroll listener for performance
- Configuration options in Layout.tsx `scrollToTopConfig`
- CSS styles added to global.css with theme-specific shadows

## [1.8.0] - 2025-12-20

### Added

- Mobile menu with hamburger navigation
  - Slide-out drawer on mobile and tablet views
  - Accessible with keyboard navigation (Escape to close)
  - Focus trap for screen reader support
  - Smooth CSS transform animations
  - Page links and Home link in drawer
  - Auto-closes on route change
- Generate Skill option in CopyPageDropdown
  - Formats post/page content as an AI agent skill file
  - Downloads as `{slug}-skill.md` with skill structure
  - Includes metadata, when to use, and instructions sections
  - Uses Download icon from lucide-react

### Changed

- Layout.tsx now includes hamburger button and MobileMenu component
- Desktop navigation hidden on mobile, mobile menu hidden on desktop
- Improved responsive navigation across all breakpoints

### Technical

- New component: `src/components/MobileMenu.tsx`
- HamburgerButton exported from MobileMenu for Layout use
- New `formatAsSkill()` function for skill file generation
- New `handleDownloadSkill()` handler with blob download logic
- Uses browser File API for client-side file download
- CSS styles for mobile menu in global.css

## [1.7.0] - 2025-12-20

### Added

- Static raw markdown files at `/raw/{slug}.md`
  - Generated during `npm run sync` (development) or `npm run sync:prod` (production) in `public/raw/` directory
  - Each published post and page gets a corresponding static `.md` file
  - SEO indexable and accessible to AI agents
  - Includes metadata header (type, date, reading time, tags)
- View as Markdown option in CopyPageDropdown
  - Opens raw `.md` file in new tab
  - Available on all post and page views
- Perplexity added to AI service options in CopyPageDropdown
  - Sends full markdown content via URL parameter
  - Research articles directly in Perplexity
- Featured image support for posts and pages
  - `image` field in frontmatter displays as square thumbnail in card view
  - Non-square images automatically cropped to center
  - Recommended size: 400x400px minimum (800x800px for retina)

### Changed

- CopyPageDropdown now accepts `slug` prop for raw file links
- Updated `_redirects` to serve `/raw/*` files directly
- Improved markdown table CSS styling
  - GitHub-style tables with proper borders
  - Mobile responsive with horizontal scroll
  - Theme-aware alternating row colors
  - Hover states for better readability

### Technical

- Updated `scripts/sync-posts.ts` to generate `public/raw/` files
- Files are regenerated on each sync (old files cleaned up)
- Only published posts and pages generate raw files
- CopyPageDropdown uses FileText icon from lucide-react for View as Markdown

## [1.6.1] - 2025-12-18

### Added

- AGENTS.md with codebase instructions for AI coding agents

### Changed

- Added Firecrawl import to all "When to sync vs deploy" tables in docs
- Clarified import workflow: creates local files only, no `import:prod` needed
- Updated README, setup-guide, how-to-publish, docs page, about-this-blog
- Renamed `content/pages/changelog.md` to `changelog-page.md` to avoid confusion with root changelog

## [1.6.0] - 2025-12-18

### Added

- Firecrawl content importer for external URLs
  - New `npm run import <url>` command
  - Scrapes URLs and converts to local markdown drafts
  - Creates drafts in `content/blog/` with frontmatter
  - Uses Firecrawl API (requires `FIRECRAWL_API_KEY` in `.env.local`)
  - Then sync to dev (`npm run sync`) or prod (`npm run sync:prod`)
  - No separate `import:prod` command needed (import creates local files only)
- New API endpoint `/api/export` for batch content fetching
  - Returns all posts with full markdown content
  - Single request for LLM ingestion
- AI plugin discovery at `/.well-known/ai-plugin.json`
  - Standard format for AI tool integration
- OpenAPI 3.0 specification at `/openapi.yaml`
  - Full API documentation
  - Describes all endpoints, parameters, and responses
- Enhanced `llms.txt` with complete API documentation
  - Added all new endpoints
  - Improved quick start section
  - Added response schema documentation

### Technical

- New script: `scripts/import-url.ts`
- New package dependency: `@mendable/firecrawl-js`
- Updated `netlify/edge-functions/api.ts` for `/api/export` proxy
- Updated `convex/http.ts` with export endpoint
- Created `public/.well-known/` directory

## [1.5.0] - 2025-12-17

### Added

- Frontmatter-controlled featured items
  - Add `featured: true` to any post or page frontmatter
  - Use `featuredOrder` to control display order (lower = first)
  - Featured items sync instantly with `npm run sync` (no redeploy needed)
- New Convex queries for featured content
  - `getFeaturedPosts`: returns posts with `featured: true`
  - `getFeaturedPages`: returns pages with `featured: true`
- Schema updates with `featured` and `featuredOrder` fields
  - Added `by_featured` index for efficient queries

### Changed

- Home.tsx now queries featured items from Convex instead of siteConfig
- FeaturedCards component uses Convex queries for real-time updates
- Removed hardcoded `featuredItems` and `featuredEssays` from siteConfig

### Technical

- Updated sync script to parse `featured` and `featuredOrder` from frontmatter
- Added index on `featured` field in posts and pages tables
- Both list and card views now use frontmatter data

## [1.4.0] - 2025-12-17

### Added

- Featured section with list/card view toggle
  - Card view displays title and excerpt in a responsive grid
  - Toggle button in featured header to switch between views
  - View preference saved to localStorage
- Logo gallery with continuous marquee scroll
  - Clickable logos with configurable URLs
  - CSS only animation for smooth infinite scrolling
  - Configurable speed, position, and title
  - Grayscale logos with color on hover
  - Responsive sizing across breakpoints
  - 5 sample logos included for easy customization
- New `excerpt` field for posts and pages frontmatter
  - Used for card view descriptions
  - Falls back to description field for posts
- Expanded `siteConfig` in Home.tsx
  - `featuredViewMode`: 'list' or 'cards'
  - `showViewToggle`: enable user toggle
  - `logoGallery`: full configuration object

### Technical

- New components: `FeaturedCards.tsx`, `LogoMarquee.tsx`
- Updated schema with optional excerpt field
- Updated sync script to parse excerpt from frontmatter
- CSS uses theme variables for all four themes
- Mobile responsive grid (3 to 2 to 1 columns for cards)

## [1.3.0] - 2025-12-17

### Added

- Real-time search with Command+K keyboard shortcut
  - Search icon in top nav using Phosphor Icons
  - Modal with keyboard navigation (arrow keys, Enter, Escape)
  - Full text search across posts and pages using Convex search indexes
  - Result snippets with context around search matches
  - Distinguishes between posts and pages with type badges
- Search indexes for pages table (title and content)
- New `@phosphor-icons/react` dependency for search icon

### Technical

- Uses Convex full text search with reactive queries
- Deduplicates results from title and content searches
- Sorts results with title matches first
- Mobile responsive modal design
- All four themes supported (dark, light, tan, cloud)

## [1.2.0] - 2025-12-15

### Added

- Real-time stats page at `/stats` with live visitor tracking
  - Active visitors count with per-page breakdown
  - Total page views and unique visitors
  - Views by page sorted by popularity
- Page view tracking via event records pattern (no write conflicts)
- Active session heartbeat system (30s interval, 2min timeout)
- Cron job for stale session cleanup every 5 minutes
- New Convex tables: `pageViews` and `activeSessions`
- Stats link in homepage footer

### Technical

- Uses anonymous session UUIDs (no PII stored)
- All stats update in real-time via Convex subscriptions
- Mobile responsive stats grid (4 to 2 to 1 columns)
- Theme support with CSS variables (dark, light, tan, cloud)

## [1.1.0] - 2025-12-14

### Added

- Netlify Edge Functions for dynamic Convex HTTP proxying
  - `rss.ts` proxies `/rss.xml` and `/rss-full.xml`
  - `sitemap.ts` proxies `/sitemap.xml`
  - `api.ts` proxies `/api/posts` and `/api/post`
- Vite dev server proxy for RSS, sitemap, and API endpoints

### Changed

- Replaced hardcoded Convex URLs in netlify.toml with edge functions
- Edge functions dynamically read `VITE_CONVEX_URL` from environment
- Updated setup guide, docs, and README with edge function documentation

### Fixed

- RSS feeds and sitemap now work without manual URL configuration
- Local development properly proxies API routes to Convex

## [1.0.0] - 2025-12-14

### Added

- Initial project setup with Vite, React, TypeScript
- Convex backend with posts, pages, viewCounts, and siteConfig tables
- Markdown blog post support with frontmatter parsing
- Static pages support (About, Projects, Contact) with navigation
- Four theme options: Dark, Light, Tan (default), Cloud
- Font configuration option in global.css with serif (New York) as default
- Syntax highlighting for code blocks using custom Prism themes
- Year-grouped post list on home page
- Individual post pages with share buttons
- SEO optimization with dynamic sitemap at `/sitemap.xml`
- JSON-LD structured data injection for blog posts
- RSS feeds at `/rss.xml` and `/rss-full.xml` (full content for LLMs)
- AI agent discovery with `llms.txt` following llmstxt.org standard
- `robots.txt` with rules for AI crawlers
- API endpoints for LLM access:
  - `/api/posts` - JSON list of all posts
  - `/api/post?slug=xxx` - Single post as JSON or markdown
- Copy Page dropdown for sharing to ChatGPT, Claude
- Open Graph and Twitter Card meta tags
- Netlify edge function for social media crawler detection
- Build-time markdown sync from `content/blog/` to Convex
- Responsive design for mobile, tablet, and desktop

### Security

- All HTTP endpoints properly escape HTML and XML output
- Convex queries use indexed lookups
- External links use rel="noopener noreferrer"
- No console statements in production code

### Technical Details

- React 18 with TypeScript
- Convex for real-time database
- react-markdown for rendering
- react-syntax-highlighter for code blocks
- date-fns for date formatting
- lucide-react for icons
- Netlify deployment with edge functions
- SPA 404 fallback configured