Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/openfun/verna
🏗️ An extensible form builder based on React JSON Schema Form.
https://github.com/openfun/verna
Last synced: about 1 month ago
JSON representation
🏗️ An extensible form builder based on React JSON Schema Form.
- Host: GitHub
- URL: https://github.com/openfun/verna
- Owner: openfun
- License: mit
- Created: 2022-02-18T14:15:01.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T17:11:10.000Z (about 2 months ago)
- Last Synced: 2024-10-29T18:36:01.796Z (about 2 months ago)
- Language: TypeScript
- Homepage:
- Size: 3.07 MB
- Stars: 11
- Watchers: 7
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Verna
[](https://circleci.com/gh/openfun/verna/tree/main)
[](https://badge.fury.io/js/@openfun%2Fverna)
An extensible form builder based on [React JSON Schema Form](https://github.com/rjsf-team/react-jsonschema-form).
## Demos
To demonstrate verna capabilities, we developed several use case examples.
- Basic form playground:[👀 Live demo](https://openfun.github.io/verna/playground), [🧑💻 Source code](https://github.com/openfun/verna/tree/main/examples/playground)
- Poll form playground:[👀 Live demo](https://openfun.github.io/verna/poll), [🧑💻 Source code](https://github.com/openfun/verna/tree/main/examples/poll)
## Overview
Verna is a React component to build forms that generates a [JSON Schema](http://json-schema.org/)
description of the form as output. The form can then be rendered with the [React JSON Schema Form](https://github.com/rjsf-team/react-jsonschema-form)
library, which makes it fully extensible to fit your needs.
## Quick preview
You can check examples available within the `examples` folder. Take a loot at the
`README.md` file in each example then follow instructions to run it.
### Instructions
#### Install in our project
```sh
yarn add -E @openfun/verna
```
#### Test or contribute to the project
```sh
# -- Clone repository
git clone https://github.com/openfun/verna.git
cd verna
# -- Install dependencies
yarn install
# -- Run dev server
yarn dev
```
You should now be able to access the playground example from http://localhost:5173
### Project structure (Yarn workspaces)
This repository is a monorepo based on Yarn workspace to organize code.
Workspaces are located in two directories `lib` and `examples`. You can get info on all existing
workspace through `yarn workspaces info` command.
In `lib`, there is the `@openfun/verna` workspace that is the project itself which will be published
on npm then the `examples` directory aims to contain all the examples to demonstrate feature of
Verna.
#### Scripts
Through Yarn workspace, you are able to launch main commands from the root of this repository.
Here are the available commands:
- `yarn build`: Build the `@openfun/verna` library for production.
- `yarn dev`: Build and watch `@openfun/verna` library then start development server from the
example workspace define through the environment variable `VERNA_EXAMPLE` (by default it uses
`verna-examples-playground`, take a look at `examples` directory to see all examples available)
- `yarn lint`: Lint the code of all workspaces.
- `yarn test`: Run test suites from `@openfun/verna` workspace.
## Contributing
This project is intended to be community-driven, so please, do not hesitate to
get in touch if you have any question related to our implementation or design
decisions.
We try to raise our code quality standards and expect contributors to follow
the recommandations from our
[handbook](https://openfun.gitbooks.io/handbook/content).
### License
This work is released under the MIT License (see [LICENSE](./LICENSE)).