docs: pure-OSS markdown, drop Nextra site

.github/workflows/ci.yml

@@ -41,20 +41,17 @@ jobs:
           node-version: 20
       - run: node packages/create-dql-app/test/smoke.mjs
 
-  # --- docs build + internal link check ---
+  # --- docs: verify every relative markdown link under docs/ resolves ---
   docs:
-    name: docs build + link check
+    name: docs link check
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: pnpm/action-setup@v4
       - uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: pnpm
-      - run: pnpm install --frozen-lockfile
-      - run: node apps/docs/scripts/link-check.mjs
-      - run: pnpm -F @duckcodeailabs/docs build
+      - name: check relative links in docs/
+        run: node scripts/check-doc-links.mjs
 
   # --- dql fmt --check across the repo ---
   # Gates canonical .dql serialization — catches whitespace churn before
@@ -70,7 +67,7 @@ jobs:
           node-version: 20
           cache: pnpm
       - run: pnpm install --frozen-lockfile
-      - run: pnpm -F @duckcodeailabs/dql-cli build
+      - run: pnpm build
       - name: dql fmt --check
         run: |
           set -e
@@ -85,7 +82,7 @@ jobs:
           done
 
   # --- 4,000-model stress test (perf gate) ---
-  # Gates: cold <30s, warm <2s. See docs.duckcode.ai/contribute/testing.
+  # Gates: cold <30s, warm <2s. See docs/contribute/testing.md.
   stress-test:
     name: stress (4k-model synthetic project)
     runs-on: ubuntu-latest

README.md

@@ -24,14 +24,15 @@ Already have a **dbt project**? Run `create-dql-app` next to it — the scaffold
 
 ## Documentation
 
-**📘 [docs.duckcode.ai](https://docs.duckcode.ai)** — the single source of truth.
+All docs live in [`docs/`](./docs/) — plain markdown, rendered on github.com.
+Start with [docs/README.md](./docs/README.md).
 
 Quick links:
 
-- [Install](https://docs.duckcode.ai/get-started/install) · [Quickstart](https://docs.duckcode.ai/get-started/quickstart) · [Concepts](https://docs.duckcode.ai/get-started/concepts)
-- [Jaffle Shop walkthrough](https://docs.duckcode.ai/guides/jaffle-shop) · [Import dbt](https://docs.duckcode.ai/guides/import-dbt) · [Author a block](https://docs.duckcode.ai/guides/authoring-blocks)
-- [CLI reference](https://docs.duckcode.ai/reference/cli) · [Language reference](https://docs.duckcode.ai/reference/language) · [Connectors](https://docs.duckcode.ai/reference/connectors)
-- [Architecture](https://docs.duckcode.ai/architecture/overview) · [Contributing](https://docs.duckcode.ai/contribute/repo-layout)
+- [Quickstart](./docs/01-quickstart.md) · [Concepts](./docs/02-concepts.md) · [Install](./docs/03-install.md)
+- [Jaffle Shop walkthrough](./docs/guides/jaffle-shop.md) · [Import dbt](./docs/guides/import-dbt.md) · [Author a block](./docs/guides/authoring-blocks.md)
+- [CLI reference](./docs/reference/cli.md) · [Language reference](./docs/reference/language.md) · [Connectors](./docs/reference/connectors.md)
+- [Architecture](./docs/architecture/overview.md) · [Contributing](./docs/contribute/repo-layout.md)
 
 ## What's in the box
 
@@ -49,7 +50,7 @@ Natural-language / agentic block generation, MCP runtime, hosted workspaces, RBA
 
 ## Contributing
 
-See [CONTRIBUTING.md](./CONTRIBUTING.md) and the [contribute section](https://docs.duckcode.ai/contribute/repo-layout) of the docs site. Bugs and feature requests: [open an issue](https://github.com/duckcode-ai/dql/issues).
+See [CONTRIBUTING.md](./CONTRIBUTING.md) and [docs/contribute/repo-layout.md](./docs/contribute/repo-layout.md). Bugs and feature requests: [open an issue](https://github.com/duckcode-ai/dql/issues).
 
 ## License
 

apps/desktop/.gitignore

@@ -1,2 +1,3 @@
 src-tauri/target/
 src-tauri/Cargo.lock
+src-tauri/gen/

apps/desktop/README.md

@@ -34,4 +34,4 @@ pnpm -F @duckcodeailabs/desktop build
 | Linux | `.deb`, `.AppImage`, `.rpm` |
 | Windows | `.msi`, `.exe` (code-signed) |
 
-See [docs.duckcode.ai/get-started/install](https://docs.duckcode.ai/get-started/install/).
+See [docs/03-install.md](../../docs/03-install.md).

apps/desktop/package.json

@@ -5,9 +5,13 @@
   "description": "Tauri desktop wrapper for the DQL notebook + CLI sidecar.",
   "scripts": {
     "dev": "tauri dev",
-    "build": "tauri build",
+    "build": "echo 'skipping tauri build — use release-desktop workflow'",
+    "build:tauri": "tauri build",
     "tauri": "tauri"
   },
+  "dependencies": {
+    "@duckcodeailabs/dql-notebook-app": "workspace:*"
+  },
   "devDependencies": {
     "@tauri-apps/cli": "2.1.0"
   }

apps/desktop/src-tauri/tauri.conf.json

@@ -5,7 +5,7 @@
   "identifier": "ai.duckcode.dql",
   "build": {
     "beforeDevCommand": "pnpm -F @duckcodeailabs/dql-notebook-app dev",
-    "beforeBuildCommand": "pnpm -F @duckcodeailabs/dql-notebook-app build",
+    "beforeBuildCommand": "",
     "devUrl": "http://localhost:5173",
     "frontendDist": "../../dql-notebook/dist"
   },