velt-activity-best-practices
Installation
SKILL.md
Velt Activity Logs Best Practices
Comprehensive implementation guide for Velt's activity log system in React and Next.js applications. Contains 13 rules across 7 categories, prioritized by impact to guide automated code generation and integration patterns.
When to Apply
Reference these guidelines when:
- Adding real-time activity feeds to a React/Next.js application
- Subscribing to collaboration events via useAllActivities or getAllActivities
- Creating custom activity records for non-Velt events
- Configuring CRDT activity debounce to reduce feed noise
- Enabling immutability for compliance audit trails
- Filtering activities by feature type or action type
- Managing activity records server-side via REST API
- Customizing the Activity Log wireframe with template variables (
velt-data,velt-if,velt-class) - Composing the
VeltActivityLogWireframesub-component tree (Header, Filter, List, DateGroup, Item, ShowMore, Empty, Loading) - Debugging activity log issues (records not appearing, null loading states)