convex-create-component

The `convex-create-component` skill is designed to help developers design and build reusable Convex components with clear boundaries and isolated tables. It solves the challenge of organizing backend logic in a way that separates concerns, allowing functionality to be packaged into distinct modules while maintaining a clean interface with the main application. This skill is particularly useful when developers want to extract reusable backend functionality, integrate third-party services, or create components that maintain their own persistent state independently of the main app. By providing structured guidance, it ensures components are modular, maintainable, and easy to integrate without disrupting the primary app logic.

Key features of this skill include defining a component structure with its own `convex.config.ts`, `schema.ts`, and function files, as well as generating the component's own server-side `_generated/` imports. It supports multiple component shapes, such as local components for single-app use, packaged components for reuse across apps, and hybrid approaches for shared library code. The skill outlines a step-by-step workflow, including planning tables, functions, and data dependencies, integrating components via `app.use(...)`, and creating app-facing wrappers for clients or public APIs. It emphasizes maintaining boundaries and leveraging Convex's development tools like `npx convex dev` to ensure type safety and correct code generation.

This skill is intended for developers working with Convex who need to structure complex backend logic into reusable, isolated modules. Common use cases include building new components within an existing app, extracting reusable backend functions, creating third-party integrations with dedicated tables, or packaging functionality for reuse across multiple apps. Target users are full-stack developers, backend engineers, and teams using Convex who want to improve modularity, maintainability, and clarity in their app architecture.