{"id":18965793,"url":"https://github.com/wso2/apim-apps","last_synced_at":"2025-04-08T20:18:48.566Z","repository":{"id":37101811,"uuid":"364214889","full_name":"wso2/apim-apps","owner":"wso2","description":"WSO2 API Manager portals web UI apps","archived":false,"fork":false,"pushed_at":"2025-04-01T06:35:12.000Z","size":504219,"stargazers_count":50,"open_issues_count":14,"forks_count":126,"subscribers_count":100,"default_branch":"main","last_synced_at":"2025-04-01T18:21:47.450Z","etag":null,"topics":["api-management","portals","spa","wso2"],"latest_commit_sha":null,"homepage":"https://wso2.github.io/apim-apps","language":"JavaScript","has_issues":false,"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/wso2.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":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-04T10:11:55.000Z","updated_at":"2025-04-01T06:35:15.000Z","dependencies_parsed_at":"2023-09-29T00:56:08.988Z","dependency_job_id":"1c73f095-8e36-4171-aebf-b2bc62831e6d","html_url":"https://github.com/wso2/apim-apps","commit_stats":null,"previous_names":[],"tags_count":597,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wso2%2Fapim-apps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wso2%2Fapim-apps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wso2%2Fapim-apps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wso2%2Fapim-apps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wso2","download_url":"https://codeload.github.com/wso2/apim-apps/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247919005,"owners_count":21018046,"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":["api-management","portals","spa","wso2"],"created_at":"2024-11-08T14:32:01.689Z","updated_at":"2025-04-08T20:18:48.548Z","avatar_url":"https://github.com/wso2.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WSO2 API Manager Portals\n        \n\n---\n\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n[![stackoverflow](https://img.shields.io/badge/stackoverflow-wso2am-orange)](https://stackoverflow.com/tags/wso2-am/)\n[![slack](https://img.shields.io/badge/slack-wso2--apim-blueviolet)](https://join.slack.com/t/wso2-apim/shared_invite/enQtNzEzMzk5Njc5MzM0LTgwODI3NmQ1MjI0ZDQyMGNmZGI4ZjdkZmI1ZWZmMjNkY2E0NmY3ZmExYjkxYThjNzNkOTU2NWJmYzM4YzZiOWU?src=sidebar)\n\n---\n\n|  Branch / Status | Azure | Jenkins |\n| :------------ |:------------- |:-------------\n| master      | [![Build Status](https://dev.azure.com/apim-apps/apim-apps/_apis/build/status/wso2.apim-apps?branchName=main)](https://dev.azure.com/apim-apps/apim-apps/_build/latest?definitionId=2\u0026branchName=main) | [![Build Status](https://wso2.org/jenkins/view/platform/job/platform-builds/job/apim-apps/badge/icon)](https://wso2.org/jenkins/view/platform/job/platform-builds/job/apim-apps/) |\n\n\nWSO2 API Manager apps consists of several loosely coupled modules.\n\n        * API Publisher portal\n        * API Developer portal\n        * API Admin portal\n        * Portals integration tests\nSetup build environment\n==================================\n\n1. Install NodeJS 22.x or later LTS version from [https://nodejs.org/en/download/](https://nodejs.org/en/download/).\n \u003e **_Note :-_** \n   \u003e  \n   \u003e You may use [nvm](https://github.com/nvm-sh/nvm) tool to manage NodeJS on your development environment\n   \u003e\n\n\u003e **_Note :-_** \n   \u003e  \n   \u003e You can skip following steps if you do not want to build [product-apim](https://github.com/wso2/product-apim) binaries\n   \u003e\n\n2. Install Maven from [https://maven.apache.org/download.cgi](https://maven.apache.org/download.cgi). * For Maven 3.8 and up, please check the Troubleshoot section.\n3. Install JDK 1.8 [https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html).\n\nFixing an issue in a web application\n==================================\nIf you are planning to fix an issue in a specific web application, you don't need to build the whole repository. You only need to build that specific application from the portals folder. We will take fixing an issue in publisher web application as an example.\n\n1. If you do not build a WSO2 API Manager server, Download the built distribution of WSO2 API Manager Server from http://wso2.com/api-manager. \n\n2. Execute api-manager.sh (For unix environment) or api-manager.bat (For windows environment) file from the bin directory to run WSO2 API Manager Server.\n\n3. Goto `portals/publisher` directory in the `apim-apps` repository.\n\n4. You can either run `mvn clean install` from root directory or `npm ci` from `src/main/webapp` directory. Note that the `npm ci` will be faster since `mvn clean install` command is executing production build and UI tests.\n\n5. Run `npm start` from `src/main/webapp` to start publisher portal in development mode.\n\nNow you can update the code to view the changes in the development server. Once you are done with the fixes,\nyou can run `npm run build:prod` to check for errors before committing. Also refer to 'Running Tests' section and run test if the tests are effected. At the moment these tests are valid for only publisher app.\n\n### Adding or updating a new dependency\n1. Setup the development environment by following the steps given above.\n\n2. Run the npm command from the web application root folder. ( Ex: For publisher web app, it's `portals/publisher/src/main/webapp` ).\n   - Adding a dependency `npm i \u003cpackage-name\u003e`. (Ex: `npm i base64url`)\n   - Removing a dependency `npm uninstall \u003cpackage-name\u003e`. (Ex: `npm uninstall base64url`)\n   - Updating a version or specifying version when installing `npm i \u003cpackage-name\u003e@\u003cversion\u003e`. (Ex: `npm i base64url@3.0.1`).\n\n3. Once you successfully run the above commands the package.json and package-lock.json files will be updated. You need to commit both of them. \n\n\u003e\n\u003e Never run `npm i` since it will update the package lock for all the dependencies with there minor updated versions.\n\u003e\n\nBuilding \u0026 Running\n==================================\n### Build\n 1. Download or clone the project source code from https://github.com/wso2/apim-apps\n\n 2. If you want to build all web apps, run `mvn clean install` from the command line in the project root directory (where the root pom.xml is located). \n\n 3. Then you just need to build [WSO2 API Manager Server](https://github.com/wso2/product-apim) after. (Follow the guide there)\n\n### Run\n\n4. Extract the wso2am-4.0.0.zip and go to the 'bin' directory\n\n5. Run the api-manager.sh or api-manager.bat script based on you operating system.\n\n6. Access the respective WSO2 API-M interfaces\n    * API Publisher web application is running at - https://localhost:9443/publisher \\\n  You may sign in to the Publisher using the default administrator credentials (username: admin, password: admin).\n    * Developer Portal web application is running at - https://localhost:9443/devportal \\\n  You may sign in to the Developer Portal using the default administrator credentials (username: admin, password: admin).\nRunning Tests\n==================================\n## Unit Tests\n\nProduct Unit tests have been implemented using [Jest](https://jestjs.io/) along with [enzyme](https://enzymejs.github.io/enzyme/)\n\n### Run Tests for individual module\n\n- Go to the webapp directory in the respective individual portals directory\n\n  i:e `/portals/publisher/src/main/webapp`\n- and run\n\n  ```\n  npm run test\n  ```\n  For more information regarding the test module, checkout the [README](./portals/publisher/source/Tests/README.md) in the publisher `Tests` module.\n### Integration Tests\n\nProduct integration tests have been written using [Cypress Testing Framework](https://www.cypress.io/) and you can run the test suites using the following command.\n\n- Goto `/tests/cypress/`\n\n#### Headless mode\n\n- Run\n\n  ```\n  npm run test\n  ```\n#### Interactive mode (with GUI)\n\n- Run\n\n  ```\n  npm run test:gui\n  ```\nSupport\n==================================\n\nWSO2 Inc. offers a variety of development and production support\nprograms, ranging from Web-based support up through normal business\nhours, to premium 24x7 phone support.\n\nFor additional support information please refer to http://wso2.com/support\n\nFor more information on WSO2 API Manager please visit https://wso2.com/api-management/\n\nKnown Issues of WSO2 API Manager\n==================================\n\nAll known issues of WSO2 API Manager are filed at:\n   \n* https://github.com/wso2/product-apim/issues\n\n\n--------------------------------------------------------------------------------\n(c) Copyright 2021 WSO2 Inc.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwso2%2Fapim-apps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwso2%2Fapim-apps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwso2%2Fapim-apps/lists"}