Improve docs formatting, support dark mode

Author: gmethvin

COMMANDS.md

@@ -1,10 +1,10 @@
-# Available Commands (109 commands)
+# Available Commands (109)
 
 All commands follow the pattern: `iterable <category> <command> [options]`
 
 Every command also accepts `--json <data>` for raw JSON input and `--help` for usage details.
 
-## campaigns (14 commands)
+## campaigns (14)
 
 ### campaigns abort
 
@@ -193,7 +193,7 @@ iterable campaigns trigger --campaignId <campaignId> --listIds <listIds...>
 | `--suppressionListIds` | number[] | no | Lists to suppress |
 
 
-## catalogs (12 commands)
+## catalogs (12)
 
 ### catalogs bulk-delete-items
 
@@ -350,7 +350,7 @@ iterable catalogs update-items <catalogName> --items <items...>
 | `--items` | json[] | **yes** | Catalog items to update |
 
 
-## events (4 commands)
+## events (4)
 
 ### events get-by-email
 
@@ -411,7 +411,7 @@ iterable events track-bulk --events <events...>
 | `--events` | json[] | **yes** |  |
 
 
-## experiments (4 commands)
+## experiments (4)
 
 ### experiments get
 
@@ -462,7 +462,7 @@ List experiments with optional filtering by campaign, status, and date range
 | `--status` | `draft` \| `running` \| `finished` | no | Filter by status (draft, running, finished) |
 
 
-## export (4 commands)
+## export (4)
 
 ### export cancel
 
@@ -517,7 +517,7 @@ iterable export start --dataTypeName <dataTypeName> --outputFormat <outputFormat
 | `--startDateTime` | string | no | Export events occurring or users updated after date and time inclusive |
 
 
-## journeys (2 commands)
+## journeys (2)
 
 ### journeys list
 
@@ -548,7 +548,7 @@ iterable journeys trigger <workflowId>
 | `--userId` | string | no | User ID (alternative to email) |
 
 
-## lists (8 commands)
+## lists (8)
 
 ### lists create
 
@@ -646,7 +646,7 @@ iterable lists unsubscribe <listId> --subscribers <subscribers...>
 | `--subscribers` | json[] | **yes** | Users to unsubscribe |
 
 
-## messaging (16 commands)
+## messaging (16)
 
 ### messaging cancel-email
 
@@ -858,7 +858,7 @@ iterable messaging send-whatsapp <campaignId>
 | `--sendAt` | string | no | When to send (YYYY-MM-DD HH:MM:SS format) |
 
 
-## snippets (5 commands)
+## snippets (5)
 
 ### snippets create
 
@@ -921,7 +921,7 @@ iterable snippets update --content <content> --identifier <identifier>
 | `--variables` | string[] | no | List of variable names used in the content with a Handlebars expression such as {{myField}}. Variable names are case-sensitive and should be simple identifiers (letters, numbers, underscores). To learn more about using Handlebars in Snippets, see Customizing Snippets with Variables. |
 
 
-## subscriptions (5 commands)
+## subscriptions (5)
 
 ### subscriptions bulk-update
 
@@ -996,7 +996,7 @@ iterable subscriptions unsubscribe-by-userid --subscriptionGroup <subscriptionGr
 | `--userId` | string | **yes** | User's userId |
 
 
-## templates (21 commands)
+## templates (21)
 
 ### templates delete
 
@@ -1350,7 +1350,7 @@ iterable templates upsert-sms <clientTemplateId>
 | `--name` | string | no | Template name |
 
 
-## users (12 commands)
+## users (12)
 
 ### users bulk-update
 
@@ -1499,7 +1499,7 @@ Update user subscriptions (overwrites existing data for any non-null fields spec
 | `--validateChannelAlignment` | boolean | no | Defaults to true (validation enabled). When false, allows subscribing users to message types that belong to unsubscribed channels. By default, Iterable validates that subscribed message types belong to subscribed channels. Setting this to false bypasses this validation, allowing you to save message type preferences even when the parent channel is unsubscribed. Users won't receive messages from these types while the channel remains unsubscribed, but their preferences are preserved for when the channel becomes subscribed. |
 
 
-## webhooks (2 commands)
+## webhooks (2)
 
 ### webhooks list
 

CONTRIBUTING.md

@@ -63,10 +63,7 @@ pnpm test:unit         # Parser, router, commands registry, key manager — no n
 pnpm test:integration  # Calls the real Iterable API (needs ITERABLE_API_KEY)
 pnpm test:e2e          # Spawns the CLI binary as a subprocess
 pnpm test              # All of the above (runs build first)
+pnpm check             # Lint, typecheck, format
 ```
 
 Integration and E2E tests that need an API key are skipped automatically when `ITERABLE_API_KEY` is not set.
-
-## Before Committing
-
-Run `pnpm check` to catch formatting, type, and lint issues.

README.md

@@ -1,11 +1,13 @@
 # Iterable CLI
 
 [![npm version](https://img.shields.io/npm/v/@iterable/cli.svg)](https://www.npmjs.com/package/@iterable/cli)
-
-> **Note:** This is an open-source developer tool, not an officially supported Iterable product. It is provided "as is" under the MIT License with no warranty or support guarantees.
+[![docs](https://img.shields.io/badge/docs-iterable.github.io%2Fcli-blue)](https://iterable.github.io/cli/)
 
 A command-line interface for the [Iterable API](https://api.iterable.com/api/docs). Manage campaigns, templates, users, lists, and more from your terminal.
 
+> **Note:** This is an open-source developer tool, not an officially supported Iterable product. It is provided "as is" under the MIT 
+License with no warranty or support guarantees.
+
 ## Installation
 
 **Prerequisites:**

index.html

@@ -5,19 +5,45 @@
   <title>Iterable CLI</title>
   <meta name="description" content="Command-line interface for the Iterable API">
   <meta name="viewport" content="width=device-width, initial-scale=1.0, minimum-scale=1.0">
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsify@4/lib/themes/vue.css">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple.css" media="(prefers-color-scheme: light)">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/css/theme-simple-dark.css" media="(prefers-color-scheme: dark)">
   <style>
-    .sidebar > h1 { text-align: left; padding-left: 1rem; }
-    .app-name-link { font-weight: bold; }
-    .app-name-link img { vertical-align: middle; margin-right: 6px; border-radius: 4px; }
-    .sidebar ul li a { font-size: 1rem; }
+    :root {
+      --sidebar-name-font-weight: bold;
+      --sidebar-name-text-align: left;
+      --heading-font-weight: 700;
+    }
+    @media (prefers-color-scheme: light) {
+      :root {
+        --theme-color: #357a69;
+        --base-background-color: #f5f5f7;
+        --sidebar-background: #ebebef;
+        --heading-color: #1e1e2e;
+      }
+    }
+    @media (prefers-color-scheme: dark) {
+      :root {
+        --theme-color: #5DB5A1;
+        --mono-shade3: hsl(230, 20%, 7%);
+        --mono-shade2: hsl(230, 20%, 9%);
+        --mono-shade1: hsl(230, 20%, 11%);
+        --mono-base: hsl(230, 20%, 13%);
+        --mono-tint1: hsl(230, 20%, 19%);
+        --heading-color: #e0e0e0;
+      }
+    }
+    .app-name-link {
+      background: url('https://github.com/Iterable.png') no-repeat left center / 1.2em;
+      padding-left: 1.7em;
+      border-radius: 4px;
+    }
   </style>
 </head>
 <body>
   <div id="app"></div>
   <script>
     window.$docsify = {
-      name: '<img src="https://github.com/Iterable.png" width="28" alt="Iterable"> Iterable CLI',
+      name: 'Iterable CLI',
       repo: 'https://github.com/Iterable/cli',
       loadSidebar: true,
       subMaxLevel: 2,
@@ -26,6 +52,7 @@
     };
   </script>
   <script src="https://cdn.jsdelivr.net/npm/docsify@4/lib/docsify.min.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/docsify-themeable@0/dist/js/docsify-themeable.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/docsify@4/lib/plugins/search.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/prismjs@1/components/prism-bash.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/prismjs@1/components/prism-typescript.min.js"></script>

scripts/update-commands.js

@@ -93,7 +93,7 @@ try {
   );
 
   const sections = [
-    `# Available Commands (${totalCount} commands)`,
+    `# Available Commands (${totalCount})`,
     "",
     `All commands follow the pattern: \`${COMMAND_NAME} <category> <command> [options]\``,
     "",
@@ -102,7 +102,7 @@ try {
 
   for (const { category, commands } of commandsByCategory) {
     sections.push("");
-    sections.push(`## ${category} (${commands.length} commands)`);
+    sections.push(`## ${category} (${commands.length})`);
     sections.push("");
     for (const cmd of commands) {
       try {