From edf7f8ebdc9e991ec4dcd64a92d1cb0a0cf87f9f Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Oct 2026 10:15:46 +0000 Subject: [PATCH 1/2] docs: widen the prose column to 48rem Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_019tmauRe3L8aDyuwcjtcHF2 --- apps/docs/theme.css | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 apps/docs/theme.css diff --git a/apps/docs/theme.css b/apps/docs/theme.css new file mode 100644 index 0000000..af3e928 --- /dev/null +++ b/apps/docs/theme.css @@ -0,0 +1,4 @@ +/* The docs family's prose column, a little wider than Blume's 42rem so pages sit better on wide screens. */ +:root { + --blume-content-width: 48rem; +} From d70f13c00f5278d808cd00e2b5b3a5a1f05b54ec Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 15 Oct 2026 10:22:25 +0000 Subject: [PATCH 2/2] docs: give provider keys their own table in the configuration reference The package settings table scrolled sideways at every width because of the long Providers:* keys and the inline env var example. Provider keys now sit in a Provider settings table under WebAnalytics:Providers, the env var example moves below the table, and the bootstrap example is titled appsettings.json. Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_019tmauRe3L8aDyuwcjtcHF2 --- apps/docs/docs/reference/configuration.mdx | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/apps/docs/docs/reference/configuration.mdx b/apps/docs/docs/reference/configuration.mdx index b94b2b7..db26403 100644 --- a/apps/docs/docs/reference/configuration.mdx +++ b/apps/docs/docs/reference/configuration.mdx @@ -20,7 +20,7 @@ Each Umbraco application instance keeps its own in-memory report cache. Restart Bootstrap connections this way when deployment automation has to create them. Keep access tokens out of this file. -```json +```json appsettings.json { "WebAnalytics": { "Enabled": true, @@ -49,6 +49,8 @@ For Plausible, use `"Provider": "Plausible"` and set `SiteId` instead of `Projec ## Package settings +All keys live under the `WebAnalytics` configuration section. + | Key | Default | Description | | --- | --- | --- | | `Enabled` | `true` | Enables the Analytics section and configured document workspace views. | @@ -56,10 +58,19 @@ For Plausible, use `"Provider": "Plausible"` and set `SiteId` instead of `Projec | `DefaultRangeDays` | `30` | Initial reporting range, in days. Valid values are 1 to 730. | | `CacheDuration` | `00:05:00` | Per-instance in-memory cache duration. Valid from zero to one hour. | | `Connections` | `[]` | Provider connection definitions. The first becomes the initial default. | -| `ConnectionAccessTokens` | Empty | Optional connection-specific credential overrides, keyed by connection GUID. An override takes precedence over the shared provider credential. Set one with `WebAnalytics__ConnectionAccessTokens__{connection-guid}`. | -| `Providers:Vercel:AccessToken` | Empty | Shared Vercel access token. | -| `Providers:Plausible:AccessToken` | Empty | Shared Plausible Stats API key. | -| `Providers:Plausible:BaseUrl` | `https://plausible.io/` | Public base URL of the Plausible Cloud or self-hosted instance. It must expose `/api/v2/query`. | +| `ConnectionAccessTokens` | Empty | Optional connection-specific credential overrides, keyed by connection GUID. An override takes precedence over the shared provider credential. | + +Set a connection override with `WebAnalytics__ConnectionAccessTokens__{connection-guid}`. + +### Provider settings + +These keys live under `WebAnalytics:Providers`. + +| Key | Default | Description | +| --- | --- | --- | +| `Vercel:AccessToken` | Empty | Shared Vercel access token. | +| `Plausible:AccessToken` | Empty | Shared Plausible Stats API key. | +| `Plausible:BaseUrl` | `https://plausible.io/` | Public base URL of the Plausible Cloud or self-hosted instance. It must expose `/api/v2/query`. | ## Connection settings