building-logseq-plugins

This skill acts as a dedicated technical architect for developers building extensions for the Logseq platform. It provides deep-dive assistance for those migrating or creating plugins for the modern database-backed graph architecture. Whether you are working with the core API namespaces like logseq.Editor, logseq.DB, or logseq.App, or navigating the complexities of Datalog queries, this skill delivers precise architectural guidance and code patterns to ensure your plugins remain performant and compatible across different graph environments.

• Full support for plugin manifest configuration (package.json) and sandboxed iframe architecture.

• Expert assistance with the Logseq Plugin API, including slash command registration, UI component creation, and custom settings schema definition.

• Specialized knowledge for DB-version compatibility, including the transition from content-based to title/property-based block access.

• Advanced Datalog query construction for the Datascript engine, including parameter handling and entity-based relationship lookups.

• Standardized patterns for property management, including upserting block properties, tag handling, and structured data handling.

• Best practices for feature detection between DB and Markdown-based graphs to ensure cross-compatibility.

• Best suited for developers, plugin authors, and power users who are extending Logseq functionality.

• Ideal for troubleshooting API-related errors, optimizing database queries, or implementing complex block manipulation logic.

• Provides immediate access to template structures, initialization boilerplates, and lifecycle management for plugins.

• Expect structured code snippets that follow official Logseq development standards and 2024+ enhanced API specifications.

• Constraints: Primarily focused on the JavaScript/TypeScript ecosystem for logseq/libs and frontend iframe communication.