frappe-fixture-creator_skill

Overview

This skill generates fixture JSON files for Frappe test data, master data, and initial site configuration. It helps create repeatable, versioned fixtures for automated tests, demo sites, or fresh installations. Use it to produce item records, hierarchical trees (customer groups, territories), and other doctypes ready for import.

How this skill works

The skill inspects requested doctypes and field values, then composes valid Frappe fixture arrays in JSON that match common patterns (flat records, parent/child trees, and importable lists). It can produce sample values, required fields, and optional metadata so fixtures load cleanly with Frappe's import tools. The output is ready to be dropped into app fixtures and invoked during setup or tests.

When to use it

• Creating repeatable test fixtures for automated unit or integration tests
• Seeding master data (items, customer groups, territories) for new sites
• Preparing demo or sample data for demos and user training
• Automating site setup steps in before_install or site provisioning
• Converting manual setup steps into version-controlled fixtures

Best practices

• Include only the minimal required fields for each doctype to avoid validation errors
• Use stable, descriptive keys (e.g., _Test Item) to avoid collisions with real data
• Model hierarchical doctypes with explicit parent references and is_group flags
• Keep fixtures idempotent: avoid changing primary keys or names that tests rely on
• Store fixtures under your app's fixtures/ folder and load them in before_install

Example use cases

• Generate a set of Item fixtures with stock and pricing for inventory tests
• Create a Customer Group tree that mirrors production segmentation for reports
• Produce territory and company fixtures to run full accounting flows in CI
• Build simple service and product records for sales order and billing tests
• Export curated master data from a sandbox into app fixtures for deployment