doxla 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Doxla
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# doxla
+
+Improve documentation discoverability within repos. Doxla discovers all `.md` files in your repository, builds a beautiful docs viewer, and deploys it to GitHub Pages.
+
+## Quick Start
+
+### Deploy to GitHub Pages
+
+Run this in your repo to set up automatic deployment:
+
+```bash
+npx doxla init
+```
+
+This creates a GitHub Actions workflow that builds and deploys your docs on every push to `main`.
+
+**Important:** You must enable GitHub Pages in your repo settings before the workflow will deploy:
+
+1. Go to **Settings** > **Pages**
+2. Under **Source**, select **GitHub Actions**
+3. Commit and push — the workflow handles the rest
+
+### Build locally
+
+```bash
+npx doxla build
+```
+
+This discovers all markdown files, builds a static docs site, and outputs it to `doxla-dist/`.
+
+## Features
+
+- Automatic markdown file discovery (respects `.gitignore`-style patterns)
+- Beautiful React-based docs viewer with sidebar navigation
+- Full-text search across all documents
+- Syntax highlighting for code blocks
+- GitHub Flavored Markdown (tables, task lists, strikethrough)
+- Responsive layout
+- Zero configuration required
+
+## CLI Options
+
+### `doxla init`
+
+Creates `.github/workflows/doxla.yml` for automatic GitHub Pages deployment.
+
+### `doxla build`
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `-o, --output <dir>` | `doxla-dist` | Output directory |
+| `-r, --root <dir>` | `.` | Root directory to scan for markdown |
+| `--base-path <path>` | `/` | Base path for GitHub Pages (e.g. `/my-repo`) |
+
+## How It Works
+
+1. **Discover** - Scans your repo for `.md` files (excluding `node_modules`, `.git`, etc.)
+2. **Manifest** - Reads each file, extracts titles, and generates a JSON manifest
+3. **Build** - Copies the built-in React app template, injects the manifest, and runs `vite build`
+4. **Output** - Produces a static site ready for any hosting
+
+## Development
+
+```bash
+pnpm install
+pnpm build        # Build the CLI
+pnpm test         # Run tests
+```
+
+## License
+
+MIT

package/dist/cli/index.js

@@ -180,16 +180,14 @@ async function buildApp(manifest, options) {
       JSON.stringify(manifest, null, 2),
       "utf-8"
     );
-    const envContent = `VITE_BASE_PATH=${options.basePath}
-`;
-    await writeFile2(join3(tempDir, ".env"), envContent, "utf-8");
     execSync("npm install --no-audit --no-fund", {
       cwd: tempDir,
       stdio: "pipe"
     });
     execSync("npx vite build", {
       cwd: tempDir,
-      stdio: "pipe"
+      stdio: "pipe",
+      env: { ...process.env, VITE_BASE_PATH: options.basePath }
     });
     await rm(options.output, { recursive: true, force: true });
     await mkdir2(options.output, { recursive: true });

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/init.ts","../../src/cli/templates/doxla-workflow.ts","../../src/cli/commands/build.ts","../../src/cli/lib/discover.ts","../../src/cli/lib/manifest.ts","../../src/cli/lib/build-app.ts","../../src/cli/lib/template.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { initCommand } from \"./commands/init.js\";\nimport { buildCommand } from \"./commands/build.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"doxla\")\n  .description(\"Improve documentation discoverability within repos\")\n  .version(\"0.1.0\");\n\nprogram\n  .command(\"init\")\n  .description(\"Set up GitHub Actions workflow for Doxla docs deployment\")\n  .action(initCommand);\n\nprogram\n  .command(\"build\")\n  .description(\"Discover markdown files and build the docs viewer\")\n  .option(\"-o, --output <dir>\", \"Output directory\", \"doxla-dist\")\n  .option(\"-r, --root <dir>\", \"Root directory to scan for markdown files\", \".\")\n  .option(\"--base-path <path>\", \"Base path for GitHub Pages deployment\", \"/\")\n  .action(buildCommand);\n\nprogram.parse();\n","import { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport chalk from \"chalk\";\nimport { workflowTemplate } from \"../templates/doxla-workflow.js\";\n\nexport async function initCommand() {\n  const workflowDir = join(process.cwd(), \".github\", \"workflows\");\n  const workflowPath = join(workflowDir, \"doxla.yml\");\n\n  if (existsSync(workflowPath)) {\n    console.log(\n      chalk.yellow(\"⚠ Workflow file already exists at .github/workflows/doxla.yml\")\n    );\n    console.log(chalk.yellow(\"  Overwriting with latest template...\"));\n  }\n\n  await mkdir(workflowDir, { recursive: true });\n  await writeFile(workflowPath, workflowTemplate, \"utf-8\");\n\n  console.log(chalk.green(\"✓ Created .github/workflows/doxla.yml\"));\n  console.log();\n  console.log(\"Next steps:\");\n  console.log(\n    `  1. Enable GitHub Pages in your repo settings (Settings → Pages → Source: ${chalk.bold(\"GitHub Actions\")})`\n  );\n  console.log(\"  2. Commit and push the workflow file\");\n  console.log(\n    \"  3. Your docs will be built and deployed on every push to main\"\n  );\n}\n","export const workflowTemplate = `name: Deploy Doxla Docs\n\non:\n  push:\n    branches: [main]\n  workflow_dispatch:\n\npermissions:\n  contents: read\n  pages: write\n  id-token: write\n\nconcurrency:\n  group: \"pages\"\n  cancel-in-progress: false\n\njobs:\n  build-and-deploy:\n    runs-on: ubuntu-latest\n    environment:\n      name: github-pages\n      url: \\${{ steps.deployment.outputs.page_url }}\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: \"20\"\n      - run: npx doxla@latest build --base-path \"/\\${{ github.event.repository.name }}\"\n      - uses: actions/upload-pages-artifact@v3\n        with:\n          path: ./doxla-dist\n      - id: deployment\n        uses: actions/deploy-pages@v4\n`;\n","import { resolve } from \"node:path\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\nimport { discoverMarkdownFiles } from \"../lib/discover.js\";\nimport { generateManifest } from \"../lib/manifest.js\";\nimport { buildApp } from \"../lib/build-app.js\";\n\ninterface BuildOptions {\n  output: string;\n  root: string;\n  basePath: string;\n}\n\nexport async function buildCommand(options: BuildOptions) {\n  const rootDir = resolve(options.root);\n  const outputDir = resolve(options.output);\n  const basePath = options.basePath;\n\n  console.log(chalk.bold(\"doxla build\"));\n  console.log();\n\n  // Step 1: Discover markdown files\n  const discoverSpinner = ora(\"Discovering markdown files...\").start();\n  const files = await discoverMarkdownFiles(rootDir);\n\n  if (files.length === 0) {\n    discoverSpinner.fail(\"No markdown files found\");\n    process.exit(1);\n  }\n\n  discoverSpinner.succeed(`Found ${files.length} markdown file${files.length === 1 ? \"\" : \"s\"}`);\n\n  // Step 2: Generate manifest\n  const manifestSpinner = ora(\"Generating manifest...\").start();\n  const manifest = await generateManifest(rootDir, files);\n  manifestSpinner.succeed(\"Manifest generated\");\n\n  // Step 3: Build docs viewer\n  const buildSpinner = ora(\"Building docs viewer...\").start();\n  try {\n    await buildApp(manifest, { output: outputDir, basePath });\n    buildSpinner.succeed(\"Docs viewer built\");\n  } catch (error) {\n    buildSpinner.fail(\"Build failed\");\n    console.error(chalk.red((error as Error).message));\n    process.exit(1);\n  }\n\n  console.log();\n  console.log(chalk.green(`✓ Output written to ${options.output}/`));\n}\n","import fg from \"fast-glob\";\n\nconst IGNORE_PATTERNS = [\n  \"**/node_modules/**\",\n  \"**/.git/**\",\n  \"**/dist/**\",\n  \"**/build/**\",\n  \"**/doxla-dist/**\",\n  \"**/.next/**\",\n  \"**/coverage/**\",\n];\n\nexport async function discoverMarkdownFiles(rootDir: string): Promise<string[]> {\n  const files = await fg(\"**/*.md\", {\n    cwd: rootDir,\n    ignore: IGNORE_PATTERNS,\n    onlyFiles: true,\n  });\n\n  // Sort: README.md first, then alphabetical\n  return files.sort((a, b) => {\n    const aIsReadme = a.toLowerCase() === \"readme.md\";\n    const bIsReadme = b.toLowerCase() === \"readme.md\";\n    if (aIsReadme && !bIsReadme) return -1;\n    if (!aIsReadme && bIsReadme) return 1;\n    return a.localeCompare(b);\n  });\n}\n","import { readFile } from \"node:fs/promises\";\nimport { join, basename, dirname } from \"node:path\";\nimport type { Manifest, DocFile } from \"../../app/src/types/manifest.js\";\n\nfunction extractTitle(content: string, filePath: string): string {\n  // Try to extract from first # heading\n  const match = content.match(/^#\\s+(.+)$/m);\n  if (match) {\n    return match[1].trim();\n  }\n\n  // Fallback to filename without extension\n  const name = basename(filePath, \".md\");\n  if (name.toLowerCase() === \"readme\") {\n    const dir = dirname(filePath);\n    if (dir === \".\") return \"README\";\n    return `${dir} - README`;\n  }\n  return name.replace(/[-_]/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\nfunction createSlug(filePath: string): string {\n  return filePath\n    .replace(/\\.md$/i, \"\")\n    .replace(/\\\\/g, \"/\")\n    .toLowerCase()\n    .replace(/[^a-z0-9/.-]/g, \"-\");\n}\n\nexport async function generateManifest(\n  rootDir: string,\n  files: string[]\n): Promise<Manifest> {\n  const docs: DocFile[] = await Promise.all(\n    files.map(async (filePath) => {\n      const fullPath = join(rootDir, filePath);\n      const content = await readFile(fullPath, \"utf-8\");\n      return {\n        slug: createSlug(filePath),\n        path: filePath,\n        title: extractTitle(content, filePath),\n        content,\n      };\n    })\n  );\n\n  const repoName = basename(rootDir);\n\n  return {\n    repoName,\n    generatedAt: new Date().toISOString(),\n    totalDocs: docs.length,\n    docs,\n  };\n}\n","import { cp, writeFile, rm, mkdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { tmpdir } from \"node:os\";\nimport { execSync } from \"node:child_process\";\nimport { randomBytes } from \"node:crypto\";\nimport type { Manifest } from \"../../app/src/types/manifest.js\";\nimport { getTemplatePath } from \"./template.js\";\n\ninterface BuildOptions {\n  output: string;\n  basePath: string;\n}\n\nexport async function buildApp(\n  manifest: Manifest,\n  options: BuildOptions\n): Promise<void> {\n  const templateDir = getTemplatePath();\n  const tempDir = join(\n    tmpdir(),\n    `doxla-build-${randomBytes(6).toString(\"hex\")}`\n  );\n\n  try {\n    // Copy template to temp dir\n    await cp(templateDir, tempDir, { recursive: true });\n\n    // Write manifest.json into the app's src directory\n    await writeFile(\n      join(tempDir, \"src\", \"manifest.json\"),\n      JSON.stringify(manifest, null, 2),\n      \"utf-8\"\n    );\n\n    // Write .env with base path\n    const envContent = `VITE_BASE_PATH=${options.basePath}\\n`;\n    await writeFile(join(tempDir, \".env\"), envContent, \"utf-8\");\n\n    // Install dependencies\n    execSync(\"npm install --no-audit --no-fund\", {\n      cwd: tempDir,\n      stdio: \"pipe\",\n    });\n\n    // Build with Vite\n    execSync(\"npx vite build\", {\n      cwd: tempDir,\n      stdio: \"pipe\",\n    });\n\n    // Copy output\n    await rm(options.output, { recursive: true, force: true });\n    await mkdir(options.output, { recursive: true });\n    await cp(join(tempDir, \"dist\"), options.output, { recursive: true });\n  } finally {\n    // Clean up temp dir\n    await rm(tempDir, { recursive: true, force: true }).catch(() => {});\n  }\n}\n","import { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"node:path\";\nimport { existsSync } from \"node:fs\";\n\nexport function getTemplatePath(): string {\n  const __filename = fileURLToPath(import.meta.url);\n  let dir = dirname(__filename);\n\n  // Walk up from the current file location until we find src/app\n  // Works both from source (src/cli/lib/) and built (dist/cli/)\n  for (let i = 0; i < 5; i++) {\n    const candidate = resolve(dir, \"src\", \"app\");\n    if (existsSync(resolve(candidate, \"package.json\"))) {\n      return candidate;\n    }\n    dir = dirname(dir);\n  }\n\n  // Fallback: assume built location dist/cli/ -> ../../src/app\n  const fallback = resolve(dirname(__filename), \"..\", \"..\", \"src\", \"app\");\n  return fallback;\n}\n"],"mappings":"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","names":["resolve","chalk","join","writeFile","mkdir","join","dirname","existsSync","join","writeFile","mkdir","resolve","chalk"]}
+{"version":3,"sources":["../../src/cli/index.ts","../../src/cli/commands/init.ts","../../src/cli/templates/doxla-workflow.ts","../../src/cli/commands/build.ts","../../src/cli/lib/discover.ts","../../src/cli/lib/manifest.ts","../../src/cli/lib/build-app.ts","../../src/cli/lib/template.ts"],"sourcesContent":["import { Command } from \"commander\";\nimport { initCommand } from \"./commands/init.js\";\nimport { buildCommand } from \"./commands/build.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"doxla\")\n  .description(\"Improve documentation discoverability within repos\")\n  .version(\"0.1.0\");\n\nprogram\n  .command(\"init\")\n  .description(\"Set up GitHub Actions workflow for Doxla docs deployment\")\n  .action(initCommand);\n\nprogram\n  .command(\"build\")\n  .description(\"Discover markdown files and build the docs viewer\")\n  .option(\"-o, --output <dir>\", \"Output directory\", \"doxla-dist\")\n  .option(\"-r, --root <dir>\", \"Root directory to scan for markdown files\", \".\")\n  .option(\"--base-path <path>\", \"Base path for GitHub Pages deployment\", \"/\")\n  .action(buildCommand);\n\nprogram.parse();\n","import { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport chalk from \"chalk\";\nimport { workflowTemplate } from \"../templates/doxla-workflow.js\";\n\nexport async function initCommand() {\n  const workflowDir = join(process.cwd(), \".github\", \"workflows\");\n  const workflowPath = join(workflowDir, \"doxla.yml\");\n\n  if (existsSync(workflowPath)) {\n    console.log(\n      chalk.yellow(\"⚠ Workflow file already exists at .github/workflows/doxla.yml\")\n    );\n    console.log(chalk.yellow(\"  Overwriting with latest template...\"));\n  }\n\n  await mkdir(workflowDir, { recursive: true });\n  await writeFile(workflowPath, workflowTemplate, \"utf-8\");\n\n  console.log(chalk.green(\"✓ Created .github/workflows/doxla.yml\"));\n  console.log();\n  console.log(\"Next steps:\");\n  console.log(\n    `  1. Enable GitHub Pages in your repo settings (Settings → Pages → Source: ${chalk.bold(\"GitHub Actions\")})`\n  );\n  console.log(\"  2. Commit and push the workflow file\");\n  console.log(\n    \"  3. Your docs will be built and deployed on every push to main\"\n  );\n}\n","export const workflowTemplate = `name: Deploy Doxla Docs\n\non:\n  push:\n    branches: [main]\n  workflow_dispatch:\n\npermissions:\n  contents: read\n  pages: write\n  id-token: write\n\nconcurrency:\n  group: \"pages\"\n  cancel-in-progress: false\n\njobs:\n  build-and-deploy:\n    runs-on: ubuntu-latest\n    environment:\n      name: github-pages\n      url: \\${{ steps.deployment.outputs.page_url }}\n    steps:\n      - uses: actions/checkout@v4\n      - uses: actions/setup-node@v4\n        with:\n          node-version: \"20\"\n      - run: npx doxla@latest build --base-path \"/\\${{ github.event.repository.name }}\"\n      - uses: actions/upload-pages-artifact@v3\n        with:\n          path: ./doxla-dist\n      - id: deployment\n        uses: actions/deploy-pages@v4\n`;\n","import { resolve } from \"node:path\";\nimport chalk from \"chalk\";\nimport ora from \"ora\";\nimport { discoverMarkdownFiles } from \"../lib/discover.js\";\nimport { generateManifest } from \"../lib/manifest.js\";\nimport { buildApp } from \"../lib/build-app.js\";\n\ninterface BuildOptions {\n  output: string;\n  root: string;\n  basePath: string;\n}\n\nexport async function buildCommand(options: BuildOptions) {\n  const rootDir = resolve(options.root);\n  const outputDir = resolve(options.output);\n  const basePath = options.basePath;\n\n  console.log(chalk.bold(\"doxla build\"));\n  console.log();\n\n  // Step 1: Discover markdown files\n  const discoverSpinner = ora(\"Discovering markdown files...\").start();\n  const files = await discoverMarkdownFiles(rootDir);\n\n  if (files.length === 0) {\n    discoverSpinner.fail(\"No markdown files found\");\n    process.exit(1);\n  }\n\n  discoverSpinner.succeed(`Found ${files.length} markdown file${files.length === 1 ? \"\" : \"s\"}`);\n\n  // Step 2: Generate manifest\n  const manifestSpinner = ora(\"Generating manifest...\").start();\n  const manifest = await generateManifest(rootDir, files);\n  manifestSpinner.succeed(\"Manifest generated\");\n\n  // Step 3: Build docs viewer\n  const buildSpinner = ora(\"Building docs viewer...\").start();\n  try {\n    await buildApp(manifest, { output: outputDir, basePath });\n    buildSpinner.succeed(\"Docs viewer built\");\n  } catch (error) {\n    buildSpinner.fail(\"Build failed\");\n    console.error(chalk.red((error as Error).message));\n    process.exit(1);\n  }\n\n  console.log();\n  console.log(chalk.green(`✓ Output written to ${options.output}/`));\n}\n","import fg from \"fast-glob\";\n\nconst IGNORE_PATTERNS = [\n  \"**/node_modules/**\",\n  \"**/.git/**\",\n  \"**/dist/**\",\n  \"**/build/**\",\n  \"**/doxla-dist/**\",\n  \"**/.next/**\",\n  \"**/coverage/**\",\n];\n\nexport async function discoverMarkdownFiles(rootDir: string): Promise<string[]> {\n  const files = await fg(\"**/*.md\", {\n    cwd: rootDir,\n    ignore: IGNORE_PATTERNS,\n    onlyFiles: true,\n  });\n\n  // Sort: README.md first, then alphabetical\n  return files.sort((a, b) => {\n    const aIsReadme = a.toLowerCase() === \"readme.md\";\n    const bIsReadme = b.toLowerCase() === \"readme.md\";\n    if (aIsReadme && !bIsReadme) return -1;\n    if (!aIsReadme && bIsReadme) return 1;\n    return a.localeCompare(b);\n  });\n}\n","import { readFile } from \"node:fs/promises\";\nimport { join, basename, dirname } from \"node:path\";\nimport type { Manifest, DocFile } from \"../../app/src/types/manifest.js\";\n\nfunction extractTitle(content: string, filePath: string): string {\n  // Try to extract from first # heading\n  const match = content.match(/^#\\s+(.+)$/m);\n  if (match) {\n    return match[1].trim();\n  }\n\n  // Fallback to filename without extension\n  const name = basename(filePath, \".md\");\n  if (name.toLowerCase() === \"readme\") {\n    const dir = dirname(filePath);\n    if (dir === \".\") return \"README\";\n    return `${dir} - README`;\n  }\n  return name.replace(/[-_]/g, \" \").replace(/\\b\\w/g, (c) => c.toUpperCase());\n}\n\nfunction createSlug(filePath: string): string {\n  return filePath\n    .replace(/\\.md$/i, \"\")\n    .replace(/\\\\/g, \"/\")\n    .toLowerCase()\n    .replace(/[^a-z0-9/.-]/g, \"-\");\n}\n\nexport async function generateManifest(\n  rootDir: string,\n  files: string[]\n): Promise<Manifest> {\n  const docs: DocFile[] = await Promise.all(\n    files.map(async (filePath) => {\n      const fullPath = join(rootDir, filePath);\n      const content = await readFile(fullPath, \"utf-8\");\n      return {\n        slug: createSlug(filePath),\n        path: filePath,\n        title: extractTitle(content, filePath),\n        content,\n      };\n    })\n  );\n\n  const repoName = basename(rootDir);\n\n  return {\n    repoName,\n    generatedAt: new Date().toISOString(),\n    totalDocs: docs.length,\n    docs,\n  };\n}\n","import { cp, writeFile, rm, mkdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { tmpdir } from \"node:os\";\nimport { execSync } from \"node:child_process\";\nimport { randomBytes } from \"node:crypto\";\nimport type { Manifest } from \"../../app/src/types/manifest.js\";\nimport { getTemplatePath } from \"./template.js\";\n\ninterface BuildOptions {\n  output: string;\n  basePath: string;\n}\n\nexport async function buildApp(\n  manifest: Manifest,\n  options: BuildOptions\n): Promise<void> {\n  const templateDir = getTemplatePath();\n  const tempDir = join(\n    tmpdir(),\n    `doxla-build-${randomBytes(6).toString(\"hex\")}`\n  );\n\n  try {\n    // Copy template to temp dir\n    await cp(templateDir, tempDir, { recursive: true });\n\n    // Write manifest.json into the app's src directory\n    await writeFile(\n      join(tempDir, \"src\", \"manifest.json\"),\n      JSON.stringify(manifest, null, 2),\n      \"utf-8\"\n    );\n\n    // Install dependencies\n    execSync(\"npm install --no-audit --no-fund\", {\n      cwd: tempDir,\n      stdio: \"pipe\",\n    });\n\n    // Build with Vite, passing base path as env var\n    execSync(\"npx vite build\", {\n      cwd: tempDir,\n      stdio: \"pipe\",\n      env: { ...process.env, VITE_BASE_PATH: options.basePath },\n    });\n\n    // Copy output\n    await rm(options.output, { recursive: true, force: true });\n    await mkdir(options.output, { recursive: true });\n    await cp(join(tempDir, \"dist\"), options.output, { recursive: true });\n  } finally {\n    // Clean up temp dir\n    await rm(tempDir, { recursive: true, force: true }).catch(() => {});\n  }\n}\n","import { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"node:path\";\nimport { existsSync } from \"node:fs\";\n\nexport function getTemplatePath(): string {\n  const __filename = fileURLToPath(import.meta.url);\n  let dir = dirname(__filename);\n\n  // Walk up from the current file location until we find src/app\n  // Works both from source (src/cli/lib/) and built (dist/cli/)\n  for (let i = 0; i < 5; i++) {\n    const candidate = resolve(dir, \"src\", \"app\");\n    if (existsSync(resolve(candidate, \"package.json\"))) {\n      return candidate;\n    }\n    dir = dirname(dir);\n  }\n\n  // Fallback: assume built location dist/cli/ -> ../../src/app\n  const fallback = resolve(dirname(__filename), \"..\", \"..\", \"src\", \"app\");\n  return fallback;\n}\n"],"mappings":"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","names":["resolve","chalk","join","writeFile","mkdir","join","dirname","existsSync","join","writeFile","mkdir","resolve","chalk"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doxla",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Improve documentation discoverability within repos",
   "type": "module",
   "bin": {

package/src/app/src/App.tsx

@@ -6,6 +6,18 @@ import { IndexPage } from "./components/IndexPage";
 import { DocPage } from "./components/DocPage";
 import { SearchResults } from "./components/SearchResults";
 
+export type Theme = "light" | "dark";
+
+const STORAGE_KEY = "doxla-theme";
+
+function getInitialTheme(): Theme {
+  const stored = localStorage.getItem(STORAGE_KEY);
+  if (stored === "light" || stored === "dark") return stored;
+  return window.matchMedia("(prefers-color-scheme: dark)").matches
+    ? "dark"
+    : "light";
+}
+
 const data = manifest as Manifest;
 
 type Route =
@@ -34,6 +46,20 @@ function parseHash(): Route {
 
 export default function App() {
   const [route, setRoute] = useState<Route>(parseHash);
+  const [theme, setTheme] = useState<Theme>(getInitialTheme);
+
+  const toggleTheme = useCallback(() => {
+    setTheme((prev) => {
+      const next = prev === "light" ? "dark" : "light";
+      localStorage.setItem(STORAGE_KEY, next);
+      document.documentElement.setAttribute("data-theme", next);
+      return next;
+    });
+  }, []);
+
+  useEffect(() => {
+    document.documentElement.setAttribute("data-theme", theme);
+  }, [theme]);
 
   const handleHashChange = useCallback(() => {
     setRoute(parseHash());
@@ -63,7 +89,7 @@ export default function App() {
             </div>
           );
         }
-        return <DocPage doc={doc} />;
+        return <DocPage doc={doc} theme={theme} />;
       }
       case "search":
         return <SearchResults docs={data.docs} query={route.query} />;
@@ -71,6 +97,8 @@ export default function App() {
   };
 
   return (
-    <Layout manifest={data}>{renderContent()}</Layout>
+    <Layout manifest={data} theme={theme} onToggleTheme={toggleTheme}>
+      {renderContent()}
+    </Layout>
   );
 }

package/src/app/src/components/DocPage.tsx

@@ -1,13 +1,15 @@
 import type { DocFile } from "../types/manifest";
+import type { Theme } from "../App";
 import { MarkdownRenderer } from "./MarkdownRenderer";
 import { Badge } from "./ui/Badge";
 import { Separator } from "./ui/Separator";
 
 interface DocPageProps {
   doc: DocFile;
+  theme: Theme;
 }
 
-export function DocPage({ doc }: DocPageProps) {
+export function DocPage({ doc, theme }: DocPageProps) {
   const pathParts = doc.path.split("/");
 
   return (
@@ -35,7 +37,7 @@ export function DocPage({ doc }: DocPageProps) {
 
       <Separator className="mb-6" />
 
-      <MarkdownRenderer content={doc.content} />
+      <MarkdownRenderer content={doc.content} theme={theme} />
     </div>
   );
 }

package/src/app/src/components/MarkdownRenderer.tsx

@@ -1,44 +1,52 @@
+import { useMemo } from "react";
 import Markdown from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { Prism as SyntaxHighlighter } from "react-syntax-highlighter";
-import { oneLight } from "react-syntax-highlighter/dist/esm/styles/prism";
+import { oneLight, oneDark } from "react-syntax-highlighter/dist/esm/styles/prism";
 import type { Components } from "react-markdown";
+import type { Theme } from "../App";
 
 interface MarkdownRendererProps {
   content: string;
+  theme: Theme;
 }
 
-const components: Components = {
-  code(props) {
-    const { children, className, ...rest } = props;
-    const match = /language-(\w+)/.exec(className || "");
-    const isInline = !match;
+export function MarkdownRenderer({ content, theme }: MarkdownRendererProps) {
+  const syntaxStyle = theme === "dark" ? oneDark : oneLight;
 
-    if (isInline) {
-      return (
-        <code
-          className="rounded bg-muted px-1.5 py-0.5 text-sm font-mono"
-          {...rest}
-        >
-          {children}
-        </code>
-      );
-    }
+  const components: Components = useMemo(
+    () => ({
+      code(props) {
+        const { children, className, ...rest } = props;
+        const match = /language-(\w+)/.exec(className || "");
+        const isInline = !match;
 
-    return (
-      <SyntaxHighlighter
-        style={oneLight}
-        language={match[1]}
-        PreTag="div"
-        className="rounded-md text-sm"
-      >
-        {String(children).replace(/\n$/, "")}
-      </SyntaxHighlighter>
-    );
-  },
-};
+        if (isInline) {
+          return (
+            <code
+              className="rounded bg-muted px-1.5 py-0.5 text-sm font-mono"
+              {...rest}
+            >
+              {children}
+            </code>
+          );
+        }
+
+        return (
+          <SyntaxHighlighter
+            style={syntaxStyle}
+            language={match[1]}
+            PreTag="div"
+            className="rounded-md text-sm"
+          >
+            {String(children).replace(/\n$/, "")}
+          </SyntaxHighlighter>
+        );
+      },
+    }),
+    [syntaxStyle],
+  );
 
-export function MarkdownRenderer({ content }: MarkdownRendererProps) {
   return (
     <div className="prose prose-neutral max-w-none">
       <Markdown remarkPlugins={[remarkGfm]} components={components}>

package/src/app/src/components/layout/Header.tsx

@@ -1,13 +1,16 @@
 import { useState } from "react";
-import { Search, BookOpen } from "lucide-react";
+import { Search, BookOpen, Sun, Moon } from "lucide-react";
+import type { Theme } from "../../App";
 import { Input } from "../ui/Input";
 import { Button } from "../ui/Button";
 
 interface HeaderProps {
   repoName: string;
+  theme: Theme;
+  onToggleTheme: () => void;
 }
 
-export function Header({ repoName }: HeaderProps) {
+export function Header({ repoName, theme, onToggleTheme }: HeaderProps) {
   const [searchInput, setSearchInput] = useState("");
 
   const handleSearch = (e: React.FormEvent) => {
@@ -39,6 +42,15 @@ export function Header({ repoName }: HeaderProps) {
           Search
         </Button>
       </form>
+
+      <Button
+        size="sm"
+        variant="ghost"
+        onClick={onToggleTheme}
+        aria-label={theme === "dark" ? "Switch to light mode" : "Switch to dark mode"}
+      >
+        {theme === "dark" ? <Sun className="h-4 w-4" /> : <Moon className="h-4 w-4" />}
+      </Button>
     </header>
   );
 }

package/src/app/src/components/layout/Layout.tsx

@@ -1,17 +1,20 @@
 import type { ReactNode } from "react";
 import type { Manifest } from "../../types/manifest";
+import type { Theme } from "../../App";
 import { Header } from "./Header";
 import { Sidebar } from "./Sidebar";
 
 interface LayoutProps {
   manifest: Manifest;
+  theme: Theme;
+  onToggleTheme: () => void;
   children: ReactNode;
 }
 
-export function Layout({ manifest, children }: LayoutProps) {
+export function Layout({ manifest, theme, onToggleTheme, children }: LayoutProps) {
   return (
     <div className="min-h-screen">
-      <Header repoName={manifest.repoName} />
+      <Header repoName={manifest.repoName} theme={theme} onToggleTheme={onToggleTheme} />
       <div className="flex">
         <Sidebar docs={manifest.docs} />
         <main className="flex-1 overflow-auto">

package/src/app/src/globals.css

@@ -16,6 +16,19 @@
   --radius-lg: 0.5rem;
 }
 
+[data-theme="dark"] {
+  color-scheme: dark;
+  --color-background: #0a0a0a;
+  --color-foreground: #fafafa;
+  --color-muted: #262626;
+  --color-muted-foreground: #a3a3a3;
+  --color-border: #2e2e2e;
+  --color-primary: #fafafa;
+  --color-primary-foreground: #171717;
+  --color-accent: #262626;
+  --color-accent-foreground: #fafafa;
+}
+
 body {
   font-family:
     -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue",