Document Feature

Add a new HelpCard to the appropriate category's cards array, or update an existing card if the feature enhances something already documented. Each card needs:

{
  id: "kebab-case-unique-id",        // unique across ALL categories
  icon: SomeLucideIcon,              // import from lucide-react
  title: "Short user-facing title",  // what users see
  summary: "One-line summary shown when collapsed (~40-60 chars).",
  description: "Detailed explanation shown when the card is expanded. 3-5 sentences covering what it does, how it works, and practical details. Write from the USER's perspective, not a developer's.",
  tips?: [                           // optional but recommended
    { text: "How to use it or a useful detail" },
    { text: "Keyboard shortcut", shortcut: "key" },
  ],
  relatedSettingsTab?: "general",    // optional, must be a valid tab ID
}

Valid relatedSettingsTab values: general, composing, labels, filters, smart-folders, quickSteps, contacts, accounts, sync, shortcuts, ai, subscriptions, developer

If adding a contextual tip (for ? tooltips in the UI), add an entry to the CONTEXTUAL_TIPS record:

"tip-id": {
  title: "Short title",
  body: "One sentence explaining the setting or feature.",
  helpTopic: "category-id",  // must match a category ID
}

Run the help content tests to validate your additions:

npx vitest run src/constants/helpContent.test.ts

The tests check: unique IDs, non-empty titles/descriptions, valid settings tab references, valid contextual tip topic references.

Run type-check to make sure icon imports are correct:

npx tsc --noEmit

Update project docs if the feature affects them. Check each file and update as needed:

• docs/architecture.md — Update if the feature adds new component groups, services, stores, database tables, or changes the project structure tree. Keep counts accurate (component groups, file counts, table counts).
• docs/development.md — Update if test counts change or new development workflows are introduced.
• docs/keyboard-shortcuts.md — Update if the feature adds or changes keyboard shortcuts.
• CLAUDE.md — Update the relevant section (component organization, service layer, key gotchas, etc.) to reflect the new feature.