{"id":15023861,"url":"https://github.com/sap/generator-easy-ui5","last_synced_at":"2025-04-14T11:27:49.475Z","repository":{"id":34077808,"uuid":"159407527","full_name":"SAP/generator-easy-ui5","owner":"SAP","description":"Meta-generator various project types within the UI5 Universe","archived":false,"fork":false,"pushed_at":"2025-03-26T15:25:23.000Z","size":975,"stargazers_count":258,"open_issues_count":4,"forks_count":74,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-04-07T04:04:13.603Z","etag":null,"topics":["html5-application","open-source","openui5","sap-btp"],"latest_commit_sha":null,"homepage":"https://blogs.sap.com/2021/04/09/easy-ui5-3.0-from-community-contributions-to-community-plugins/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SAP.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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}},"created_at":"2018-11-27T22:20:00.000Z","updated_at":"2025-04-04T03:38:33.000Z","dependencies_parsed_at":"2023-02-18T18:01:03.650Z","dependency_job_id":"fc57705d-55db-4f14-a31f-d2f227ff704f","html_url":"https://github.com/SAP/generator-easy-ui5","commit_stats":{"total_commits":334,"total_committers":23,"mean_commits":"14.521739130434783","dds":"0.42215568862275454","last_synced_commit":"241d802f46f2c7c1247da8ec37358dfc4282a88a"},"previous_names":[],"tags_count":75,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Fgenerator-easy-ui5","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Fgenerator-easy-ui5/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Fgenerator-easy-ui5/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Fgenerator-easy-ui5/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SAP","download_url":"https://codeload.github.com/SAP/generator-easy-ui5/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248871044,"owners_count":21175140,"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":["html5-application","open-source","openui5","sap-btp"],"created_at":"2024-09-24T19:59:32.873Z","updated_at":"2025-04-14T11:27:49.432Z","avatar_url":"https://github.com/SAP.png","language":"JavaScript","readme":"# Easy UI5 Generator\n\n[![NPM version][npm-image]][npm-url]\n[![Build Status][test-image]][test-url]\n[![Dependency Status][librariesio-image]][repo-url]\n[![License Status][license-image]][license-url]\n[![REUSE status][reuse-image]][reuse-url]\n\n## Description\n\nEasy UI5 (`easy-ui5`) 💙 is a [Yeoman](http://yeoman.io/) generator which enables you to create simple [SAPUI5](https://ui5.sap.com)/[OpenUI5](https://sdk.openui5.org)-based web-apps and other UI5-related projects within seconds.\n\nThis generator has been created to simplify the creation of your UI5 prototypes. Now you can scaffold simple UI5 projects from the shell/terminal of your choice. The current best practices (such as [async](https://blogs.sap.com/2018/12/18/ui5ers-buzz-41-best-practices-for-async-loading-in-ui5/)) are already baked into our templates so you don't have to worry about the definition of the metadata files.\n\nThe purpose of the `project` subgenerator is to guide you on your first steps with [SAPUI5](https://sapui5.hana.ondemand.com/) and [SAP BTP](https://www.sap.com/products/business-technology-platform.html) deployments. Once you are familiar with those technologies, you might want to tweak the projects to adapt them for productive use-cases (such as continuous deployment pipelines and full i18n).\n\n\u003e :warning: Starting with Easy UI5 v3, all templates will be outsource to repositories in the [UI5 Community](https://github.com/ui5-community/). This project is from now on a shell that will offer all generators hosted on that GitHub org. Easy UI5 will download and install these repositories when needed.\n\u003e\n\u003e By default, it will download the repository [generator-ui5-project](https://github.com/ui5-community/generator-ui5-project/) which contains the templates that were previously integrated in Easy UI5 \u003c 3.\n\n## Requirements\n\n- Get [Node.js](https://nodejs.org/en/download/) (:warning: **version 18 or higher**)\n\n## Download and Installation\n\n1. Install the generator\n   ```sh\n   npm install -g yo generator-easy-ui5\n   ```\n2. Verify your installation to see if Yeoman has been installed correctly\n   ```sh\n   yo\n   ```\n   Make sure you see the `easy-ui5` generator listed.\n\n## Bootstrapping a new UI5 project\n\n\u003e Create your first UI5 App within a few seconds!\n\n1. Scaffold your UI5 project\n   ```\n   yo easy-ui5 project\n   ```\n2. Answer the prompts to create your new project\n3. Run it locally\n   ```\n   cd \u003cyour project directory\u003e\n   npm start # or \"yarn start\"\n   ```\n\n## Target platforms\n\nDuring the prompting phase, the generator will ask on which target platform your app should run. Currently, the following options are available:\n\n- Static webserver\n- SAP BTP\n- SAP HANA XS Advanced\n- SAP NetWeaver\n\n\u003e Have a look at [this plugin project](https://github.com/ui5-community/generator-ui5-project/) for more usage instruction and information about the available subcommands.\n\n## More generators\n\nAnd this is just the start!\n\nWe made Easy UI5 extensible, so that the entire [UI5 Community](https://github.com/ui5-community/) can build additional plugins to scaffold any UI5-related development activity.\n\nBy default, this generator comes with the [project-creation-plugin](https://github.com/ui5-community/generator-ui5-project) but there are many others as well:\n\n- Create new UI5 libraries [[ui5-community/generator-ui5-library]](https://github.com/ui5-community/generator-ui5-library)\n- More are coming!\n\u003c!-- - Create new UI5 custom controls\n- Create middlewares for the UI5 tooling\n- Create tasks for the UI5 tooling\n- Create a WDI5 test suite --\u003e\n\nTo download and use any of the plugins above, run the following command\n\n```sh\nyo easy-ui5 [project|library] # this is the name of the repositorty without the \"generator-ui5-\" prefix\n```\n\n\u003c!-- Are you missing a generator in this list and are you willing to provide one to the entire UI5 community? Great! [This blog posts](TODO INSERT LINK HERE) contains everything you need to know to get started!  --\u003e\n\n## Calling generators\n\nRun the following command to see all subgenerators of a given plugin\n\n```sh\nyo easy-ui5 [project|library] --list\n```\n\nOnce you decided on the subgenerator, run:\n\nRun the following command to see all subgenerators of a given plugin\n\n```sh\nyo easy-ui5 [project|library] \u003csub-generator-id\u003e\n```\n\n## Proxy settings\n\nIf you are running Easy UI5 behind a coporate proxy, just use the default proxy environment variables for Node.js to configure your corporate proxy:\n\n- `HTTP_PROXY`: Specify the value to use as the HTTP proxy for all connections, e.g., `HTTP_PROXY=\"http://proxy.mycompany.com:8080/\"`.\n- `HTTPS_PROXY`: Specify the value to use as the HTTPS proxy for all connections, e.g., `HTTPS_PROXY=\"http://proxy.mycompany.com:8080/\"`.\n- `NO_PROXY`: Define the hosts that should bypass the proxy, e.g., `NO_PROXY=\"localhost,.mycompany.com,192.168.6.254:80\"`.\n\nIn addition, Easy UI5 also supports proxy configuration from the `.npmrc` configuration:\n\n```text\nhttp-proxy=http://proxy.mycompany.com:8080/\nhttps-proxy=http://proxy.mycompany.com:8080/\nproxy=http://proxy.mycompany.com:8080/\nno-proxy=localhost,.mycompany.com,192.168.6.254:80\n```\n\nThis configuration is shared with npm itself since this proxy configuration is used to download the packages from npm.\n\nProxies can be passed as env variables or as npm config options. The highest precedence have the `GLOBAL_AGENT_*` env variables before the regular env variables followed by the npm configuration options, e.g.:\n\n1. env: `GLOBAL_AGENT_HTTP_PROXY`\n2. env: `HTTP_PROXY`\n3. npm: `http-proxy`\n4. npm: `proxy`\n\n## How to obtain support\n\nPlease use the GitHub bug tracking system to post questions, bug reports or to create pull requests.\n\n## Contributing\n\nWe welcome any type of contribution (code contributions, pull requests, issues) to this easy-ui5 generator equally.\n\nPlease follow our instructions if you would like to [contribute](https://github.com/SAP/generator-easy-ui5/blob/master/CONTRIBUTING.md).\n\n[npm-image]: https://img.shields.io/npm/v/generator-easy-ui5.svg\n[npm-url]: https://www.npmjs.com/package/generator-easy-ui5\n[test-image]: https://github.com/SAP/generator-easy-ui5/actions/workflows/main.yml/badge.svg\n[test-url]: https://github.com/SAP/generator-easy-ui5/actions/workflows/main.yml\n[librariesio-image]: https://img.shields.io/librariesio/github/SAP/generator-easy-ui5\n[repo-url]: https://github.com/SAP/generator-easy-ui5\n[license-image]: https://img.shields.io/npm/l/generator-easy-ui5.svg\n[license-url]: https://github.com/SAP/generator-easy-ui5/blob/master/LICENSE\n[reuse-image]: https://api.reuse.software/badge/github.com/SAP/generator-easy-ui5/\n[reuse-url]: https://api.reuse.software/info/github.com/SAP/generator-easy-ui5/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsap%2Fgenerator-easy-ui5","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsap%2Fgenerator-easy-ui5","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsap%2Fgenerator-easy-ui5/lists"}