umbraco-test-builders

Generate Umbraco backoffice JSON models with fluent builder classes.

1|Updated May 21, 2026

Search Tags:#e2e testing #umbraco #builder pattern #test data generation #json-models #block list #content seeding

Ready to run

npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-test-builders-1k-off

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: umbraco-test-builders
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/umbraco-test-builders
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-test-builders-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the tedium of manually crafting complex Umbraco backoffice JSON models by giving you fluent, chainable builders that generate valid test structures for documents, content, media, data types, and related entities.

Core Features & Use Cases

Build Umbraco backoffice models with fluent builders: Create document types, content variants, media items, data types, and permissions using a consistent builder pattern.
Rapid, structured test data creation for unit and E2E tests: Example use cases include assembling a full document type with groups/tabs and then producing content that matches it (including block list/grid values).
Support for complex content structures: Generate element types for block editors and compose nested block list entries/value builders with content element keys and property payloads.

Quick Start

Use the umbraco-test-builders skill to generate a full DocumentTypeBuilder and ContentBuilder object for your Umbraco tests with sensible defaults.

Frequently Asked Questions about umbraco-test-builders

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

FAQPage Schema

How do I generate valid Umbraco JSON models for automated testing?▼

You can generate valid Umbraco JSON models using fluent, chainable builder classes that produce deterministic backoffice entities like document types, content variants, and media for test setup and seeding.

What is the best way to create realistic Umbraco test data for E2E scenarios?▼

Creating realistic Umbraco test data involves using chainable builder configurations to assemble full document types and matching content, including nested block list and grid structures, for deterministic E2E test execution.

Can I use the builder pattern to set up complex Umbraco block list structures in tests?▼

Yes, you can use the builder pattern to generate element types for block editors and compose nested block list entries with correct content element keys and property payloads for your test data.

How do I build Umbraco content variants and media items for unit tests without manual JSON crafting?▼

You can build content variants and media items by applying chainable configuration methods such as withXxx and addXxx, ensuring correct model relationships via aliases, keys, and IDs without manual JSON crafting.

Does this approach to Umbraco test data generation support deterministic object output for content seeding?▼

Yes, the fluent builder classes provide deterministic object output suitable for test setup and content seeding, ensuring reliable and consistent test data generation across unit, integration, and E2E tests.