{"id":19190000,"url":"https://github.com/ixoncloud/component-workspace","last_synced_at":"2025-06-26T03:35:10.020Z","repository":{"id":120558697,"uuid":"430678608","full_name":"ixoncloud/component-workspace","owner":"ixoncloud","description":"Mirror of our Component SDK workspace","archived":false,"fork":false,"pushed_at":"2025-04-22T13:53:55.000Z","size":27,"stargazers_count":16,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-22T14:49:30.038Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://support.ixon.cloud/hc/en-us/articles/4408441416722-Custom-Components","language":null,"has_issues":false,"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/ixoncloud.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-11-22T11:25:20.000Z","updated_at":"2025-04-22T14:43:26.000Z","dependencies_parsed_at":"2024-04-30T11:42:43.835Z","dependency_job_id":"3979d533-0b16-479c-8ff0-a27b9718a3c3","html_url":"https://github.com/ixoncloud/component-workspace","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ixoncloud/component-workspace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fcomponent-workspace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fcomponent-workspace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fcomponent-workspace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fcomponent-workspace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ixoncloud","download_url":"https://codeload.github.com/ixoncloud/component-workspace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fcomponent-workspace/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261995472,"owners_count":23242202,"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":[],"created_at":"2024-11-09T11:32:34.487Z","updated_at":"2025-06-26T03:35:10.012Z","avatar_url":"https://github.com/ixoncloud.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# IXON Custom Component Workspace\n\nWelcome to your workspace for developing UI Components for the IXON Cloud. Note that creating UI Components requires you to be able to write JavaScript or Typescript code, and that you are familiar with the [Node.js](https://nodejs.org/) ecosystem. Experience with a web framework such as [Vue](https://vuejs.org/) or [Svelte](https://svelte.dev/) will come in handy as well.\n\nThis workspace will contain the UI Components that you've developed. You can check this workspace, with your UI Components, into your preferred versioning system. To do so, you can download this repository as a ZIP file, or use `degit`, as shown below. You don't need to fork this repository, as the actual Software Development Kit (SDK) will be installed into your `node_modules`, and you can install updates using `npm` as you normally do. You can access the SDK via the `npx cdk` scripts, as shown later in this guide.\n\nTo create a new project based on this template using degit:\n```sh\nnpx degit ixoncloud/component-workspace my-project\ncd my-project\n```\n\nNote that you will need to have [Node.js](https://nodejs.org/) and [Git](https://git-scm.com/) installed.\n\n## Getting started\n\nInstall the dependencies...\n\n```sh\nnpm install\n```\n\nNow you can generate your first component. Choose a name for the component. It must be lowercase and cannot contain spaces or special characters. Dashes (`-`) may be used to break up words. For example `'my-component'`.\n\n```sh\nnpx cdk generate my-component\n```\n\nYou will be prompted to select a template. Upon completion, you will find the source files for your newly created component in the `/components` directory.\n\nTo actually view and test your component, run the following command...\n\n```sh\nnpx cdk simulate my-component\n```\n\n...this opens the simulator app in a browser and builds your component in watch-mode, which means that any changes to the component source files will trigger a rebuild and will auto-reload the simulator. It is also possible to test your component with platform data by configuring this in the simulator settings.\n\n## Documentation\n\nTo check out docs and examples on how to develop a UI Component, visit [UI Component Development Docs](https://developer.ixon.cloud/docs/getting-started-ui-components).\n\nThe [@ixon-cdk/runner](https://www.npmjs.com/package/@ixon-cdk/runner) page has a complete overview of all commands that can be run in a component workspace project.\n\n## Deployment to IXON Cloud\n\n\u003e The deployment requires a **company ID** and a **page-component-template ID**. Please refer to the [Deploying UI Components](https://developer.ixon.cloud/docs/deploying-ui-components) on our developer website how to obtain these (step 4. and 5.)\n\nWhen your component is ready to be used in action, it can be deployed to the IXON Cloud. To do that, you must first log in with your IXON user account.\n\n```sh\nnpx cdk login\n```\n\nNow that you're logged in, you can run the following command to deploy the component...\n\n```sh\nnpx cdk deploy my-component\n```\n\n...You will be prompted for the company ID and page-component-template ID and whether you want to remember these settings to speed up the process for a next deployment.\n\nIf all goes well, the component gets uploaded to the platform and you'll receive a preview link. With this link you can test the component in production.\n\nThe final step is to publish the deployed component so that it becomes available to all company users...\n\n```sh\nnpx cdk publish my-component\n```\n\n...You will be prompted to select a version out of a list of all unpublished versions up to the currently published version. Select the version you want to publish. If all goes well, it will now be available for all company users to use.\n\n## Support\n\nFor more information and support, please check our [developer website on developer.ixon.cloud](https://developer.ixon.cloud/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixoncloud%2Fcomponent-workspace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fixoncloud%2Fcomponent-workspace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixoncloud%2Fcomponent-workspace/lists"}