diff --git a/.gitignore b/.gitignore index 1f42216f..f4189aef 100644 --- a/.gitignore +++ b/.gitignore @@ -6,11 +6,7 @@ dist/ .nuxt/ # Written by the Nitro `vercel` preset and by the Vercel CLI's own local link file. .vercel/ -/.vitepress/ -!.vitepress/config.ts .maizzle/ -**/.vitepress/cache/ -**/.vitepress/.temp/ .vitehub/ *.tsbuildinfo coverage/ diff --git a/AGENTS.md b/AGENTS.md index 5958f4e6..b5a33987 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -48,7 +48,7 @@ Agent Zero is an open-source autonomous engineer that finds, fixes, and verifies | `packages/i18n` | `@agent-zero/i18n` | Locale messages and i18n tooling | | `packages/mail` | `@agent-zero/mail` | Transactional mail templates | | `apps/dashboard` | `@agent-zero/dashboard` | The single deployable app and composition root | -| `apps/docs` | `@agent-zero/docs` | VitePress documentation site (not deployed with the dashboard) | +| `apps/docs` | `@agent-zero/docs` | Docus documentation site (not deployed with the dashboard) | | `apps/marketing` | `@agent-zero/marketing` | Frontend-only public marketing site | | `apps/mail-preview` | `@agent-zero/mail-preview` | Dev-only Maizzle preview server for `packages/mail` | @@ -134,7 +134,7 @@ Use the smallest relevant check while iterating, then run the complete set befor - `packages/database`: the schema, the Drizzle client, and the checked-in migrations. The only package that talks to Postgres. No policy, no HTTP, no runtime imports. - `packages/auth`: authentication policy and the Better Auth options factory. Reads the store through `packages/database`. No HTTP server, no runtime imports. - `packages/api`: the oRPC router and control-plane operations. The only package that composes the runtime, source-control, models, and config adapters into one API surface. Holds no HTTP host of its own. -- `apps/docs`: the VitePress documentation site. Not deployed with the dashboard. The canonical architecture and provider references remain in `docs/*.md` (the site includes them verbatim); edit those files, not copies. +- `apps/docs`: the Docus documentation site. Not deployed with the dashboard. The canonical architecture and provider references remain in `docs/*.md` (the site includes them verbatim); edit those files, not copies. - `apps/mail-preview`: dev-only Maizzle preview server for `packages/mail` templates. Not deployed; nothing may import it. - `apps/dashboard`: the single deployable app and composition root. A Nuxt app whose `server/` directory hosts `packages/api`'s router over `/rpc/**` (typed RPC) and `/api/v1/**` (OpenAPI/REST, with docs at `/api/v1/docs`), and mounts Better Auth in-process at `/api/auth/**` via `server/auth.config.ts`. The only process that opens the database, and it does so through `packages/database`. - `apps/marketing`: frontend-only Nuxt public marketing site. No persistence, no credentials, no session, no runtime-package imports; nothing imports it. Server-rendered and prerendered because it must be crawlable, so the only Nitro routes are the ones `@nuxtjs/seo` generates. Copy lives in `packages/i18n` (`locales//marketing.json`), never in the app. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 315b2452..789a78d1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -51,7 +51,7 @@ Read [AGENTS.md](AGENTS.md) and the matching files in `.agents/skills/` before m If an AI agent helps you write a change, read [AI_POLICY.md](AI_POLICY.md) first: you still own the diff, you still run the checks, and you disclose the agent in the pull request. -Documentation lives in `apps/docs`, a VitePress site (`aube run dev --filter=@agent-zero/docs` to preview it). The canonical architecture and provider references stay in `docs/*.md` and are included by the site — edit those files rather than duplicating their content into site pages. +Documentation lives in `apps/docs`, a [Docus](https://docus.dev) site (`aube run dev --filter=@agent-zero/docs` to preview it). The canonical architecture and provider references stay in `docs/*.md` and are included by the site — edit those files rather than duplicating their content into site pages. ## Development workflow diff --git a/README.md b/README.md index 99ede99b..1e21d594 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,7 @@ ## Documentation -The full documentation — getting started, architecture, configuration, API, authentication, and deployment — lives in [`apps/docs`](./apps/docs), a VitePress site. Run it locally with `aube run dev --filter=@agent-zero/docs`. The canonical architecture and provider references stay in [`docs/`](./docs) and are included by the site, so both always read the same source. +The full documentation — getting started, architecture, configuration, API, authentication, and deployment — lives in [`apps/docs`](./apps/docs), a [Docus](https://docus.dev) site. Run it locally with `aube run dev --filter=@agent-zero/docs`. The canonical architecture and provider references stay in [`docs/`](./docs) and are included by the site, so both always read the same source. --- @@ -101,7 +101,7 @@ aube run dev ``` The root `.env` configures the CLI. Each app loads its own file: the dashboard uses -`apps/dashboard/.env`, while the docs app optionally uses `apps/docs/.env` for `DOCS_BASE`. +`apps/dashboard/.env`, while the docs app optionally uses `apps/docs/.env` for `NUXT_APP_BASE_URL`. `aube run