docs: add Privacy Policy and Terms of Service legal pages

.dockerignore

@@ -0,0 +1,10 @@
+**/node_modules
+**/.next
+**/.turbo
+**/.cache
+**/dist
+**/build
+**/.DS_Store
+**/*.log
+**/.env*
+.git

.github/ISSUE_TEMPLATE/1-bug_report.yml

@@ -0,0 +1,106 @@
+name: Bug report
+description: Something is broken on docs.page, in the CLI, or in local preview
+title: "[Bug]: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug. Search [existing issues](https://github.com/invertase/docs.page/issues?q=is%3Aissue+is%3Aopen) first.
+
+        **Not sure where to start?** Use [Discussions](https://github.com/invertase/docs.page/discussions) for questions and ideas.
+
+        If this is about **your own published docs site**, include the docs.page URL and the GitHub repo below.
+
+  - type: dropdown
+    id: surface
+    attributes:
+      label: Where does this happen?
+      options:
+        - Hosted docs site (a URL on docs.page)
+        - CLI local preview (`docs.page preview`)
+        - Both hosted and preview
+        - Not sure
+    validations:
+      required: true
+
+  - type: input
+    id: docs_url
+    attributes:
+      label: docs.page URL
+      description: The page where you see the problem, if applicable.
+      placeholder: https://invertase.docs.page/configuration
+
+  - type: input
+    id: repo
+    attributes:
+      label: GitHub repository
+      description: The repo whose docs you are viewing, if applicable.
+      placeholder: invertase/docs.page
+
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: What you did, what you expected, and what actually happened.
+      placeholder: |
+        When I …
+        I expected …
+        Instead …
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to reproduce
+      description: Minimal steps, commands, or URLs. For CLI issues, include the exact command.
+      placeholder: |
+        1. Run `docs.page preview`
+        2. Open http://localhost:…/page
+        3. See …
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Rendering / navigation / sidebar
+        - Search
+        - Preview mode (hosted PR/branch previews)
+        - CLI (`@docs.page/cli`)
+        - `docs.json` / configuration
+        - MCP / agent features
+        - Product docs (use.docs.page content)
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: CLI version or browser
+      description: e.g. `@docs.page/cli 2.0.0-next.1`, Chrome 124, Safari 17
+      placeholder: "@docs.page/cli …"
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output
+      description: Console errors, CLI output, or stack traces.
+      render: shell
+
+  - type: upload
+    id: screenshots
+    attributes:
+      label: Screenshots or recordings
+      description: If applicable, upload images to help explain the problem.
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Preview URL, commit SHA, or anything else that helps reproduce the issue.

.github/ISSUE_TEMPLATE/2-feature_request.yml

@@ -0,0 +1,67 @@
+name: Feature request
+description: Suggest an improvement to docs.page, the CLI, or the docs experience
+title: "[Feature]: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Describe the problem you want solved. For open-ended questions or roadmap chat, use [Discussions](https://github.com/invertase/docs.page/discussions) instead.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or use case
+      description: What problem does this solve? Who benefits (site owners, readers, maintainers)?
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: How would you like this to work? Mockups, examples, or links to other docs sites are welcome.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches, workarounds, or tools you considered.
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Hosted platform (docs.page)
+        - CLI (`@docs.page/cli`)
+        - `docs.json` / configuration
+        - Search / analytics
+        - Preview mode
+        - MCP / agent / AI features
+        - Product documentation / DX
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: impact
+    attributes:
+      label: How important is this to you?
+      options:
+        - Nice to have
+        - Would improve my workflow
+        - Blocking — I can't use docs.page the way I need
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      options:
+        - label: I am willing to open a PR for this (with maintainer guidance)
+        - label: I can help test a prototype

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Questions, ideas & roadmap
+    url: https://github.com/invertase/docs.page/discussions
+    about: General questions, feedback, and roadmap — start here when you're not sure
+  - name: Configuration help
+    url: https://use.docs.page/configuration
+    about: docs.json options, navigation, themes — start here for setup questions
+  - name: Discord
+    url: https://invertase.link/discord
+    about: Chat with the community

.github/pull_request_template.md

@@ -0,0 +1,33 @@
+Fixes #
+
+## Summary
+
+<!-- What changed and why? -->
+
+## Scope
+
+- [ ] `app/` (hosted site, MCP, Ask AI)
+- [ ] `packages/cli/`
+- [ ] `packages/mdx-bundler/`
+- [ ] `docs/` (product documentation)
+- [ ] Repo / CI / other
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Documentation
+- [ ] Refactor / chore
+
+## Test plan
+
+<!-- Commands run, URLs tested, screenshots. For UI changes, include before/after if helpful. -->
+
+- [ ] `bun run check` passes locally
+- [ ] Tested locally (`bun dev`, CLI command, or other relevant command)
+- [ ] Updated `docs/` (if user-facing)
+- [ ] Verified on a docs.page URL or local preview (if rendering/routing changed)
+
+## Notes for reviewers
+
+<!-- Breaking changes, migration steps, follow-ups, or areas that need extra attention. -->

.github/workflows/publish-cli.yml

@@ -0,0 +1,53 @@
+name: Publish CLI
+
+on:
+  push:
+    tags:
+      - cli-v*
+  workflow_dispatch:
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          registry-url: https://registry.npmjs.org
+
+      - name: Install npm for trusted publishing
+        run: npm install -g npm@11
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Typecheck
+        run: bun run typecheck
+        working-directory: packages/cli
+
+      - name: Verify tag matches package version
+        if: startsWith(github.ref, 'refs/tags/')
+        working-directory: packages/cli
+        run: |
+          TAG="${GITHUB_REF#refs/tags/cli-v}"
+          VERSION=$(node -p "require('./package.json').version")
+          if [ "$TAG" != "$VERSION" ]; then
+            echo "Tag cli-v${TAG} does not match package.json version ${VERSION}"
+            exit 1
+          fi
+
+      - name: Publish to npm
+        working-directory: packages/cli
+        run: npm publish --access public

.github/workflows/pull_request.yaml

@@ -14,4 +14,16 @@ jobs:
         with:
           version: latest
       - name: Run Biome
-        run: biome ci .
+        run: biome ci .
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+      - name: Install dependencies
+        run: bun install
+      - name: Run tests
+        run: bun test

AGENTS.md

@@ -0,0 +1,65 @@
+# docs.page — agent guidance
+
+This file orients coding agents working in the docs.page monorepo. For human
+contributors, see [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## Project overview
+
+docs.page serves markdown documentation from public GitHub repositories as modern,
+agent-ready sites (MCP, `llms.txt`, optional Ask AI). The active codebase is a
+Bun workspace centered on a Next.js app and shared packages.
+
+## Monorepo layout
+
+```
+app/                    Next.js app — rendering, API routes, MCP, agent panel
+packages/cli/           @docs.page/cli — init, check, preview
+packages/mdx-bundler/   Shared markdown → doc IR pipeline
+docs/                   Product documentation (MDX)
+docs.json               Site navigation for this repo's docs
+skills/                 Agent skills (SKILL.md per skill)
+```
+
+
+## Commands
+
+| Task | Command |
+| --- | --- |
+| Install | `bun install` (repo root) |
+| Dev server | `bun dev` or `cd app && bun dev` |
+| Format + lint | `bun run check` (Biome, repo root) |
+| CLI dev | `cd packages/cli && bun run dev` |
+| CLI typecheck | `cd packages/cli && bun run typecheck` |
+
+## Conventions
+
+- **Runtime** — Bun for installs and scripts; Next.js App Router in `app/`.
+- **Lint/format** — Biome (`biome.json`). Run `bun run check` before finishing.
+- **UI** — shadcn/ui components live in `app/src/components/ui/`. Use existing primitives before adding dependencies.
+- **Next.js** — Read `app/AGENTS.md` and `node_modules/next/dist/docs/` for Next.js 16 APIs (breaking vs training data).
+- **Shared markdown pipeline** — Changes to doc rendering belong in `packages/mdx-bundler/` when they affect both app and CLI preview.
+- **Scope** — Minimal diffs; match existing patterns; update `docs/` for user-visible behavior.
+
+## Environment
+
+Local app development against live GitHub content requires `GITHUB_PAT` in
+`app/.env.local`. GitHub App credentials are only needed for webhook work.
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup.
+
+Do not commit secrets, `.env`, or generated artifacts (`.next/`, `dist/`).
+
+## Pull requests
+
+- Link issues when applicable (`Fixes #123`).
+- Follow [CONTRIBUTING.md](./CONTRIBUTING.md) for workflow and [.github/pull_request_template.md](./.github/pull_request_template.md) when opening a PR.
+- Ensure Biome passes (`bun run check`).
+- Prefer focused PRs with a clear description.
+
+## Skills
+
+Repo-wide skills live under [`skills/`](./skills/). Load a skill's `SKILL.md` when one exists for your task.
+
+## Safety
+
+- Do not disable security checks (webhook verification, sanitization, rate limits) without explicit maintainer approval.
+- Treat user-supplied markdown and repository content as untrusted input.