nostrstack-embed-ui
Nostrstack embed UI and design system guidance for @nostrstack/embed, @nostrstack/blog-kit, and apps/gallery. Use when editing widgets, tokens, CSS classes, or gallery UI behavior.
When & Why to Use This Skill
The Nostrstack Embed UI skill is a specialized developer assistant designed to streamline frontend development and maintain design system integrity within the Nostrstack ecosystem. It provides expert guidance for implementing UI components, managing CSS design tokens, and adhering to specific UI specifications for packages like @nostrstack/embed and @nostrstack/blog-kit. By enforcing the use of standardized primitives and motion guidelines, it ensures visual consistency and high-quality user experiences across all gallery and embed applications.
Use Cases
- Developing and styling new widgets for @nostrstack/embed while ensuring strict adherence to the centralized design system tokens.
- Refactoring legacy CSS in the blog-kit package to replace hard-coded values with standardized .nostrstack-* primitive classes.
- Implementing complex UI behaviors in the gallery app, such as zap interfaces or QR code displays, based on detailed ui-specs.md documentation.
- Performing UI regression checks and verifying motion durations to ensure accessibility and performance standards are met.
| name | nostrstack-embed-ui |
|---|---|
| description | Nostrstack embed UI and design system guidance for @nostrstack/embed, @nostrstack/blog-kit, and apps/gallery. Use when editing widgets, tokens, CSS classes, or gallery UI behavior. |
Embed UI + Design System
Use this skill for UI work in packages/embed, packages/blog-kit, and apps/gallery.
Workflow
- Read
references/design-system.mdfor tokens, CSS variables, and component classes. - Use
references/ui-specs.mdfor specific UI specs (event landing, zap UI, QR, etc.). - Verify UI changes with Chrome DevTools MCP (or QA fallback per dev workflow).
Guardrails
- Prefer design tokens and
.nostrstack-*primitives over hard-coded colors. - Keep motion within defined durations/easings and respect reduced motion.
- Gallery should act as the canary for embed UI regressions.