Praxis CRUD Screen Authoring
Use this skill to create fast, focused CRUD screens with @praxisui/crud. The CRUD component already orchestrates table, create/edit/view actions, open modes, and embedded form flows. Do not compose separate praxis-dynamic-form, praxis-table, praxis-list, praxis-tabs, or praxis-dynamic-page widgets unless the user explicitly asks for a composed dashboard or master-detail experience.
Operating Rules
- Read the repo
AGENTS.md files that apply before editing.
- Classify the change before editing:
local-pequena, transversal, arquitetural, contrato-publico, or docs-apenas.
- If the task touches public contracts, generated artifacts,
x-ui, /schemas/filtered, AI contracts, public APIs, examples, playgrounds, or more than one subproject, produce a short plan and impact map before editing.
- Prefer the platform-correct solution over local Angular shortcuts.
- Do not introduce keyword, regex, alias, or fuzzy-text routing as the primary intent decision mechanism.
- Do not create new DTOs, exported types, metadata fields, endpoints, or UI config contracts until you inventory what Praxis already knows.
First Questions
Ask only what is needed to resolve the canonical CRUD scope:
- What canonical Praxis resource or endpoint should this CRUD manage?
- What CRUD mode is expected: simple, operational, or workflow-oriented?
- Which open mode should the built-in CRUD forms use: modal, drawer, route, or the existing platform default?
If the user already provided the resource and objective, continue without asking.
Do not start by asking for colors, layout taste, or unrelated components. First resolve the resource semantics and the CrudMetadata.
Metadata Inventory
Before designing the CRUD screen, discover what the platform already exposes.
Check, when available:
- canonical resource key and base endpoint
/schemas/filtered
/schemas/surfaces
/schemas/actions
- collection and item capabilities
- HATEOAS links
x-ui
- labels, descriptions, field types, validations, required fields
- option sources, async selects, entity lookups used by the built-in form
- allowed create/edit/view/delete/workflow actions
- ETag and required headers
- existing CRUD examples, labs, playgrounds, or docs for the same resource
Use praxis-core-resource-runtime when CRUD behavior depends on core schema discovery,
GenericCrudService, capabilities, actions, HATEOAS links, option sources, related-resource
surfaces, or CRUD operation resolution. Use praxis-core-runtime-contracts if the task touches
core public API, tokens, providers, or shared model contracts.
Use praxis-crud-runtime-openmodes when the task changes @praxisui/crud runtime behavior, open
modes, drawer adapter, launcher inputs, or table/form orchestration. Use praxis-crud-ai-authoring
when the task changes CRUD authoring documents, config editors, manifests, capabilities, or child
operation delegation. Use praxis-dialog-overlay-runtime or praxis-dialog-global-actions-ai when
the CRUD flow depends on dialog shell behavior, presets, registries, or global dialog actions.
For each relevant improvement, classify adherence:
ja-suportado-so-ux
ja-suportado-mal-nomeado-ou-mal-materializado
suportado-parcialmente
lacuna-real-de-contrato
Only lacuna-real-de-contrato justifies a new contract. If there is a real gap, state what behavior cannot be implemented correctly, which canonical source owns the missing data, which consumers are affected, which derived artifacts change, and what minimal validation proves the contract.
Component Boundary
This skill is for @praxisui/crud only.
Use:
PraxisCrudComponent
CrudMetadata
metadata.resource.path
metadata.resource.idField
metadata.table
metadata.actions
metadata.defaults.openMode
crudId
enableCustomization
- built-in create/edit/view form launchers through CRUD actions
Do not use these unless explicitly requested:
DynamicWidgetPageComponent
- direct
praxis-dynamic-form next to the CRUD
- direct
praxis-table next to the CRUD
- direct
praxis-list next to the CRUD
- direct
praxis-tabs, praxis-expansion, charts, steppers, or custom dashboards
If the user asks for those, use or create a separate composed-screen/master-detail skill. Do not stretch this CRUD skill into an application builder.
When the CRUD screen depends on richer table behavior inside PraxisCrudComponent, use praxis-table-runtime-data for table runtime/data-mode/export concerns, praxis-table-filter-actions for filters and row/toolbar/bulk actions, and praxis-table-authoring-settings for table editor or Settings Panel parity.
When CRUD opens or embeds richer Dynamic Form behavior, use praxis-form-runtime-submit for schema/submit/runtime contracts, praxis-form-authoring-settings for form editor round-trip, and praxis-form-layout-canvas for schema-driven form layout or visual blocks.
CRUD Experience Selection
Select the smallest CRUD experience that fits the workflow:
- Simple CRUD: resource metadata plus default table and built-in create/edit/view form actions.
- Operational CRUD: dense table, primary columns, advanced filters, toolbar action, row actions, export, and modal/drawer forms.
- Workflow-oriented CRUD: CRUD plus canonical workflow actions already exposed by metadata/actions/capabilities.
Prefer modal or drawer forms for fast CRUD flows. Prefer route forms only when the existing app pattern or resource complexity requires it.
UI Composition Guidance
For a non-trivial CRUD, produce a short proposal before implementation:
- resource endpoint and id field
- primary table columns
- filters and search scope
- toolbar actions
- row actions
- create/edit/view open mode
- built-in form ids
- metadata/capability evidence behind important choices
Keep the screen usable and direct. A CRUD skill should accelerate development, so avoid elaborate wrapper layouts, dashboards, or multi-widget pages.
Implementation Workflow
- Inspect existing app routes, feature conventions, and local
AGENTS.md.
- Inspect the target resource metadata and existing CRUD examples.
- Decide whether this is a local CRUD host, a reusable
@praxisui/crud fix, or a contract/platform change.
- Implement a standalone Angular component that hosts
<praxis-crud>.
- Pass a focused
CrudMetadata object with resource, table, actions, and defaults.
- Use the CRUD component's built-in form launchers for create/edit/view.
- Update derived artifacts only if public examples, docs, manifests, playgrounds, or AI surfaces are affected.
- Run the smallest reliable validation for the changed scope.
For praxis-ui-angular, prefer focused builds or tests for the affected app feature or @praxisui/crud lib. For public API or cross-lib changes, also validate a direct consumer. Do not use GitHub Actions as the normal development validation path.
Route Lab Convention
When creating routes to test this skill inside the Angular workspace, prefer:
praxis-ui-angular/src/app/features/skills-lab/
Keep skill test routes isolated from existing demos unless the task explicitly promotes the example to an official demo, recipe, or playground. Prefer a local route file such as skills-lab.routes.ts inside that folder. Do not wire the route into src/app/app.routes.ts when local repo rules restrict edits outside src/app/features/**; leave the route candidate exported and ask for explicit authorization before editing the root app route table.
Completion Checklist
Before finishing, state:
- canonical resource or endpoint used
- metadata/capability surfaces inspected, or why they were unavailable
- adherence classification for notable gaps
@praxisui/crud inputs/actions/open mode used
- files changed
- validation run
- derived artifacts updated, or why none were required
1---2name: praxis-rich-crud-screen-authoring3description: Create focused CRUD screens with the @praxisui/crud Angular component using canonical Praxis resource metadata, endpoints, table configuration, built-in form launchers, open modes, capabilities, and actions. Use when the user asks to scaffold, improve, or test a standard Praxis CRUD screen, backoffice resource management page, table-plus-create-edit-view flow, modal/drawer CRUD form flow, or fast CRUD screen powered by Praxis UI Angular.4metadata:5 source: https://skillmd.com/skills/codexrodrigues/praxis-rich-crud-screen-authoring6---78# Praxis CRUD Screen Authoring910Use this skill to create fast, focused CRUD screens with `@praxisui/crud`. The CRUD component already orchestrates table, create/edit/view actions, open modes, and embedded form flows. Do not compose separate `praxis-dynamic-form`, `praxis-table`, `praxis-list`, `praxis-tabs`, or `praxis-dynamic-page` widgets unless the user explicitly asks for a composed dashboard or master-detail experience.1112## Operating Rules1314- Read the repo `AGENTS.md` files that apply before editing.15- Classify the change before editing: `local-pequena`, `transversal`, `arquitetural`, `contrato-publico`, or `docs-apenas`.16- If the task touches public contracts, generated artifacts, `x-ui`, `/schemas/filtered`, AI contracts, public APIs, examples, playgrounds, or more than one subproject, produce a short plan and impact map before editing.17- Prefer the platform-correct solution over local Angular shortcuts.18- Do not introduce keyword, regex, alias, or fuzzy-text routing as the primary intent decision mechanism.19- Do not create new DTOs, exported types, metadata fields, endpoints, or UI config contracts until you inventory what Praxis already knows.2021## First Questions2223Ask only what is needed to resolve the canonical CRUD scope:24251. What canonical Praxis resource or endpoint should this CRUD manage?262. What CRUD mode is expected: simple, operational, or workflow-oriented?273. Which open mode should the built-in CRUD forms use: modal, drawer, route, or the existing platform default?2829If the user already provided the resource and objective, continue without asking.3031Do not start by asking for colors, layout taste, or unrelated components. First resolve the resource semantics and the `CrudMetadata`.3233## Metadata Inventory3435Before designing the CRUD screen, discover what the platform already exposes.3637Check, when available:3839- canonical resource key and base endpoint40- `/schemas/filtered`41- `/schemas/surfaces`42- `/schemas/actions`43- collection and item capabilities44- HATEOAS links45- `x-ui`46- labels, descriptions, field types, validations, required fields47- option sources, async selects, entity lookups used by the built-in form48- allowed create/edit/view/delete/workflow actions49- ETag and required headers50- existing CRUD examples, labs, playgrounds, or docs for the same resource5152Use `praxis-core-resource-runtime` when CRUD behavior depends on core schema discovery,53`GenericCrudService`, capabilities, actions, HATEOAS links, option sources, related-resource54surfaces, or CRUD operation resolution. Use `praxis-core-runtime-contracts` if the task touches55core public API, tokens, providers, or shared model contracts.56Use `praxis-crud-runtime-openmodes` when the task changes `@praxisui/crud` runtime behavior, open57modes, drawer adapter, launcher inputs, or table/form orchestration. Use `praxis-crud-ai-authoring`58when the task changes CRUD authoring documents, config editors, manifests, capabilities, or child59operation delegation. Use `praxis-dialog-overlay-runtime` or `praxis-dialog-global-actions-ai` when60the CRUD flow depends on dialog shell behavior, presets, registries, or global dialog actions.6162For each relevant improvement, classify adherence:6364- `ja-suportado-so-ux`65- `ja-suportado-mal-nomeado-ou-mal-materializado`66- `suportado-parcialmente`67- `lacuna-real-de-contrato`6869Only `lacuna-real-de-contrato` justifies a new contract. If there is a real gap, state what behavior cannot be implemented correctly, which canonical source owns the missing data, which consumers are affected, which derived artifacts change, and what minimal validation proves the contract.7071## Component Boundary7273This skill is for `@praxisui/crud` only.7475Use:7677- `PraxisCrudComponent`78- `CrudMetadata`79- `metadata.resource.path`80- `metadata.resource.idField`81- `metadata.table`82- `metadata.actions`83- `metadata.defaults.openMode`84- `crudId`85- `enableCustomization`86- built-in create/edit/view form launchers through CRUD actions8788Do not use these unless explicitly requested:8990- `DynamicWidgetPageComponent`91- direct `praxis-dynamic-form` next to the CRUD92- direct `praxis-table` next to the CRUD93- direct `praxis-list` next to the CRUD94- direct `praxis-tabs`, `praxis-expansion`, charts, steppers, or custom dashboards9596If the user asks for those, use or create a separate composed-screen/master-detail skill. Do not stretch this CRUD skill into an application builder.9798When the CRUD screen depends on richer table behavior inside `PraxisCrudComponent`, use `praxis-table-runtime-data` for table runtime/data-mode/export concerns, `praxis-table-filter-actions` for filters and row/toolbar/bulk actions, and `praxis-table-authoring-settings` for table editor or Settings Panel parity.99100When CRUD opens or embeds richer Dynamic Form behavior, use `praxis-form-runtime-submit` for schema/submit/runtime contracts, `praxis-form-authoring-settings` for form editor round-trip, and `praxis-form-layout-canvas` for schema-driven form layout or visual blocks.101102## CRUD Experience Selection103104Select the smallest CRUD experience that fits the workflow:105106- Simple CRUD: resource metadata plus default table and built-in create/edit/view form actions.107- Operational CRUD: dense table, primary columns, advanced filters, toolbar action, row actions, export, and modal/drawer forms.108- Workflow-oriented CRUD: CRUD plus canonical workflow actions already exposed by metadata/actions/capabilities.109110Prefer modal or drawer forms for fast CRUD flows. Prefer route forms only when the existing app pattern or resource complexity requires it.111112## UI Composition Guidance113114For a non-trivial CRUD, produce a short proposal before implementation:115116- resource endpoint and id field117- primary table columns118- filters and search scope119- toolbar actions120- row actions121- create/edit/view open mode122- built-in form ids123- metadata/capability evidence behind important choices124125Keep the screen usable and direct. A CRUD skill should accelerate development, so avoid elaborate wrapper layouts, dashboards, or multi-widget pages.126127## Implementation Workflow1281291. Inspect existing app routes, feature conventions, and local `AGENTS.md`.1302. Inspect the target resource metadata and existing CRUD examples.1313. Decide whether this is a local CRUD host, a reusable `@praxisui/crud` fix, or a contract/platform change.1324. Implement a standalone Angular component that hosts `<praxis-crud>`.1335. Pass a focused `CrudMetadata` object with resource, table, actions, and defaults.1346. Use the CRUD component's built-in form launchers for create/edit/view.1357. Update derived artifacts only if public examples, docs, manifests, playgrounds, or AI surfaces are affected.1368. Run the smallest reliable validation for the changed scope.137138For `praxis-ui-angular`, prefer focused builds or tests for the affected app feature or `@praxisui/crud` lib. For public API or cross-lib changes, also validate a direct consumer. Do not use GitHub Actions as the normal development validation path.139140## Route Lab Convention141142When creating routes to test this skill inside the Angular workspace, prefer:143144`praxis-ui-angular/src/app/features/skills-lab/`145146Keep skill test routes isolated from existing demos unless the task explicitly promotes the example to an official demo, recipe, or playground. Prefer a local route file such as `skills-lab.routes.ts` inside that folder. Do not wire the route into `src/app/app.routes.ts` when local repo rules restrict edits outside `src/app/features/**`; leave the route candidate exported and ask for explicit authorization before editing the root app route table.147148## Completion Checklist149150Before finishing, state:151152- canonical resource or endpoint used153- metadata/capability surfaces inspected, or why they were unavailable154- adherence classification for notable gaps155- `@praxisui/crud` inputs/actions/open mode used156- files changed157- validation run158- derived artifacts updated, or why none were required