feat: Make semantic search optional and disabled by default

- Add SemanticSearchConfig interface with enabled toggle to siteConfig.ts
- Default semantic search to disabled (enabled: false) to avoid blocking forks without OPENAI_API_KEY
- Update SearchModal.tsx to conditionally show mode toggle based on config
- Update sync-posts.ts to skip embedding generation when disabled
- Add semantic search toggle to Dashboard config generator
- Update FORK_CONFIG.md with Semantic Search Configuration section
- Update fork-config.json.example with semanticSearch option
- Update docs-semantic-search.md with enable/disable instructions
- Update changelog and documentation

When disabled (default):
- Search modal shows only keyword search (no mode toggle)
- Embedding generation skipped during sync
- No OpenAI API key required

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

content/pages/changelog-page.md

@@ -11,6 +11,29 @@ docsSectionOrder: 4
 
 All notable changes to this project.
 
+## v2.10.1
+
+Released January 5, 2026
+
+**Optional semantic search configuration**
+
+Semantic search can now be disabled via `siteConfig.semanticSearch.enabled`:
+
+```typescript
+semanticSearch: {
+  enabled: false, // Disable semantic search, use keyword only
+},
+```
+
+When disabled:
+- Search modal shows only keyword search (no mode toggle)
+- Embedding generation skipped during sync (saves API costs)
+- Existing embeddings preserved in database (no data loss)
+
+Default is `enabled: false` (keyword search only, no API key required). Set to `true` and configure OPENAI_API_KEY to enable semantic search.
+
+Updated files: `src/config/siteConfig.ts`, `src/components/SearchModal.tsx`, `scripts/sync-posts.ts`, `src/pages/Dashboard.tsx`, `FORK_CONFIG.md`, `fork-config.json.example`, `content/pages/docs-semantic-search.md`, `content/pages/docs.md`
+
 ## v2.10.0
 
 Released January 5, 2026

content/pages/docs-semantic-search.md

@@ -87,6 +87,31 @@ If the key is not configured:
 - Keyword search continues to work normally
 - Sync script skips embedding generation
 
+### Enable/Disable Semantic Search
+
+Semantic search is **disabled by default** to avoid requiring API keys for forks. Enable it via `src/config/siteConfig.ts`:
+
+```typescript
+semanticSearch: {
+  enabled: true, // Enable semantic search (requires OPENAI_API_KEY)
+},
+```
+
+When disabled (default):
+- Search modal shows only keyword search (no mode toggle)
+- Embedding generation skipped during sync (saves API costs)
+- No OpenAI API key required
+
+When enabled:
+- Search modal shows both Keyword and Semantic modes
+- Embeddings generated during `npm run sync`
+- Requires OPENAI_API_KEY in Convex
+
+To enable semantic search:
+1. Set `semanticSearch.enabled: true` in siteConfig.ts
+2. Set `OPENAI_API_KEY` in Convex: `npx convex env set OPENAI_API_KEY sk-xxx`
+3. Run `npm run sync` to generate embeddings
+
 ### How embeddings are generated
 
 When you run `npm run sync`:

content/pages/docs.md

@@ -98,8 +98,11 @@ Press `Command+K` (Mac) or `Ctrl+K` (Windows/Linux) to open the search modal. Cl
 - Result snippets with context around matches
 - Distinguishes between posts and pages
 - Works with all four themes
+- Two search modes: [Keyword](/docs-search) (exact match) and [Semantic](/docs-semantic-search) (meaning-based)
 
-Search uses Convex full text search indexes. No configuration needed.
+Search uses Convex full text search indexes. No configuration needed for keyword search.
+
+**Semantic search configuration:** Requires `OPENAI_API_KEY` in Convex. Can be disabled via `siteConfig.semanticSearch.enabled: false`. See [Semantic Search](/docs-semantic-search) for details.
 
 ## Copy Page dropdown