generated jsdoc dashboard docs

This commit is contained in:
Madison 2026-06-04 14:41:16 -05:00
parent c4e6b4a68b
commit 72162b4b07
32 changed files with 454 additions and 105 deletions

View File

@ -21,11 +21,6 @@ Every email - whether it comes from a built-in auth flow, your server code, a dr
You can monitor every email's status in the dashboard under **Emails → Sent**.
## Enabling the Emails app
Like every Hexclave app, Emails has to be enabled before its dashboard tabs show up in your project. Open the **Apps** picker in the dashboard sidebar and toggle on **Emails**.
If a feature in the docs assumes the Emails app is enabled and you don't see the corresponding UI, this is the first thing to check.
## Email types

View File

@ -1,12 +1,18 @@
---
hidden: true
title: "Queries"
description: "Queries in the Analytics app"
description: "Saved ClickHouse queries and SQL editor."
sidebarTitle: "Queries"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Sidebar
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Folder tree of saved queries (`config` analytics query folders). Create/rename/delete folders and queries; drag-free hierarchy with expand/collapse.
## Editor
SQL textarea, **Run** executes against ClickHouse, results in `VirtualizedFlatTable`. States: empty prompt, loading, no rows, error display. **Save** persists SQL into the selected folder; **Save as** creates a new entry.
Row click opens `RowDetailDialog` for JSON inspection. `AnalyticsEventLimitBanner` at top when limits apply.

View File

@ -1,12 +1,22 @@
---
hidden: true
title: "Replays"
description: "Replays in the Analytics app"
description: "Watch rrweb session recordings tied to users and teams."
sidebarTitle: "Replays"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Layout
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Split view: session list (left) + player (right). Standalone `/session-replays/[id]` deep-links one replay with back link.
## Session list
Infinite scroll (`PAGE_SIZE` 50), filters for user, team, duration, last active, click count. Each row shows user, duration, event/chunk counts, relative time.
## Player
rrweb replayer with play/pause, speed, skip inactive, timeline scrubber, multi-tab streams, and event inspector. Settings persist in `localStorage`.
Embedded mode hides chrome when opened from a user profile. `SessionReplayLimitBanner` when replay quota applies.

View File

@ -1,12 +1,18 @@
---
hidden: true
title: "Tables"
description: "Tables in the Analytics app"
description: "Browse ClickHouse analytics tables with optional AI SQL."
sidebarTitle: "Tables"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Sidebar
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Fixed table list (desktop): Events, Users, Contact Channels, Teams, Team Member Profiles, Team Permissions, Team Invitations, Email Outboxes, Project Permissions, Notification Preferences, Refresh Tokens, Connected Accounts. Link to **Queries** for ad-hoc SQL.
## Table view
Per table: `QueryDataGrid` runs the default `SELECT * FROM default.<table>` with pagination, quick search, sort, export, and refresh. **AI query bar** can replace the query with a natural-language-generated ClickHouse statement (one-shot mode disables default sort/search).
`AnalyticsEventLimitBanner` warns when event ingestion limits apply.

View File

@ -1,25 +1,29 @@
---
hidden: true
title: "API Keys"
description: "Configure whether users and teams can create their own API keys."
description: "Configure whether end users and teams may create their own API keys."
sidebarTitle: "API Keys"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
The **API Keys** app controls whether your end users may create API keys scoped to their own account or to teams they belong to.
## Not project keys
## About this page
This page does **not** manage Hexclave **project keys** (publishable client key / secret server key for calling the Hexclave API). Use **Project Settings → Project Keys** for that.
This page is **not** where you manage Hexclave **project keys** (publishable client keys and secret server keys for calling the Stack API). Use **Project Keys** in project settings for that.
## Info alert
The info alert at the top links to the public [API Keys guide](https://docs.hexclave.com/docs/apps/api-keys) for SDK integration details.
Explains the end-user API Keys product and links to the public [API Keys guide](https://docs.hexclave.com/docs/apps/api-keys) for SDK integration (`createApiKey`, validation, UI components).
## API Key Settings
## API Key Settings card
Two toggles sit in a deferred-save grid (edit, then **Save** or **Discard**):
Glassmorphic card with a **deferred-save** editable grid — toggle switches, then **Save** or **Discard** (only changed rows highlight).
- **User API Keys** — sets `apiKeys.enabled.user`. When enabled, users can create API keys for their accounts and the user-api-keys backend routes are available.
- **Team API Keys** — sets `apiKeys.enabled.team`. When enabled, users can create API keys for teams they belong to and the team-api-keys backend routes are available.
| Toggle | Config | Effect |
| --- | --- | --- |
| **User API Keys** | `apiKeys.enabled.user` | Users can create keys for their account; enables user-api-keys routes; shows API Keys tab in `<AccountSettings>` |
| **Team API Keys** | `apiKeys.enabled.team` | Users with `$manage_api_keys` can create team keys; enables team-api-keys routes; shows API Keys section on team settings |
Both can be on at the same time. Turning one off does not delete existing keys; it prevents new key creation through those scopes.
Both can be enabled together. Disabling a toggle does **not** revoke existing keys — it blocks new creation through that scope.
Tooltips on each row summarize backend route and UI behavior.

View File

@ -1,12 +1,39 @@
---
hidden: true
title: "Auth Methods"
description: "Auth Methods in the Authentication app"
description: "Configure sign-in methods, OAuth SSO, sign-up, and account deletion."
sidebarTitle: "Auth Methods"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
Four stacked configuration areas. Most cards use **Save** / **Discard** after local edits.
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
## Sign-in methods + SSO (left card, wide)
**Sign-in methods** toggles (`auth.password.allowSignIn`, `auth.otp.allowSignIn`, `auth.passkey.allowSignIn`):
- Email/password authentication
- Magic link (Email OTP)
- Passkey
**SSO Providers** list — one row per enabled provider (icon, name). **Shared keys** badge (orange) = dev credentials; replace before production. Row **⋮** menu: **Configure** (client ID/secret, callback URL), **Turn off**.
- **Add SSO providers** — searchable dialog **Add New Auth Method**; pick providers to enable/configure
- Empty state alert when none enabled
## Live preview (right card, large screens)
Browser-frame mock of the hosted **sign-in** page reflecting current toggles and enabled providers (non-interactive).
## Sign-up card
- **Allow new user sign-ups** (`auth.allowSignUp`) — confirm dialogs when enabling/disabling
- **Require email verification** (`onboarding.requireEmailVerification`) — may preview affected users before enable (same as Onboarding app)
- **Same-email social login policy** dropdown (`auth.oauth.accountMergeStrategy`): Link accounts / Create new account / Block sign-up
## User deletion card
- **Allow users to delete their own accounts on the client-side** (`users.allowClientUserDeletion`) — adds delete control to account settings
Production hardening: **Launch Checklist** for domains, custom OAuth keys, email. Guide: [Auth providers](https://docs.hexclave.com/docs/apps/authentication/auth-providers).

View File

@ -1,12 +1,30 @@
---
hidden: true
title: "Sign-up Rules"
description: "Sign-up Rules in the Authentication app"
description: "Fraud-protection sign-up rules (CEL conditions, ordered evaluation)."
sidebarTitle: "Sign-up Rules"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Rule list
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Rules stored in `auth.signUpRules`, sorted by **priority** (top = first match). Drag-and-drop reorder with **Save order** / **Discard** when `pendingOrder` is set. Each row: enable toggle, action badge (Allow / Reject / Restrict / Log), sparkline + trigger counts, menu **Edit** / **Delete**.
## Default outcome
**If no rules match** → configurable **Allow** or **Reject** (`auth.signUpRulesDefaultAction`).
## Rule editor (inline)
Three steps: name, **When** (visual CEL condition builder), **Then** (action + message). Conditions can reference email domain, country, auth method, OAuth provider, Turnstile, risk scores.
## Trigger history
Per-rule dialog queries ClickHouse `$sign-up-rule-trigger` events (paginated).
## Test rules
**Test rules** card simulates a sign-up payload against current rules without affecting production (email, auth method, overrides for country/Turnstile/risk).
Also available as the **Fraud Protection** sub-app (same page, `sign-up-rules` route).

View File

@ -1,12 +1,14 @@
---
hidden: true
title: "Catalyst"
description: "Catalyst in the Catalyst app"
description: "Hexclave Catalyst — AI-assisted project setup (app store entry)."
sidebarTitle: "Catalyst"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Dashboard entry
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
**Catalyst** is listed in the app store. Enabling it routes operators to Catalyst-powered onboarding flows (experimental). There is no separate project-scoped configuration screen in the dashboard today.
Use the app store card to enable/disable the app for the project (`apps.installed.catalyst`).

View File

@ -1,12 +1,16 @@
---
hidden: true
title: "Convex Integration"
description: "Convex Integration in the Convex Integration app"
description: "Hexclave + Convex integration (dashboard entry redirects to docs)."
sidebarTitle: "Convex Integration"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Behavior
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Opening **Convex Integration** in the project sidebar immediately redirects to the public [Convex integration guide](https://docs.hexclave.com/guides/integrations/convex/overview). There is no in-dashboard configuration UI on this route.
## Setup (off-dashboard)
Follow the linked docs to install the Convex component, wire auth, and sync users/teams. Enable the **Convex** app in the app store so the sidebar entry stays available.

View File

@ -1,12 +1,37 @@
---
hidden: true
title: "Data Vault"
description: "Data Vault in the Data Vault app"
description: "List and create Data Vault stores."
sidebarTitle: "Data Vault"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
Encrypted key-value namespaces for secrets your app stores via the SDK. Keys are hashed — you cannot list keys, only get/set by known key.
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
## Header
- **Create Store** (page action) — same dialog as empty state CTA
## Empty state
When no stores: icon, copy, **Create Your First Store** button.
## Store list
Each **DesignListItemRow**: store ID (title), display name (subtitle). Click row → store detail (`/projects/…/data-vault/stores/[storeId]`).
## Create Store dialog
- **Store ID** (required) — sanitized live; immutable after create; `dataVault.stores.<id>` in config
- **Display Name** (optional) — defaults to `Store <id>` if blank
- Validation alerts for invalid ID format or duplicate ID
## Store detail page (separate route)
- **Store ID** with copy button
- **Display Name** — deferred save grid
- **Delete Store** — must type store ID to confirm; irreversible
- Info alert + code sample for `getDataVaultStore`, `getValue` / `setValue` with `STACK_DATA_VAULT_SECRET` / `HEXCLAVE_DATA_VAULT_SECRET`
[Data Vault](https://docs.hexclave.com/docs/apps/data-vault)

View File

@ -1,12 +1,20 @@
---
hidden: true
title: "Email API"
description: "Email API in the Email API app"
description: "Programmatic email sending via the Hexclave server SDK."
sidebarTitle: "Email API"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Dashboard entry
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
The **Email API** app documents how to send transactional email from server code using templates and themes configured in the **Emails** app. The sidebar entry points at the Email API overview; delivery logs live under **Emails → Sent**.
## Typical workflow
1. Configure SMTP or managed delivery in **Emails → Email Settings**
2. Author templates in **Emails → Templates** (and themes in Email Settings)
3. Call the Email API from your backend with the secret server key
Public guide: [Email API](https://docs.hexclave.com/docs/apps/email-api).

View File

@ -1,12 +1,19 @@
---
hidden: true
title: "Drafts"
description: "Drafts in the Emails app"
description: "Compose one-off emails and send them from the dashboard."
sidebarTitle: "Drafts"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Sections
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
- **Active drafts** — cards with open/delete; click opens `email-drafts/[draftId]` editor
- **History** — drafts that were sent (`sentAt` set); opens editor in read-only **sent** stage
## Header actions
**New draft** dropdown: create blank draft or start from an existing **template** (blocked with warning dialog when using shared SMTP).
Draft editor supports HTML preview, recipients, schedule/send, and duplicate-from-template flows on the child route.

View File

@ -1,12 +1,22 @@
---
hidden: true
title: "Email Settings"
description: "Email Settings in the Emails app"
description: "SMTP delivery, managed domains, and email themes."
sidebarTitle: "Email Settings"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Theme settings (`ThemeSettings`)
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Pick the active email theme, preview rendered HTML at miniature scale, and open **email-themes** to edit layouts. Themes apply to templates and programmatic sends.
## Domain settings (`DomainSettings`)
Configure delivery backend:
- **Shared** / **Managed** / **Resend** / **Custom SMTP**
- Managed domains: DNS records, verification status, sender local part
- Test send, copy DNS records, download zone file helpers
Saving updates `config.emails.server` via deferred dialogs and config push.

View File

@ -1,12 +1,21 @@
---
hidden: true
title: "Sent"
description: "Sent in the Emails app"
description: "Outbox delivery log and sending-domain reputation."
sidebarTitle: "Sent"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Email log card
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
**DesignPillToggle** switches views:
- **List all** — paginated `DataGrid` (recipient, subject, time, status badge). Row click opens **email-viewer/[emailId]**
- **Group by template/draft** — `GroupedEmailTable` clusters sends by source template or draft
Status labels cover scheduled, sent, failed, etc. (`email-status-utils`).
## Domain reputation
Right column (`DomainReputationCard`) shows DNS/SPF/DKIM health for configured sending domains.

View File

@ -1,12 +1,18 @@
---
hidden: true
title: "Templates"
description: "Templates in the Emails app"
description: "Transactional email templates (HTML + variables)."
sidebarTitle: "Templates"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Template list
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Card per template with display name. **Open** navigates to `email-templates/[templateId]` editor. Row menu: **Delete** (blocked with error if template is in use).
## Warnings
Orange alert when `emails.server` uses the **shared** SMTP server — custom templates require your own SMTP (**Email Settings**).
**New Template** creates a template via dialog (requires non-shared SMTP).

View File

@ -1,12 +1,44 @@
---
hidden: true
title: "Launch Checklist"
description: "Launch Checklist in the Launch Checklist app"
description: "Pre-launch checklist before enabling production mode."
sidebarTitle: "Launch Checklist"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Progress card (top)
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
- Title shows `N/M Checks Completed` or **Everything is ready to launch.**
- Progress bar (animated) across all sub-checks
- **Up next** + rainbow **Go to {section}** button when work remains (jumps to that sections primary CTA)
- When all checks pass, message to enable production mode below
Incomplete task sections are sorted **above** completed ones. Only one section expanded at a time (auto-opens the “up next” section).
## Task sections (expandable cards)
Each card: title, subtitle, checklist rows (green check / empty circle), footer CTA, optional extra content. Click header to expand/collapse.
### 1. Domains & callbacks → **Open domain settings** (Domains)
- Production domain saved (shows up to three `InlineCode` domains)
- **Localhost callbacks disabled** (`allowLocalhost` off)
### 2. OAuth providers → **Configure providers** (Auth Methods)
- **Custom client IDs and secrets** — no providers on shared dev keys (orange badges list offenders)
- Expand **View guides**: provider tabs (Google, GitHub, …), external docs link, **Callback URL** `https://api.hexclave.com/api/v1/auth/oauth/callback/{provider}`
### 3. Email server → **Configure email server** (Emails)
- **Custom SMTP or Resend in use** (not shared `sent-with-hexclave` sender)
- Expand **View steps**: verify domain, switch SMTP/Resend, send test email
### 4. Production mode
- **Automated checks passing** — lists `productionModeErrors` with **open setting** links if blocked
- **Production mode enabled** — inline **Enable production mode** switch (disabled until checks pass); confetti when turned on
- Footer **Open project settings** / **Review settings**
Enable production mode only after domains, OAuth, and email sections are green. See [Launch checklist](https://docs.hexclave.com/docs/apps/launch-checklist).

View File

@ -1,12 +1,23 @@
---
hidden: true
title: "Neon Integration"
description: "Neon Integration in the Neon Integration app"
description: "Connect a Neon Postgres project to Hexclave (OAuth + API key provisioning)."
sidebarTitle: "Neon Integration"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Dashboard entry
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Enabling the **Neon** app in the app store opens the Neon OAuth flow. After authorization, Hexclave creates a project API key scoped to your selected Stack project and links it to the Neon database.
## In-product flow
- **OAuth confirm** (`/integrations/neon/confirm`) — pick or create the Hexclave project to link
- **Transfer confirm** (`/integrations/neon/projects/transfer/confirm`) — approve moving an existing Neon-linked project
## Operator notes
The integration grants Neon read/write access to users, teams, and permissions for the linked project. Revoke keys under **Project Settings → Project Keys** if you disconnect Neon.
Public guide: [Neon integration](https://docs.hexclave.com/guides/integrations/neon/overview).

View File

@ -1,12 +1,30 @@
---
hidden: true
title: "Onboarding"
description: "Onboarding in the Onboarding app"
description: "Gate app access until users verify their email."
sidebarTitle: "Onboarding"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
Single-setting page for the **Onboarding** app (separate from Auth Methods, though Auth Methods also exposes the same config toggle).
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
## Require email verification
Compact settings row:
- Label **Require email verification**
- Description: verified primary email required before users continue after sign-up
- **Switch** — maps to `onboarding.requireEmailVerification` (immediate save, loading state on toggle)
## Enabling (on → true)
If existing unverified users would be affected, a confirmation dialog opens first:
- Title **Enable email verification?**
- Count + sample list of affected accounts (Unverified / Anonymous badges)
- **Cancel** or **Enable** — then config updates
Turning **off** applies immediately with no preview.
Restricted users are filtered from normal API responses until they complete verification. Same field also appears under **Auth Methods → Sign-up** card.

View File

@ -1,12 +1,23 @@
---
hidden: true
title: "Customers"
description: "Customers in the Payments app"
description: "Grant products to users or teams and inspect entitlements."
sidebarTitle: "Customers"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Customer picker
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Toggle **User** vs **Team**, then search and select a customer. Until selected, grant actions are disabled.
## Entitlements table
`DataGrid` of active product grants for the selected customer: product, item/price, status, period end. Row actions can revoke or adjust grants (via config updates).
## Actions
- **Grant product** — pick product + item, optional trial/discount fields
- **Add item** — shortcut to create a new price in config (`ItemDialog`)
URL state tracks customer type and selection for shareable support links.

View File

@ -1,12 +1,14 @@
---
hidden: true
title: "Payouts"
description: "Payouts in the Payments app"
description: "Stripe Connect payouts for connected accounts."
sidebarTitle: "Payouts"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Availability
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Hidden in **development environments** and **preview deployments** (alert explains why). In production, renders Stripe **ConnectPayouts** inside `StripeConnectProvider` after Stripe is linked on **Settings**.
Operators manage payout schedules and balances here; connect Stripe first under **Payments → Settings**.

View File

@ -1,12 +1,18 @@
---
hidden: true
title: "Product Lines"
description: "Product Lines in the Payments app"
description: "Group products into mutually exclusive product lines."
sidebarTitle: "Product Lines"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Empty state
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
If the project has no products or items yet, shows an onboarding slideshow ending with **Create Your First Product** (links to `payments/products/new`).
## Product lines view
When catalog exists, lists product lines from config. Each line is a set of products where a customer may hold at most one active product from that line. Create, rename, and assign products via `PageClientProductLinesView`.
Configure lines before scaling the catalog — they enforce exclusivity at checkout and grant time.

View File

@ -1,12 +1,25 @@
---
hidden: true
title: "Products & Items"
description: "Products & Items in the Payments app"
description: "Manage products, prices (items), and checkout URLs."
sidebarTitle: "Products & Items"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Layout
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Two-column list: **Products** (left) and **Items / prices** (right). Selecting a product filters its items.
## Product actions
- **Create product** — dialog (display name, customer type user/team, product line)
- Row menu: **Edit**, **Copy checkout URL**, **Delete**
- Row click opens product detail (`payments/products/[productId]`)
## Item actions
- **Create item** — price, billing interval, entitlements
- **Edit** / **Delete** per item; checkout URL validation surfaces config errors inline
Revenue sparklines may appear on product rows when analytics data exists.

View File

@ -1,12 +1,17 @@
---
hidden: true
title: "Settings"
description: "Settings in the Payments app"
description: "Stripe connection, test mode, payment methods, and checkout guardrails."
sidebarTitle: "Settings"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Sections (top to bottom)
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
- **Stripe connection** — link or view Connect account status (`StripeConnectionCheck`)
- **Test mode** — toggle sandbox vs live charges (`TestModeToggle`)
- **Payment methods** — enable/disable card and other methods (`PaymentMethods`)
- **Checkout controls** — **Block new purchases** toggle (`payments.blockNewPurchases`); stops new checkouts while keeping existing subscriptions
All toggles save to project config with optimistic UI on the block-purchases switch.

View File

@ -1,12 +1,14 @@
---
hidden: true
title: "Transactions"
description: "Transactions in the Payments app"
description: "Browse payment and subscription transactions for this project."
sidebarTitle: "Transactions"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Transactions table
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Uses the shared `TransactionTable` component: paginated `DataGrid` of purchases, refunds, and subscription events with filters and row detail. Sort and search state sync to the URL.
Use **Customers** to grant products; this page is read-only history for reconciliation and support.

View File

@ -1,12 +1,23 @@
---
hidden: true
title: "Project Permissions"
description: "Project Permissions in the RBAC app"
description: "Define project-scoped permission IDs and compose them into roles."
sidebarTitle: "Project Permissions"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Header
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
**Create Permission** opens a dialog with **ID** (lowercase, numbers, `_`, `:`), **Description**, and **Contained permissions** (inherit other project permissions).
## Permissions table (`DataGrid`)
Paginated, searchable list of project permission definitions. Row actions:
- **Edit** — update description and contained permissions (ID is read-only)
- **Delete** — remove the permission definition
Permission IDs map directly to `$permission_id` checks in the SDK (`user.hasPermission`, etc.).
Public guide: [RBAC](https://docs.hexclave.com/docs/apps/rbac).

View File

@ -1,12 +1,18 @@
---
hidden: true
title: "Team Permissions"
description: "Team Permissions in the RBAC app"
description: "Define team-scoped permission IDs used in team membership checks."
sidebarTitle: "Team Permissions"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Header
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
**Create Permission** — same shape as project permissions: unique **ID**, **Description**, optional **Contained permissions** from existing team permissions.
## Permissions table (`DataGrid`)
Lists team permission definitions with search, pagination, **Edit**, and **Delete**. Team permission IDs are referenced in team settings defaults and in SDK team-scoped authorization.
Pair with **Teams → Team Settings** for default creator/member grants.

View File

@ -1,12 +1,18 @@
---
hidden: true
title: "Conversations"
description: "Conversations in the Support app"
description: "Support inbox: threads, replies, internal notes, and SLA hints."
sidebarTitle: "Conversations"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Inbox (no thread selected)
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Search by subject/message/email, **status tabs** (All / Open / Pending / Closed), optional **userId** filter from URL. **New Conversation** picks a user and opens a thread.
## Thread view
Message timeline (customer vs team), composer for public replies, **internal notes** (team-only). Sidebar/sheet: assignee, priority, status, tags, SLA urgency badge, link to user profile.
URL params: `conversationId` (or legacy `threadId`), `userId`. Refreshes via `listConversations` / `getConversation` API helpers.

View File

@ -1,12 +1,23 @@
---
hidden: true
title: "Team Settings"
description: "Team Settings in the Teams app"
description: "Control team creation behavior and default RBAC grants."
sidebarTitle: "Team Settings"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Team Creation card
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Deferred-save editable grid (toggle → **Save** / **Discard**):
| Toggle | Config | Effect |
| --- | --- | --- |
| **Client Team Creation** | `teams.allowClientTeamCreation` | Users can create teams from account settings / team switcher |
| **Personal Team on Sign-up** | `teams.createPersonalTeamOnSignUp` | Auto-creates a personal team for each new user (not retroactive) |
## Default permissions cards
Two cards — **Team Creator** and **Team Member** — show badges for permissions in `rbac.defaultPermissions.teamCreator` / `teamMember`. **Edit** opens a checkbox dialog over the team permission graph (inheritance shown inline).
Changes push to project config immediately on save.

View File

@ -1,12 +1,51 @@
---
hidden: true
title: "Teams"
description: "Teams in the Teams app"
description: "List, search, and manage teams for this project."
sidebarTitle: "Teams"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Header
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
- **Create Team** (top right) — opens a dialog with **Display Name** only; Hexclave assigns the team ID on create.
## Info banner
When the project has **no teams yet**, an alert may link to **project membership** invites (`/projects?team_settings=…`) — that is for inviting dashboard collaborators, not the customer teams in this table.
## KPI cards (four)
Sparkline metric cards above the table (from project analytics):
- **New Active Teams** — recently active teams (new in the activity window)
- **Daily Active Teams** (DAT)
- **Returning Team Rate**
- **Total Teams** — all-time count
## Teams table (`DataGrid`)
Paginated list (infinite scroll, 25 per page). Default sort: **Created At** descending. Toolbar **quick search** filters by team (server-side `listTeams` query). State syncs to URL (`teams` prefix).
| Column | Notes |
| --- | --- |
| **ID** | Team UUID (monospace) |
| **Display Name** | Editable via row actions |
| **Created At** | Sortable |
| **Actions** | Row menu (see below) |
**Row click** navigates to the team detail page (`/projects/…/teams/[teamId]`).
### Row action menu
- **View Members** — same destination as row click
- **Edit** — change display name (ID shown read-only in dialog)
- **Create Checkout** — opens payments checkout dialog for this team (when Payments is in use)
- **Delete** — destructive; requires typing that removal cannot be undone (members are removed from the team)
## Team detail page (after row click)
Separate route: edit display name inline, **Members** tab (invite by email, member table), **Metadata**, and sections for enabled apps (e.g. analytics, payments). Not rendered on this list page.
Public integration guide: [Teams](https://docs.hexclave.com/docs/apps/teams).

View File

@ -1,12 +1,14 @@
---
hidden: true
title: "TV mode"
description: "TV mode in the TV mode app"
description: "Full-screen dashboard display for office TVs and status walls."
sidebarTitle: "TV mode"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Dashboard entry
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
**TV mode** is a navigable app with a dedicated route (`tv-mode`). It is intended for read-only, large-format views of project metrics and health — not day-to-day configuration.
Enable the app from the app store, then open **TV mode** from the sidebar to launch the display UI.

View File

@ -1,12 +1,22 @@
---
hidden: true
title: "Setup"
description: "Setup in the Vercel Integration app"
description: "Step-by-step checklist to deploy Hexclave on Vercel."
sidebarTitle: "Setup"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
## Progress card
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
Accordion steps with manual checkboxes (stored in local UI state). Progress bar and confetti when all items are marked done.
| Step | Tasks |
| --- | --- |
| **Project** | Confirm Hexclave project |
| **Keys** | Generate publishable + secret keys (`createInternalApiKey`) |
| **Env vars** | Copy `EnvKeys` snippet into Vercel |
| **Deploy** | Trigger redeploy on preview + production |
| **Verify** | Test `/handler/signup` on deployed URL |
Keys display once — copy before navigating away. Requires **Vercel** app enabled.

View File

@ -1,12 +1,39 @@
---
hidden: true
title: "Webhooks"
description: "Webhooks in the Webhooks app"
description: "Manage Svix webhook endpoints for user and team events."
sidebarTitle: "Webhooks"
---
{/* This file is auto-generated by scripts/generate-dashboard-reference-docs.ts. Do not edit it manually; update the @dashboardReference JSDoc on the dashboard page component. */}
No dashboard reference documentation is available for this page yet.
Syncs user/team lifecycle events to your servers. Page subtitle explains purpose.
To document this screen, add a `@dashboardReference` JSDoc block on the dashboard `page-client.tsx` for this route (see `api-keys-app/page-client.tsx` for an example).
## Modes
- **Preview deployments** — info alert only; webhooks unavailable
- **AppPortal URL** — full embedded Svix UI (replaces inline grid)
- **Default** — inline **Endpoints** card below (Svix React SDK)
## Endpoints card
Subtitle warns endpoints receive sensitive data — must be URLs you control.
- **Add new endpoint** — dialog: URL (validated), optional description, HTTP warning for `http://`; on success offers **Test endpoint** or close
- **DataGrid** (client-side list, quick search, URL state prefix `webhooks`)
| Column | Notes |
| --- | --- |
| **Endpoint URL** | Destination |
| **Description** | Optional label |
| **Status** | Active / Disabled badge |
| **Actions** | Row menu |
### Row menu
- **View Details** → `/projects/…/webhooks/[endpointId]` (secrets, delivery attempt history)
- **Test** — sends sample test event; dialog shows payload preview and delivery result
- **Edit** — update description only (URL fixed)
- **Delete** — confirm removal from Svix
Verify payloads server-side with your webhook secret — [Webhooks](https://docs.hexclave.com/docs/apps/webhooks).