Merge pull request #108 from cortex-docs/feat/hosted-docs

feat: release hosted documentation and live repository MCP

Author: nick-csu

CHANGELOG.md

@@ -8,6 +8,77 @@ The project uses Semantic Versioning. Each release contains the same three chang
 
 ### New Features
 
+- None.
+
+### Bug Fixes
+
+- None.
+
+### Improvements
+
+- None.
+
+## [0.1.35] - 2026-09-22
+
+### New Features
+
+- None.
+
+### Bug Fixes
+
+- None.
+
+### Improvements
+
+- Documented the `primaryColor` configuration option in the README, showing how to set the documentation accent color as a six-digit hex value.
+
+## [0.1.34] - 2026-09-22
+
+### New Features
+
+- None.
+
+### Bug Fixes
+
+- None.
+
+### Improvements
+
+- Sharpened the README demo animation and poster image for better clarity.
+
+## [0.1.33] - 2026-09-22
+
+### New Features
+
+- None.
+
+### Bug Fixes
+
+- None.
+
+### Improvements
+
+- Replaced the static SVG overview in the README with an animated terminal demo GIF and PNG for a more interactive preview of Cortex.
+- Added a Product Hunt badge and a changelog link to the README.
+
+## [0.1.32] - 2026-09-13
+
+### New Features
+
+- None.
+
+### Bug Fixes
+
+- None.
+
+### Improvements
+
+- Added a Product Hunt badge and a link to the changelog on the README.
+
+## [0.1.31] - 2026-09-12
+
+### New Features
+
 - `cortex docs build` now exports static HTML, CSS, JavaScript, and documentation data for deployment to a static web host.
 
 ### Bug Fixes

README.md

@@ -51,43 +51,32 @@ If Cortex helps your team, [star this repository](https://github.com/cortex-docs
 
 ## Try Cortex in 60 seconds
 
-Create a sample project and inspect the generation plan:
+Start a local demo:
 
 ```bash
 mkdir petstore
 cd petstore
 npm install --global @cortex-docs/cli
 cortex init petstore
-cortex validate
-cortex generate --dry-run
+cortex docs serve
 ```
 
-Cortex validates each source and shows every planned output:
-
-```text
-✓ Config is valid
-✓ Parsed AsyncAPI: WebSocket API
-✓ Parsed GraphQL: GraphQL
-✓ Parsed OpenRPC: OpenRPC
-✓ Parsed OpenAPI: REST API V1
-Languages: typescript, python, go, java, kotlin, ruby, php, csharp, rust, cpp, c
-
-typescript [REST + WS + GraphQL + OpenRPC] → generated/typescript/petstore-typescript-client-sdk
-python [REST + WS + GraphQL + OpenRPC] → generated/python/petstore-python-sdk
-...
-mcp-server → generated/mcp-server
-```
+Open `http://localhost:3012`. Press `Ctrl+C` to stop the server.
 
-The generated MCP server gives AI agents typed tools, specifications, SDK guides, and project documentation.
+## We love open source
 
-Generate the files. Then start the local documentation preview:
+Keep your Markdown in Git. Add `cortex.config.yml` to the default branch of your public GitHub repository, then run:
 
 ```bash
-cortex generate
-cortex docs serve
+npx -y @cortex-docs/cli deploy https://github.com/OWNER/REPO
+npx -y @cortex-docs/cli mcp-serve https://github.com/OWNER/REPO
 ```
 
-Open `http://localhost:3012`. Press `Ctrl+C` to stop the server.
+The first command publishes a free documentation site at `PROJECT.cortexdocs.dev`. The second connects AI clients to current documentation through local MCP.
+
+Deploy requires repository write access. MCP works with public read access and checks for changes before each request.
+
+See the [open source hosting guide](packages/docs-site/docs/open-source-hosting.md) for configuration, custom domains, automatic updates, and limits.
 
 ## Features
 

e2e/docs-ui-static.spec.ts

@@ -55,6 +55,17 @@ test.describe('Cloudflare Static Assets export', () => {
     await expect(page.getByText('TypeScript').first()).toBeVisible();
   });
 
+  test('follows Markdown fragments after static content loads', async ({ page }) => {
+    await page.setViewportSize({ width: 1000, height: 400 });
+    await page.goto('/docs/quickstart#mcp-server');
+    await expect(page.locator('article #user-content-mcp-server')).toBeInViewport({ ratio: 1 });
+
+    await page.goto('/docs/quickstart');
+    await page.getByRole('link', { name: 'next steps', exact: true }).click();
+    await expect(page).toHaveURL(/#next-steps$/);
+    await expect(page.locator('article #user-content-next-steps')).toBeInViewport({ ratio: 1 });
+  });
+
   for (const width of [320, 390]) {
     test(`keeps documentation readable and navigation usable at ${width}px`, async ({ page }) => {
       await page.setViewportSize({ width, height: 844 });