metaobjects-runtime-ui

Wire MetaObjects generated code into runtime queries, REST routes, and web client components.

1|Updated May 14, 2026
One-click install
npx skills add https://github.com/metaobjectsdev/metaobjects --skill metaobjects-runtime-ui-metaobjectsdev
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: metaobjects-runtime-ui
Source: https://github.com/metaobjectsdev/metaobjects/tree/main/agent-context/skills/metaobjects-runtime-ui
Command: npx skills add https://github.com/metaobjectsdev/metaobjects --skill metaobjects-runtime-ui-metaobjectsdev

SYSTEM DOCUMENTATION & REQUIREMENTS

πŸ’‘ This Skill includes references (resource) components.

What problem does it solve? Connecting MetaObjects-generated code to a running application requires knowing the cross-port runtime contracts β€” how queries return native types, how REST routes are mounted, and how the universal web client consumes them β€” and getting any of these wrong produces silent drift between layers. ## Core Features & Use Cases - Runtime query wiring: Pass persistence contexts explicitly into generated CRUD helpers and use generated names artifacts instead of literal table or column names. - Cross-port REST contract: Serve the standard five CRUD endpoints with filter operators, sort, pagination, and wire-format rules (integer minor units for currency, ISO-8601 temporals) across TypeScript, Java, Kotlin, C#, and Python backends. - Universal web client: Supply a single EntityFetcher at the app root so generated TanStack Query hooks, forms, and opt-in data grids work against any backend language. - Use Case: You generated an Author entity with MetaObjects and need to mount Fastify routes, implement the repository against your database, and render a sortable, filterable grid in React β€” this skill walks through each layer with per-language reference fragments. ## Quick Start Use the metaobjects-runtime-ui skill to wire my generated Author entity into REST routes and a React grid against my Postgres database.

Frequently Asked Questions about metaobjects-runtime-ui

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

FAQPage Schema
How do I wire MetaObjects generated code into a REST API?β–Ό

Mount the generated routes for your stack β€” routesFile for Fastify, Spring controllers for Java, FastAPI routers for Python, or ASP.NET minimal APIs for C#. Each emits the five CRUD endpoints with filter, sort, and pagination query parameters on the shared cross-port contract.

How do I connect a React frontend to a MetaObjects backend?β–Ό

Provide a single EntityFetcher function at the app root via EntityFetcherProvider; every generated TanStack Query hook reads it from context. The fetcher resolves paths, attaches auth, parses JSON, and throws on non-2xx responses.

Why are no grid files generated for my entity?β–Ό

Grid artifacts are opt-in per entity and only emitted when the entity declares a layout.dataGrid child in metadata. Add one with a columns list, then pair the columns generator with the grid-hook generator for the state plumbing.

Should I use literal table and column names in raw SQL?β–Ό

No. Reference the generated names artifact such as ProgramNames.fields.createdAt.column, since @column mappings are free-form and a metadata rename updates the constant but not a literal. The names generator is opt-in and must be wired first.

How does MetaObjects handle currency and decimal values on the wire?β–Ό

Currency is transmitted as integer minor units and decimals use exact native types like BigDecimal or Decimal in-process, with TypeScript returning decimal as a string. Canonicalization happens only at the HTTP serialization boundary, never inside the query path.