{"id":14973785,"url":"https://github.com/siebevh/cheetah-forms","last_synced_at":"2025-10-27T02:31:34.493Z","repository":{"id":35151328,"uuid":"213219271","full_name":"siebevh/Cheetah-forms","owner":"siebevh","description":"Cheetah Forms is a simple JSON form builder for generating a Vuetify Form with just a JSON.","archived":false,"fork":false,"pushed_at":"2023-01-05T23:17:31.000Z","size":1990,"stargazers_count":11,"open_issues_count":9,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-11T09:04:09.214Z","etag":null,"topics":["composition-api","form","forms","json","json-form","json-forms","json-schema","vue3","vuejs2","vuetify"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/siebevh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-06T18:13:22.000Z","updated_at":"2023-05-01T17:29:00.000Z","dependencies_parsed_at":"2023-01-15T14:51:21.633Z","dependency_job_id":null,"html_url":"https://github.com/siebevh/Cheetah-forms","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siebevh%2FCheetah-forms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siebevh%2FCheetah-forms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siebevh%2FCheetah-forms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siebevh%2FCheetah-forms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siebevh","download_url":"https://codeload.github.com/siebevh/Cheetah-forms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219861939,"owners_count":16555980,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["composition-api","form","forms","json","json-form","json-forms","json-schema","vue3","vuejs2","vuetify"],"created_at":"2024-09-24T13:49:24.532Z","updated_at":"2025-10-27T02:31:29.176Z","avatar_url":"https://github.com/siebevh.png","language":"Vue","funding_links":["https://www.buymeacoffee.com/pk6IU5J"],"categories":[],"sub_categories":[],"readme":"\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n\n# Cheetah forms\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\u003ca href=\"https://www.buymeacoffee.com/pk6IU5J\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: 41px !important;width: 174px !important;box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;-webkit-box-shadow: 0px 3px 2px 0px rgba(190, 190, 190, 0.5) !important;\" \u003e\u003c/a\u003e\n\n\u003cbr /\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/siebevh/Cheetah-forms\"\u003e\n    \u003cimg src=\"./images/logo.png\" alt=\"Logo\" width=\"200\" height=\"200\"\u003e\n  \u003c/a\u003e\n\n  \u003ch3 align=\"center\"\u003eCheetah Forms\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    An Json Based Form Generator for Vuetify!\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/siebevh/Cheetah-forms\"\u003e\u003cstrong\u003eExplore the docs »\u003c/strong\u003e\u003c/a\u003e\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://www.cheetah-form.site\"\u003eView Demo\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/siebevh/Cheetah-forms/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/siebevh/Cheetah-forms/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n## Table of Contents\n\n* [About the Project](#about-the-project)\n  * [Built With](#built-with)\n* [Getting Started](#getting-started)\n  * [Prerequisites](#prerequisites)\n  * [Installation](#installation)\n* [Usage](#usage)\n* [Roadmap](#roadmap)\n* [Contributing](#contributing)\n* [License](#license)\n* [Contact](#contact)\n* [Acknowledgements](#acknowledgements)\n\n\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n## About The Project\n\nCheetah Forms is a simple JSON form builder for generating a Vuetify Form with just a JSON. \nCheetah Forms uses Vuetify to make you form a Material designed form\n\n#### Fields Form\n![fields Form](./images/fields-form.png)\n\n#### Groups Form\n![groups Form](./images/groups-form.png)\n\n#### Features:\n  * JSON based\n  * Grid support\n  * Default fields\n  * Validation\n  * Default style\n\n### Built With\n* [Vuetify (v1.5)](https://vuetifyjs.com/en/)\n* [Vue](https://vuejs.org/)\n\n\n\n\u003c!-- GETTING STARTED --\u003e\n## Getting Started\n\n\n### Prerequisites\n\nThis is an example of how to list things you need to use the software and how to install them.\n* npm\n```sh\nnpm install npm@latest -g\n```\n\n### Installation\n\n\n1. Install NPM packages\n```sh\nnpm install cheetah-form\n```\n\n\n\u003c!-- USAGE EXAMPLES --\u003e\n## Usage\n\n### Basic usage\n```\n    \u003ccheetah-form :schema=\"schema\" :model=\"model\" @save=\"save\"\u003e\u003c/cheetah-form\u003e\n```\n##### with:\n * `schema`: the json configuration of the form (required)\n * `model`: the starting value of your model (required)\n * `@save`: event for handeling the save (returns edited model)\n \n### JSON FORM FORMAT\n```\n{\n    \"code\": \"profile-parent\",\n    \"title\": \"title\",\n    \"subtitle\": \"subtitle\",\n    \"fields\": [{\n        \"type\": \"text-field\",\n        \"name\": \"Naam\",\n        \"required\": true,\n        \"model\": \"name\",\n        \"cols\": {...}\n    },\n    \"groups\": []\n}\n\n```\n##### with:\n * `code`: the form unique code\n * `title`: the title of the form (optional)\n * `subtitle`: ths subtitle of the form (optional)\n * `fields`:  array of fields for the form (is ignored is groups has a value)\n * `groups`: when you want to create a form of multiple parts use groups\n\n### JSON FIELD FORMAT\n```\n{\n    \"type\": \"text-field\",\n    \"name\": \"Name\",\n    \"required\": true,\n    \"disabled\": false,\n    \"placeholder\": 'placeholder',\n    \"hint\": 'hint',\n    \"model\": \"user.name\",\n    \"prefix\": \"+32\",\n    \"cols\": 12\n}\n\n```\n##### with:\n * `type`: the type of field (check suported types) (required)\n * `name`: the label of the field (required) \n * `model`: model in doted notation (required)\n * `required`: if the field is required or not (optional)\n * `disabled`: if the field is disabled or not (optional)\n * `placeholder`: the placeholder (optional)\n * `hint`: the hint (optional)\n * `prefix`: a prefix added before the field (optional)\n * `cols`: the width of the field (1-12, default: 12) \n \n### JSON GROUP FORMAT\n```\n{\n    \"id\": 1,\n    \"title\": \"Name\",\n    \"fields\": [],\n}\n\n```\n##### with:\n * `id`: id of the group (required)\n * `title`: the title of the group (required)\n * `fields`: array of fields (see Json Field format) (required)\n \n### SUPPORTED TYPES\n * `text-field`: a normal text field\n    ###### special additional options: \n   * number field\n        ```\n        attributes: {\n            type: 'number',\n            min: 1000\n            max: 1000\n        }\n        ```\n * `textarea`: a normal textarea\n    ###### special additional options: \n      \n * `select`: a normal select\n     ###### special additional options: \n     * string items\n        ```\n         items: ['Men', 'Woman']\n        ```\n     \n     * object items\n        ```\n        itemValue: 'key',\n        itemText: 'label',\n        items: [{\n          'label': 'label',\n          'key': 'someKey',\n        },{\n          'label': 'label2',\n          'key': 'someKey2',\n        }]\n          ```\n          \n * `combobox`: a combobox\n      ###### special additional options: \n      * string items\n         ```\n          items: ['Men', 'Woman']\n         ```\n      \n      * object items\n         ```\n         itemValue: 'key',\n         itemText: 'label',\n         items: [{\n           'label': 'label',\n           'key': 'someKey',\n         },{\n           'label': 'label2',\n           'key': 'someKey2',\n         }]\n           ```\n          \n * `toggler`: a switch\n      ###### special additional options: \n      \n * `radio`: radio \n      ###### special additional options: \n      * object items\n          ```\n              options: [{\n                'label': 'label',\n                'value': 'someKey',\n              },{\n                'label': 'label2',\n                'value': 'someKey2',\n              }]\n          ```\n \n * `checkbox`: a simple checkbox \n       ###### special additional options: \n       \n * `password`: a password input field with hide and reviel option\n       ###### special additional options: \n\n\u003c!-- ROADMAP --\u003e\n## Roadmap\n\nSee the [open issues](https://github.com/siebevh/Cheetah-forms/issues) for a list of proposed features (and known issues).\n\n\u003c!-- CONTRIBUTING --\u003e\n## Contributing\n\nContributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\n\n\u003c!-- LICENSE --\u003e\n## License\n\nDistributed under the MIT License. See `LICENSE` for more information.\n\n\n\n\u003c!-- CONTACT --\u003e\n## Contact\n\nSiebe Vander Henst - [@vh_siebe](https://twitter.com/vh_siebe) - vhsiebe@gmail.com\n\nProject Link: [https://github.com/siebevh/Cheetah-forms](https://github.com/siebevh/Cheetah-forms)\n\n\n\n\u003c!-- ACKNOWLEDGEMENTS --\u003e\n## Acknowledgements\n\n\n\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/siebevh/Cheetah-forms.svg\n[contributors-url]: https://github.com/siebevh/Cheetah-forms/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/siebevh/Cheetah-forms.svg\n[forks-url]: https://github.com/siebevh/Cheetah-forms/network/members\n[stars-shield]: https://img.shields.io/github/stars/siebevh/Cheetah-forms.svg\n[stars-url]: https://github.com/siebevh/Cheetah-forms/stargazers\n[issues-shield]: https://img.shields.io/github/issues/siebevh/Cheetah-forms.svg\n[issues-url]: https://github.com/siebevh/Cheetah-forms/issues\n[license-shield]: https://img.shields.io/github/license/siebevh/Cheetah-forms\n[license-url]: https://github.com/siebevh/Cheetah-forms/blob/master/LICENSE.txt\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiebevh%2Fcheetah-forms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiebevh%2Fcheetah-forms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiebevh%2Fcheetah-forms/lists"}