Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
.husky		.husky
bin		bin
libs		libs
.gitignore		.gitignore
.markdownlint.json		.markdownlint.json
.markdownlintignore		.markdownlintignore
.npmrc		.npmrc
.nvmrc		.nvmrc
.prettierignore		.prettierignore
.prettierrc		.prettierrc
CLAUDE.md		CLAUDE.md
COPYRIGHT		COPYRIGHT
Dockerfile.storybook		Dockerfile.storybook
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
commitlint.config.js		commitlint.config.js
eslint.config.mjs		eslint.config.mjs
jest.preset.js		jest.preset.js
nginx.conf		nginx.conf
nx.json		nx.json
package-lock.json		package-lock.json
package.json		package.json
tsconfig.base.json		tsconfig.base.json
vitest.workspace.ts		vitest.workspace.ts

Repository files navigation

GD Design System

Nx monorepo containing the GridKit design system packages.

Packages

Package	Version	Description
gd-design-library		GridKit React component library + design tokens
gd-form-configurator		JSON-Schema form engine (AJV + Zustand)
gd-form-configurator-react		React bindings for gd-form-configurator

Quick start

Install the primary package:

npm install gd-design-library

Import components and styles:

import { Button, ThemeProvider } from 'gd-design-library';
import 'gd-design-library/styles.css';

export default function App() {
  return (
    <ThemeProvider>
      <Button variant="primary">Click me</Button>
    </ThemeProvider>
  );
}

See the Storybook for interactive component examples and full API documentation.

Setup

# Node >= 22.17.0 required
npm install

Development

npm run storybook          # Storybook at http://localhost:6006
npm test                   # gd-design-library unit tests
npm run test:form-configurator   # form-configurator tests
npm run type-check         # TypeScript check
npm run lint               # ESLint

Build

npm run build:ui                # Build gd-design-library (ESM + CJS + types)
npm run build:form-configurator # Build both form-configurator packages
npm run build-storybook         # Build static Storybook

Verification (gd-design-library)

npm run verify:ui:full     # Full 10-phase dist verification + Verdaccio smoke test
npm run verify:ui:ci       # CI gate (non-zero exit on failure)

Publishing

# gd-design-library
npm run build:ui && npm run publish:ui

# form-configurator — via GitHub Actions (publish-form-configurator.yaml) or:
npm run build:form-configurator && npm run publish:form-configurator