Rewrite Mintlify docs in-depth (29 pages), migrate mint.json to docs.json, fix broken /docs# anchor links, update files.md/changelog.md/task.md

Author: waynesutton

ONE-CLICK-DEPLOY.md

@@ -223,9 +223,9 @@ This happens when WorkOS CORS is not configured:
 
 ## Next steps
 
-- [Full setup guide](https://www.opensync.dev/docs#hosting) for detailed configuration
-- [Plugin development guide](https://www.opensync.dev/docs#plugins) to build your own sync plugin
-- [API reference](https://www.opensync.dev/docs#api) for programmatic access
+- [Full setup guide](https://docs.opensync.dev/hosting/convex) for detailed configuration
+- [Plugin development guide](https://docs.opensync.dev/plugins/opencode-sync) to build your own sync plugin
+- [API reference](https://docs.opensync.dev/api/endpoints) for programmatic access
 - [install.md](install.md) for local development setup
 
 ## Need help?

README.md

@@ -4,7 +4,7 @@ Dashboards for OpenCode, Claude Code, Codex, Cursor, Factory Droid and more.
 
 Cloud-synced dashboards that track session activity, tool usage, and token spend. Build eval datasets across projects.
 
-[Website](https://www.opensync.dev/) | [Docs](https://www.opensync.dev/docs) | [Dashboard](https://www.opensync.dev/)
+[Website](https://www.opensync.dev/) | [Docs](https://docs.opensync.dev) | [Dashboard](https://www.opensync.dev/)
 
 ## OpenSync Ecosystems
 
@@ -22,12 +22,12 @@ Cloud-synced dashboards that track session activity, tool usage, and token spend
 
 | Feature                                                 | Description                                    |
 | ------------------------------------------------------- | ---------------------------------------------- |
-| [Sync](https://www.opensync.dev/docs#hosted-features)   | Sessions sync in real time as you work         |
-| [Search](https://www.opensync.dev/docs#search)          | Full text, semantic, and hybrid search         |
-| [Private](https://www.opensync.dev/docs#auth)           | Your data stays in your account                |
-| [Tag](https://www.opensync.dev/docs#dashboard-evals)    | Organize sessions with custom labels for evals |
-| [Export](https://www.opensync.dev/docs#dashboard-evals) | DeepEval JSON, OpenAI Evals JSONL, plain text  |
-| [Delete](https://www.opensync.dev/docs#hosted-features) | Your data, your control                        |
+| [Sync](https://docs.opensync.dev/getting-started/hosted)   | Sessions sync in real time as you work         |
+| [Search](https://docs.opensync.dev/search/fulltext)        | Full text, semantic, and hybrid search         |
+| [Private](https://docs.opensync.dev/auth/workos)           | Your data stays in your account                |
+| [Tag](https://docs.opensync.dev/dashboard/evals)           | Organize sessions with custom labels for evals |
+| [Export](https://docs.opensync.dev/dashboard/evals)        | DeepEval JSON, OpenAI Evals JSONL, plain text  |
+| [Delete](https://docs.opensync.dev/getting-started/hosted) | Your data, your control                        |
 
 ## Quick start
 
@@ -38,7 +38,7 @@ Cloud-synced dashboards that track session activity, tool usage, and token spend
 3. Install a sync plugin (see below)
 4. Start coding
 
-[Full setup guide](https://www.opensync.dev/docs#hosted)
+[Full setup guide](https://docs.opensync.dev/getting-started/hosted)
 
 ### Install sync plugins
 
@@ -57,7 +57,7 @@ Add to your `opencode.json`:
 }
 ```
 
-[OpenCode plugin docs](https://www.opensync.dev/docs#opencode-plugin)
+[OpenCode plugin docs](https://docs.opensync.dev/plugins/opencode-sync)
 
 **For Claude Code:**
 
@@ -66,7 +66,7 @@ npm install -g claude-code-sync
 claude-code-sync login
 ```
 
-[Claude Code plugin docs](https://www.opensync.dev/docs#claude-plugin)
+[Claude Code plugin docs](https://docs.opensync.dev/plugins/claude-code-sync)
 
 **For Codex CLI:**
 
@@ -75,7 +75,7 @@ npm install -g codex-sync
 codex-sync login
 ```
 
-[Codex CLI plugin docs](https://www.opensync.dev/docs#codex-plugin)
+[Codex CLI plugin docs](https://docs.opensync.dev/plugins/codex-sync)
 
 **For Cursor:**
 
@@ -84,7 +84,7 @@ npm install -g cursor-sync-plugin
 cursor-sync login
 ```
 
-[Cursor plugin docs](https://www.opensync.dev/docs#cursor-plugin)
+[Cursor plugin docs](https://docs.opensync.dev/plugins/cursor-sync)
 
 **For Pi:**
 
@@ -94,7 +94,7 @@ npm install -g pi-opensync-plugin
 
 Then run `/opensync:config` in pi to configure the extension.
 
-[Pi plugin docs](https://www.opensync.dev/docs#pi-plugin)
+[Pi plugin docs](https://github.com/joshuadavidthomas/pi-opensync-plugin)
 
 ## Self hosting
 
@@ -109,7 +109,7 @@ npx convex dev
 
 Requires Convex, WorkOS, and OpenAI accounts.
 
-[Self hosting guide](https://www.opensync.dev/docs#hosting) | [Fork guide](https://www.opensync.dev/docs#fork) | [install.md](install.md)
+[Self hosting guide](https://docs.opensync.dev/hosting/convex) | [Fork guide](https://docs.opensync.dev/fork/guide) | [install.md](install.md)
 
 ### One-click deploy
 
@@ -126,12 +126,12 @@ Four views for managing your sessions:
 
 | View                                                           | What it does                                       |
 | -------------------------------------------------------------- | -------------------------------------------------- |
-| [Overview](https://www.opensync.dev/docs#dashboard-overview)   | Usage stats, token charts, recent sessions         |
-| [Sessions](https://www.opensync.dev/docs#dashboard-sessions)   | Filter, search, and manage all sessions            |
-| [Evals](https://www.opensync.dev/docs#dashboard-evals)         | Mark sessions as eval-ready, export datasets       |
-| [Analytics](https://www.opensync.dev/docs#dashboard-analytics) | Model comparison, project breakdown, cost tracking |
+| [Overview](https://docs.opensync.dev/dashboard/overview)   | Usage stats, token charts, recent sessions         |
+| [Sessions](https://docs.opensync.dev/dashboard/sessions)   | Filter, search, and manage all sessions            |
+| [Evals](https://docs.opensync.dev/dashboard/evals)         | Mark sessions as eval-ready, export datasets       |
+| [Analytics](https://docs.opensync.dev/dashboard/analytics) | Model comparison, project breakdown, cost tracking |
 
-[Context search](https://www.opensync.dev/docs#dashboard-context) lets you find relevant sessions for RAG and context engineering.
+[Context search](https://docs.opensync.dev/dashboard/context) lets you find relevant sessions for RAG and context engineering.
 
 ## API
 
@@ -146,7 +146,7 @@ All endpoints require authentication. Generate an API key in Settings.
 | `GET /api/context?q=` | Get context for LLM |
 | `GET /api/export?id=` | Export session      |
 
-[Full API reference](https://www.opensync.dev/docs#api)
+[Full API reference](https://docs.opensync.dev/api/endpoints)
 
 ## Tech stack
 

changelog.md

@@ -6,29 +6,31 @@ Format based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Unreleased]
 
-### Changed
-
-- Migrated all in-app documentation to Mintlify at docs.opensync.dev
-  - Removed Docs.tsx (full in-app documentation page with sidebar, search, and markdown export)
-  - Removed src/lib/search.ts (client-side search index builder for docs)
-  - Removed src/search-index.json (pre-built search index data)
-  - Removed src/mdx.d.ts (MDX type declarations)
-  - All /docs, /docs/*, and /docs-legacy routes now redirect externally to docs.opensync.dev
-  - Added DocsRedirect component in App.tsx for client-side redirect
-  - Updated Sidebar.tsx docs link to point to external docs.opensync.dev
-- Platform Stats header now displays "last 1000 sessions" label for clarity
-  - Users know the leaderboard data is based on recent activity, not all-time totals
-
-### Fixed
-
-- Fixed Netlify build error: Stats.tsx was git-ignored causing module not found error
-  - Removed src/pages/Stats.tsx from .gitignore so placeholder page is included in build
-  - Updated Stats.tsx header comment to reflect it's no longer git-ignored
-- Fixed Netlify build error caused by removed Docs.tsx import references
-  - Cleaned up all imports of deleted files (search.ts, search-index.json, mdx.d.ts)
-
 ### Added
 
+- Comprehensive Mintlify documentation rewrite with in-depth technical content
+  - Created docs.json (replacing mint.json) with new Mintlify schema, navigation groups, and correct GitHub URLs
+  - Created index.mdx landing page with CardGroup links to all documentation sections
+  - Rewrote getting-started/hosted.mdx with supported tools table, step-by-step setup, what gets synced, privacy details
+  - Rewrote getting-started/requirements.mdx with cloud vs local deployment, architecture overview, env var reference
+  - Rewrote dashboard/overview.mdx with schema field mapping, filter details, real-time update explanation
+  - Rewrote dashboard/sessions.mdx with full data model table, filtering, sorting, message parts, bulk actions
+  - Rewrote dashboard/evals.mdx with eval workflow, labels, metadata fields, three export formats with examples
+  - Rewrote dashboard/analytics.mdx with cost formula, model pricing table, token breakdown, trend charts
+  - Rewrote dashboard/context.mdx with embedding internals, API examples, RAG use cases
+  - Rewrote plugins/opencode-sync.mdx with setup steps, commands, syncing internals, schema mapping, troubleshooting
+  - Rewrote plugins/claude-code-sync.mdx with setup, commands, session data mapping, troubleshooting
+  - Rewrote plugins/codex-sync.mdx with supported models, pricing, troubleshooting
+  - Rewrote plugins/cursor-sync.mdx with supported models, what gets synced, privacy notes
+  - Rewrote api/endpoints.mdx with full sync/query/search/export/context endpoint reference and request/response examples
+  - Rewrote search/fulltext.mdx with indexing details, syntax, ranking, comparison with semantic
+  - Rewrote search/semantic.mdx with embedding model, storage schema, examples, requirements
+  - Rewrote search/hybrid.mdx with scoring formula, RAG pipeline example, comparison table
+  - Rewrote auth/workos.mdx with auth flow, user provisioning schema, redirect URIs, CORS, troubleshooting
+  - Rewrote hosting/convex.mdx with schema tables, indexes, HTTP endpoints, monitoring, scaling
+  - Fixed broken /docs#anchor links in README.md, ONE-CLICK-DEPLOY.md, and Login.tsx (mapped to new Mintlify paths)
+  - Fixed /docs/fork/contribute link in FAQ
+  - Added Pi and Factory Droid to supported tools in FAQ
 - pi-opensync-plugin community plugin support (syncs Pi coding agent sessions)
   - Added "pi" to SourceType union with orange PI badge (#f97316)
   - Added Pi to Login page "Syncs with" section with SVG icon