Skip to content

Customizable JSON Schema-based forms with React, Angular and Vue support out of the box.

License

Notifications You must be signed in to change notification settings

eclipsesource/jsonforms

Repository files navigation

JSON Forms - More Forms. Less Code

Complex forms in the blink of an eye

Documentation

Please see the official JSON Forms website, jsonforms.io, for documentation, examples and API references.

Getting started

  1. Clone the seed app with git clone https://github.com/eclipsesource/jsonforms-react-seed.git
  2. Install dependencies with npm ci
  3. Run the app with npm run start

For more info about the seed app, please see the corresponding README file of the seed repo. For a more detailed tutorial about the usage of JSON Forms, please see this tutorial.

Feedback, Help and Support

If you encounter any problems feel free to open an issue on the repo. For questions and discussions please use the JSON Forms board. You can also reach us via email. In addition, EclipseSource also offers professional support for JSON Forms.

Migration

See our migration guide when updating JSON Forms.

Roadmap & Milestones

The project roadmap can be found in ROADMAP.md.

Issues are sorted in one the following milestones that indicate when their implementation is planned. Independently of the assigned milestone, contributions are always accepted and appreciated.

  • A milestone for the next minor version. Issues planned to be implemented for the next release.
  • A milestone for the next major version. Issues planned to be implemented for the next major release.
  • A .x milestone. Issues which are concrete candidates for one of the next versions.
  • next: Issues which we would like to tackle soonish in one of the upcoming versions. However, they are not yet planned for a specific version.
  • Backlog: Issues which are interesting in some form but we don't plan to do ourselves in the foreseeable future. Still these might become part of JSON Forms via a community contribution or by prioritization of a paying customer.

Developers Documentation

First time setup

  • Install node.js (only Node v18.19+ < 19 is currently supported)
  • Install pnpm: https://pnpm.io/installation (use pnpm 8.6.2+)
  • Clone this repository
  • Install dependencies: pnpm i --frozen-lockfile

VS Code dev container

As an alternative to the first time setup, you can use the provided VS Code dev container configured in devcontainer.json.

  • Execute command: Remote Containers: Reopen in container
  • Wait until the container is built and loaded
  • First time setup and an initial build of all packages has been executed in the container

Note: If you have installed dependencies before opening the remote container, its initialization might fail. In this case, you can try to clean the repository with git clean -dfx. Beware that this removes all untracked files!

Build & Testing

  • Build (all packages): pnpm run build
  • Test (all packages): pnpm run test
  • Clean (delete dist folder of all packages): pnpm run clean
  • Run React Vanilla examples: cd packages/vanilla-renderers && pnpm run dev
  • Run React Material examples: cd packages/material-renderers && pnpm run dev
  • Run Angular Material examples: cd packages/angular-material && pnpm run dev
  • Run Vue Vanilla dev setup: cd packages/vue-vanilla && pnpm run serve
  • Run Vue Vuetify dev setup: cd packages/vue-vuetify && pnpm run dev

Dependency & Release management

For more info about how we handle dependencies and releases in the JSON Forms project, please see our Developer Documentation wiki page.

Continuous Integration

The JSON Forms project is built and tested via Github actions on Linux, Mac and Windows. Coverage is documented by Coveralls.

Current status: Build status Coverage Status

Contributions

We welcome community participation! Whether you're reporting bugs, proposing features, participating in discussions, or making direct contributions, your involvement is highly valued. See here for the contribution guidelines.

License

The JSON Forms project is licensed under the MIT License. See the LICENSE file for more information.