{"id":19190004,"url":"https://github.com/ixoncloud/app-mail-form","last_synced_at":"2026-02-05T14:09:16.505Z","repository":{"id":213312771,"uuid":"733011822","full_name":"ixoncloud/app-mail-form","owner":"ixoncloud","description":"https://marketplace.ixon.cloud/en/apps/mail-form","archived":false,"fork":false,"pushed_at":"2025-06-13T20:52:00.000Z","size":140,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-11T02:50:32.976Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","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":"2023-12-18T11:12:53.000Z","updated_at":"2025-06-13T20:52:04.000Z","dependencies_parsed_at":"2023-12-19T19:18:03.711Z","dependency_job_id":"0aa5b600-69a5-4d47-a0fe-5dd92b9340ae","html_url":"https://github.com/ixoncloud/app-mail-form","commit_stats":null,"previous_names":["ixoncloud/app-mail-form"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ixoncloud/app-mail-form","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fapp-mail-form","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fapp-mail-form/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fapp-mail-form/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fapp-mail-form/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ixoncloud","download_url":"https://codeload.github.com/ixoncloud/app-mail-form/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ixoncloud%2Fapp-mail-form/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29123633,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T14:05:12.718Z","status":"ssl_error","status_checked_at":"2026-02-05T14:03:53.078Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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:35.397Z","updated_at":"2026-02-05T14:09:16.499Z","avatar_url":"https://github.com/ixoncloud.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IXON Mail Form\n\n## Description\n\nThis workspace contains the **Mail Form App** for IXON Cloud. Users can fill out this form to send a message to a fixed email address, making it a simple way to submit a service request. \n\nThe [UI Component](https://developer.ixon.cloud/docs/introduction-ui-components#/) side of the project is based on the [IXON Cloud UI Component Development Kit](https://gitlab.ixon.net/ixon/cdk/component-workspace), while the [Cloud function](https://developer.ixon.cloud/docs/cloud-functions-introduction#/) side of the project is based on the [IXON Cloud Backend Component Workspace](https://github.com/ixoncloud/backend-component-workspace). For more information, consult the respective **documentation articles** linked above.\n\nNote that this app is built with [Svelte](https://svelte.dev/), [Typescript](https://www.typescriptlang.org/), [SCSS](https://sass-lang.com/) and [Python](https://www.python.org/). It requires you to be familiar with the [Node.js](https://nodejs.org/) ecosystem.\n\nBelow you will find the following sections:\n\n- Prerequisite\n- Testing locally\n  - Step 1 - Running the UI Component\n  - Step 1 - Running the Cloud Function\n- Additional Documentation\n- Context config\n\n## Prerequisite\nTo use the Mail Form app, you need to have an SMTP server that supports basic authentication and is using SSL (e.g. Google SMTP). This app **does not support OAuth2** as an authentication method to authenticate with the SMTP server. The SMTP server of Outlook requires OAuth2 and is therefore not supported. \n\n## Testing locally\n\nTo test this project locally, you will have to run both the **UI Component (Frontend)** part for visualization and the **Cloud Function (Backend)** for the logic. \n\n**Please note**: before you proceed with the following steps, make sure to set up both the [frontend](https://developer.ixon.cloud/docs/installation-guide-ui-components#/) and the [backend](https://developer.ixon.cloud/docs/running-a-cloud-function#/) environments correctly by reading the documentation. This is necessary to ensure that you can start the whole development environment: not doing so might result in some of the following commands **not working**.\n\n### Step 1 - Running the UI Component\n\nTo run the **UI Component**, open a WSL Terminal in your IDE and run the following commands:\n\nInstall the **dependencies**:\n\n```sh\nnpm install\n```\n\nLogin to your **IXON Cloud account**:\n\n```sh\nnpx cdk login\n```\n\nFinally, run the **Simulator**:\n\n```sh\nnpx cdk simulate mail-form\n```\n\nThis opens the **Simulator app** in a browser and builds the component in _watch-mode_, which means that any changes to the component source files will trigger a rebuild and will auto-reload the simulator.\n\n\n### Step 2 - Running the Cloud Function\n\nTo run the Cloud Function, open another WSL Terminal in your IDE and use the following command:\n\n```sh\nmake run\n```\n\nNo additional commands are required, as this is automatically sets up your virtual environment, installs dependencies and runs the IXON CDK Ingress. You can read more about it in this [documentation article](https://developer.ixon.cloud/docs/running-a-cloud-function#/).\n\n## Additional Documentation\n\nTo check out docs and examples on how to develop an App and get more knowledge about the SDKs, visit the documentation links provided in the previous sections.\n\nAdditionally, the [@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## Context config\n\nHere you can find an example of the needed configuration. To set up the app's configuration, follow the instructions found in the [Mail Form marketplace page](https://marketplace.ixon.cloud/en/apps/mail-form) under the **\"How to install\"** section.\n\n\n```json\n{\n  \"values\": {\n    \"smtp_server\": \"smtp.gmail.com\",\n    \"smtp_ssl_port\": \"465\",\n    \"smtp_user\": \"john.doe@email.com\",\n    \"smtp_password\": \"\"\n  }\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixoncloud%2Fapp-mail-form","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fixoncloud%2Fapp-mail-form","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fixoncloud%2Fapp-mail-form/lists"}