feat: generate docs from cli

apps/engineering/README.md

@@ -13,14 +13,14 @@ pnpm dev
 yarn dev
 ```
 
-Open http://localhost:3000 with your browser to see the result.
+Open <http://localhost:3000> with your browser to see the result.
 
 ## Learn More
 
 To learn more about Next.js and Fumadocs, take a look at the following
 resources:
 
-- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js.
   features and API.
 - [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
 - [Fumadocs](https://fumadocs.vercel.app) - learn about Fumadocs

apps/engineering/app/docs/[[...slug]]/page.tsx

@@ -1,8 +1,9 @@
 import { source } from "@/app/source";
+import { Banner } from "fumadocs-ui/components/banner";
+import { Tab, Tabs } from "fumadocs-ui/components/tabs";
 import defaultMdxComponents from "fumadocs-ui/mdx";
 import { DocsBody, DocsDescription, DocsPage, DocsTitle } from "fumadocs-ui/page";
 import type { Metadata } from "next";
-
 import { notFound } from "next/navigation";
 
 export default async function Page(props: {
@@ -32,7 +33,14 @@ export default async function Page(props: {
       <DocsDescription>{page.data.description}</DocsDescription>
 
       <DocsBody>
-        <MDX components={{ ...defaultMdxComponents }} />
+        <MDX
+          components={{
+            ...defaultMdxComponents,
+            Tabs,
+            Tab,
+            Banner,
+          }}
+        />
       </DocsBody>
     </DocsPage>
   );

apps/engineering/content/docs/architecture/meta.json

@@ -3,5 +3,5 @@
   "description": "How does Unkey work",
   "icon": "Pencil",
   "root": false,
-  "pages": ["index", "---Services---"]
+  "pages": ["index", "services"]
 }

apps/engineering/content/docs/architecture/services/meta.json

@@ -2,5 +2,15 @@
   "title": "Services",
   "icon": "Pencil",
   "root": false,
-  "pages": ["vault", "clickhouse", "clickhouse-proxy"]
+  "pages": [
+    "api",
+    "clickhouse",
+    "clickhouse-proxy",
+    "deploy",
+    "healthcheck",
+    "quotacheck",
+    "run",
+    "vault",
+    "version"
+  ]
 }

apps/engineering/content/docs/cli/deploy/index.mdx

@@ -0,0 +1,191 @@
+---
+title: "Deploy"
+description: "Deploy a new version or initialize configuration"
+---
+Build and deploy a new version of your application, or initialize configuration.
+
+The deploy command handles the complete deployment lifecycle: from building Docker images to deploying them on Unkey's infrastructure. It automatically detects your Git context, builds containers, and manages the deployment process with real-time status updates.
+
+## Initialization Mode
+
+Use --init to create a configuration template file. This generates an unkey.json file with your project settings, making future deployments simpler and more consistent across environments.
+
+## Deployment Process
+
+1. Load configuration from unkey.json or flags
+2. Build Docker image from your application  
+3. Push image to container registry
+4. Create deployment version on Unkey platform
+5. Monitor deployment status until active
+
+## Command Syntax
+
+```bash
+unkey deploy [flags]
+```
+
+## Examples
+
+### Initialize new project configuration
+
+```bash
+unkey deploy --init
+```
+
+### Initialize with custom location
+
+```bash
+unkey deploy --init --config=./my-project
+```
+
+### Force overwrite existing configuration
+
+```bash
+unkey deploy --init --force
+```
+
+### Standard deployment (uses ./unkey.json)
+
+```bash
+unkey deploy
+```
+
+### Deploy from specific config directory
+
+```bash
+unkey deploy --config=./production
+```
+
+### Override workspace from config file
+
+```bash
+unkey deploy --workspace-id=ws_production_123
+```
+
+### Deploy with custom build context
+
+```bash
+unkey deploy --context=./api
+```
+
+### Local development (build only, no push)
+
+```bash
+unkey deploy --skip-push
+```
+
+### Deploy pre-built image
+
+```bash
+unkey deploy --docker-image=ghcr.io/user/app:v1.0.0
+```
+
+### Verbose output for debugging
+
+```bash
+unkey deploy --verbose
+```
+
+## Flags
+
+<Callout type="info" title="--config">
+Directory containing unkey.json config file
+
+- **Type:** string
+</Callout>
+
+<Callout type="info" title="--init">
+Initialize configuration file in the specified directory
+
+- **Type:** boolean
+- **Default:** `false`
+</Callout>
+
+<Callout type="info" title="--force">
+Force overwrite existing configuration file when using --init
+
+- **Type:** boolean
+- **Default:** `false`
+</Callout>
+
+<Callout type="info" title="--workspace-id">
+Workspace ID
+
+- **Type:** string
+- **Environment:** `UNKEY_WORKSPACE_ID`
+</Callout>
+
+<Callout type="info" title="--project-id">
+Project ID
+
+- **Type:** string
+- **Environment:** `UNKEY_PROJECT_ID`
+</Callout>
+
+<Callout type="info" title="--context">
+Build context path
+
+- **Type:** string
+</Callout>
+
+<Callout type="info" title="--branch">
+Git branch
+
+- **Type:** string
+- **Default:** `"main"`
+</Callout>
+
+<Callout type="info" title="--docker-image">
+Pre-built docker image
+
+- **Type:** string
+</Callout>
+
+<Callout type="info" title="--dockerfile">
+Path to Dockerfile
+
+- **Type:** string
+- **Default:** `"Dockerfile"`
+</Callout>
+
+<Callout type="info" title="--commit">
+Git commit SHA
+
+- **Type:** string
+</Callout>
+
+<Callout type="info" title="--registry">
+Container registry
+
+- **Type:** string
+- **Default:** `"ghcr.io/unkeyed/deploy"`
+- **Environment:** `UNKEY_REGISTRY`
+</Callout>
+
+<Callout type="info" title="--skip-push">
+Skip pushing to registry (for local testing)
+
+- **Type:** boolean
+- **Default:** `false`
+</Callout>
+
+<Callout type="info" title="--verbose">
+Show detailed output for build and deployment operations
+
+- **Type:** boolean
+- **Default:** `false`
+</Callout>
+
+<Callout type="info" title="--control-plane-url">
+Control plane URL
+
+- **Type:** string
+- **Default:** `"http://localhost:7091"`
+</Callout>
+
+<Callout type="info" title="--auth-token">
+Control plane auth token
+
+- **Type:** string
+- **Default:** `"ctrl-secret-token"`
+</Callout>

apps/engineering/content/docs/cli/healthcheck/index.mdx

@@ -0,0 +1,35 @@
+---
+title: "Healthcheck"
+description: "Perform an HTTP healthcheck against a given URL"
+---
+This command sends an HTTP GET request to the specified URL and validates the response. It exits with code 0 if the server returns a 200 status code, otherwise exits with code 1.
+
+## Use Cases
+
+This is useful for health monitoring in CI/CD pipelines, service availability checks, load balancer health probes, and infrastructure monitoring scripts.
+
+## Command Syntax
+
+```bash
+unkey healthcheck
+```
+
+## Examples
+
+### Check if a service is healthy
+
+```bash
+unkey healthcheck https://api.unkey.dev/health
+```
+
+### Check local service
+
+```bash
+unkey healthcheck http://localhost:8080/health
+```
+
+### Use in monitoring script
+
+```bash
+unkey healthcheck https://example.com/api/status || echo 'Service is down!'
+```

apps/engineering/content/docs/cli/index.mdx

@@ -0,0 +1,4 @@
+---
+title: "CLI"
+description: "Single binary for everything"
+---

apps/engineering/content/docs/cli/meta.json

@@ -0,0 +1,6 @@
+{
+  "title": "CLI",
+  "icon": "Pencil",
+  "root": false,
+  "pages": ["deploy", "healthcheck", "quotacheck", "run", "version"]
+}

apps/engineering/content/docs/cli/quotacheck/index.mdx

@@ -0,0 +1,64 @@
+---
+title: "Quotacheck"
+description: "Check for exceeded quotas"
+---
+Check for exceeded quotas and optionally send Slack notifications.
+
+This command monitors quota usage by querying ClickHouse for current usage metrics and comparing them against configured limits in the primary database. When quotas are exceeded, it can automatically send notifications via Slack webhook.
+
+## Configuration
+
+The command requires ClickHouse and database connections to function. Slack notifications are optional but recommended for production monitoring.
+
+## Command Syntax
+
+```bash
+unkey quotacheck [flags]
+```
+
+## Examples
+
+### Check quotas without notifications
+
+```bash
+unkey quotacheck --clickhouse-url clickhouse://localhost:9000 --database-dsn postgres://user:pass@localhost/db
+```
+
+### Check quotas with Slack notifications
+
+```bash
+unkey quotacheck --clickhouse-url clickhouse://localhost:9000 --database-dsn postgres://user:pass@localhost/db --slack-webhook-url https://hooks.slack.com/services/...
+```
+
+### Using environment variables
+
+```bash
+CLICKHOUSE_URL=... DATABASE_DSN=... SLACK_WEBHOOK_URL=... unkey quotacheck
+```
+
+<Banner type="warn">
+Some flags are required for this command to work properly.
+</Banner>
+
+## Flags
+
+<Callout type="info" title="--clickhouse-url (required)">
+URL for the ClickHouse database
+
+- **Type:** string
+- **Environment:** `CLICKHOUSE_URL`
+</Callout>
+
+<Callout type="info" title="--database-dsn (required)">
+DSN for the primary database
+
+- **Type:** string
+- **Environment:** `DATABASE_DSN`
+</Callout>
+
+<Callout type="info" title="--slack-webhook-url">
+Slack webhook URL to send notifications
+
+- **Type:** string
+- **Environment:** `SLACK_WEBHOOK_URL`
+</Callout>