Registry / testing / uniforms-bridge-graphql

uniforms-bridge-graphql

library4.0.0-alpha.5jsnpmunverified

GraphQL schema bridge for the uniforms React form library. Current version 4.0.0-alpha.5. This bridge converts GraphQL schemas (using graphql-tag or introspection) into uniforms fields, enabling auto-generated forms from GraphQL types. It supports validation via GraphQL schema constraints and is designed for use with uniforms v4. The package is actively maintained as part of the vazco/uniforms monorepo. Key differentiator: allows building forms directly from GraphQL schemas without manual field definitions.

testing

npm install uniforms-bridge-graphql

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · UNIFORMS-BRIDGE-GR

uniforms-bridge-graphql

testingjavascriptv4.0.0-alpha.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GraphQLBridge

✓ import { GraphQLBridge } from 'uniforms-bridge-graphql'

✗ const GraphQLBridge = require('uniforms-bridge-graphql').GraphQLBridge

ESM-only; named export since v4. Do not use default import.

default

✓ import GraphQLBridge from 'uniforms-bridge-graphql'

✗ const GraphQLBridge = require('uniforms-bridge-graphql')

Default export is available as a convenience but named export is preferred.

GraphQLBridgeType

✓ import type { GraphQLBridge } from 'uniforms-bridge-graphql'

✗ import { GraphQLBridge } from 'uniforms-bridge-graphql'

Use type import for TypeScript to avoid runtime side effects.

Shows how to create a GraphQL bridge from introspection data and render a form using AutoForm.

import React from 'react'; import { AutoForm } from 'uniforms'; import { GraphQLBridge } from 'uniforms-bridge-graphql'; import { buildClientSchema } from 'graphql'; const schema = buildClientSchema(introspectionResult); const bridge = new GraphQLBridge(schema, { schemaType: 'Mutation', fields: ['addTask'], }); function TaskForm() { return ( <AutoForm schema={bridge} onSubmit={console.log} /> ); }

Debug

Known issues

breakingUniforms v4 migration: The bridge must be instantiated with 'new' keyword. Previous versions allowed factory function.

fix

Use 'new GraphQLBridge(schema, options)' instead of calling GraphQLBridge(schema, options) directly.

affects: >=4.0.0

deprecatedThe 'schemaType' option is deprecated in favor of 'rootType'.

fix

Replace 'schemaType' with 'rootType' in options.

affects: >=3.0.0 <4.0.0

gotchaGraphQL schema must be built with 'buildClientSchema' from graphql; raw introspection JSON won't work.

fix

Use 'buildClientSchema(introspectionResult)' to convert introspection data to a GraphQLSchema object.

affects: *

gotchaOnly fields of type String, Int, Float, Boolean, and Enum (as select) are supported. Custom scalars will be ignored.

fix

Ensure your GraphQL schema uses only supported scalar types for form fields.

affects: *

Errors

Common errors & fixes

Cannot find module 'uniforms-bridge-graphql'

Package not installed or outdated npm cache.

fix

Run 'npm install uniforms-bridge-graphql' and ensure your package.json includes it.

TypeError: GraphQLBridge is not a constructor

Using incorrect import or missing 'new' keyword.

fix

Use 'import { GraphQLBridge } from 'uniforms-bridge-graphql'' and instantiate with 'new GraphQLBridge(...)'.

Cannot read property 'fields' of undefined

Schema object not properly built or options missing rootType.

fix

Ensure you pass a valid GraphQLSchema object and include 'rootType: 'Mutation'' or 'rootType: 'Query'' in options.

Upgrade

Version history

4.0.0-alpha.5latest on npm

Audit

Dependencies

uniformsrequiredPeer dependency required for bridge to integrate with uniforms form system

graphqloptionalRequired for processing GraphQL schema definitions and types

Agent activity

9 hits · last 30 days

node

Resources

githubhttps://github.com/vazco/uniforms#master ↗

packageuniforms-bridge-graphql ↗

homepagehttps://github.com/vazco/uniforms/tree/master#readme ↗