dextinity-block

Creates and edits Dextinity CMS blocks across API, Admin, and Site layers from natural-language prompts.

52|9|Updated Mar 4, 2019
One-click install
npx skills add https://github.com/vivid-planet/dextinity --skill dextinity-block-vivid-planet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dextinity-block
Source: https://github.com/vivid-planet/dextinity/tree/main/skills/dextinity-block
Command: npx skills add https://github.com/vivid-planet/dextinity --skill dextinity-block-vivid-planet

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building a content block in a Dextinity project requires coordinated, convention-heavy changes across three layers (NestJS API, React Admin, Next.js Site) plus registration, migrations, and fixtures. This Skill turns a natural-language request into correctly structured block code in every layer, following project naming and validation rules. ## Core Features & Use Cases - Block scaffolding: Generates API block classes (BlockData/BlockInput with decorators and validators), Admin composite blocks with FormattedMessage labels, and Site components wrapped in withPreview. - Editing workflow: Classifies changes (add/remove/rename fields, change types, enum updates), decides whether a migration is needed, and applies edits consistently across all layers. - Fixtures and registration: Creates faker-based fixture services, wires them into parent fixtures and fixtures.module.ts, and registers blocks in PageContentBlock or other targets with matching camelCase keys. - Use Case: Ask to "create a teaser block with a title, image, and CTA link" and receive the API block file, Admin block, Site component, registration entries, and a fixture service, all following project conventions. ## Quick Start Ask the assistant to create a new Dextinity block named ProductCard with a title, an image, and a variant select field, and register it in the page content block.

Frequently Asked Questions about dextinity-block

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new Dextinity block from a prompt?

Describe the block name, its properties with types, and the registration target. The skill generates the API block file, Admin composite block, Site component, registers it in PageContentBlock, and creates a fixture service.

How do I add or change fields in an existing Dextinity block?

State the change, such as adding a field, renaming a property, or changing enum values. The skill classifies each change, decides whether a migration is needed, and updates the API, Admin, Site, and fixture code in order.

When is a migration needed for Dextinity block changes?

A migration is needed when adding a required field, changing a field type, removing a field, or renaming a field. It is not needed for optional nullable fields, new supported blocks in a BlocksBlock, or new enum values.

Which image block should I use in Dextinity: DamImageBlock, PixelImageBlock, or SvgImageBlock?

Use DamImageBlock for general images accepting raster and SVG, PixelImageBlock for raster-only with cropping, and SvgImageBlock for icons and logos. Use a project-specific MediaBlock when both images and video are needed.

Why must block name strings match across Dextinity API, Admin, and Site layers?

The name passed to createBlock, createCompositeBlock, and supportedBlocks keys must be identical PascalCase or camelCase across layers so block data serializes, renders, and previews correctly. Mismatched keys break rendering and admin editing.