smart-connections-component-patterns

Installation
SKILL.md

Smart Connections Component Patterns

Use this skill when editing or creating Smart Connections UI components under src/components/**, especially when you need to preserve the project’s component lifecycle, listener guards, and env/settings fallbacks.

Critical

  • Keep component work inside src/components/**; do not move UI logic into src/main.js, release scripts, or migration files.
  • Match the existing component lifecycle used in this repo: build_html(...)render(...)post_process(...).
  • Guard all event attachment with if (!container._has_listeners) so rerenders do not duplicate handlers.
  • Prefer existing helpers and patterns from:
    • src/components/connections-list/v4.js
    • src/components/connections-list-item/v3.js
    • src/components/connections-view/v3.js
    • src/components/connections_codeblock.js
    • src/components/lookup/item_view.js
  • Keep fallbacks explicit, especially opts.connections_settings ?? env.connections_lists.settings or the equivalent env fallback used by nearby components.

Instructions

  1. Pick the closest reference component before coding.
    • For list item UI, start with src/components/connections-list-item/v3.js.
    • For list rendering, start with src/components/connections-list/v4.js.
Related skills
Installs
1
GitHub Stars
1
First Seen
Apr 16, 2026