{"id":28169741,"url":"https://github.com/softkitit/react-portal-template","last_synced_at":"2025-05-15T16:18:46.450Z","repository":{"id":186102173,"uuid":"467619572","full_name":"softkitit/react-portal-template","owner":"softkitit","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-30T23:44:03.000Z","size":3836,"stargazers_count":0,"open_issues_count":7,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-05-01T00:42:34.693Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/softkitit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2022-03-08T17:53:30.000Z","updated_at":"2023-07-23T19:18:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"aa417ee4-c2c0-48c7-990d-59b33188c9a8","html_url":"https://github.com/softkitit/react-portal-template","commit_stats":null,"previous_names":["softkitit/react-portal-template"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softkitit%2Freact-portal-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softkitit%2Freact-portal-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softkitit%2Freact-portal-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/softkitit%2Freact-portal-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/softkitit","download_url":"https://codeload.github.com/softkitit/react-portal-template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254374526,"owners_count":22060615,"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":"2025-05-15T16:18:43.868Z","updated_at":"2025-05-15T16:18:46.434Z","avatar_url":"https://github.com/softkitit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Template React Portal\n\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=openchannel_react-portal-template\u0026metric=alert_status\u0026token=0585888615fa605da8c20310dfe5e64f1a53df65)](https://sonarcloud.io/dashboard?id=openchannel_react-portal-template)\n[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=openchannel_react-portal-template\u0026metric=coverage\u0026token=0585888615fa605da8c20310dfe5e64f1a53df65)](https://sonarcloud.io/dashboard?id=openchannel_react-portal-template)\n\n## Table of Contents\n\n- [About the Project](#about-the-project)\n- [Built With](#built-with)\n- [Getting Started](#getting-started)\n- [Installation](#installation)\n- [Configure dashboard](#configure-dashboard)\n- [Usage](#usage)\n- [Contact](#contact)\n\n## About The Project\n\nThe goal of a portal template site is to give partners a dashboard where they can manage, create and submit applications to the marketplace.\n\nThis is a Frontend for Developer marketplace.\n\nFunctional for Developer:\n\n- Native, SSO login and SAML login.\n- Work with applications (create, update, change app status).\n- View application statistics.\n- Updating profile and organization data.\n- Managing developers from your organization. Invite new developers.\n\n### Built With\n\n- [Bootstrap](https://getbootstrap.com) v. 4.6.0\n- [React Boostrab](https://react-bootstrap.github.io) v.1.5.2\n- [React](https://reactjs.org) v. 17.0.14\n- [Redux](https://react-redux.js.org/) v.3.6.0\n- [Typescript](https://www.typescriptlang.org/) v.4.2.4\n\n## Getting Started\n\n### Installation\n\n- Install [node.js and npm](https://linuxize.com/post/how-to-install-node-js-on-ubuntu-20-04/):\n\n```\nsudo apt install nodejs npm\n```\n\n- Install the [React](https://www.npmjs.com/package/react) using the npm package manager:\n\n```\nnpm i react\n```\n\n- Install NPM packages\n\n```\nnpm install\n```\n\n- Optional. Dependency with @openchannel/react-common-services.\n\n```\nnpm install file:\u003cabsolute path to common service project dist/react-common-services\u003e\n```\n\n- Optional. Dependency with @openchannel/react-common-components.\n\n```\nnpm install file:\u003cabsolute path to common component project dist/react-common-components\u003e\n```\n\n### Configure dashboard\n\n- Openchannel dashboard [https://my.openchannel.io/](https://my.openchannel.io/)\n\nStep 1. Setup OAuth\n\n- Google [guide](https://developers.google.com/identity/protocols/oauth2/openid-connect)\n- Okta guide : [guide](https://developer.okta.com/docs/guides/implement-oauth-for-okta/overview)\n\nStep 2. (Optional) (#type) Note: Dashboard already have default type.\n\n- Follow the link to the dashboard and sign in.\n- On the left sidebar menu, find 'Settings' and open.\n- Then open 'Field Settings'.\n- You must create a new types for tabs:  \n   _'USER'  \n   _'USER ACCOUNT'  \n   _'DEVELOPER'  \n   _'DEVELOPER ACCOUNT'\n\nStep 3. (Optional) (#roles) Note: Dashboard already have default roles.\n\n- Follow the link to the dashboard and sign in.\n- On the left sidebar menu, find 'Developers' and open.\n- Then open 'Roles' and click by 'ADD ROLE.\n- Fill name.\n- Then click by 'ADD PERMISSIONS'\n- Select all available permissions.\n- Save.\n\nStep 4. Creating site template, it is portal or market.\n\n- Follow the link to the dashboard and sign in.\n- On the left sidebar menu, find 'Sites' and open.\n- Click by 'CREATE SITE'.\n- In the opened modal fill fields :\n  1.  Name\\* - just site name.\n  2.  Type\\* - now has two parameters ('Self Hosted' and 'Fully Hosted')  \n      Fully Hosted - the site will be created from scratch.  \n      Self Hosted - you already have your site and want to link it by site domain.\n  3.  Template\\* ('Fully Hosted') - select your template type: portal(for developers) or market(for users)\n\nStep 5. Configure site authorization type SSO or Native login.\n\n- Follow the link to the dashboard and sign in.\n- On the left sidebar menu find 'Sites' and open.\n- Find your site and open. (This page configures your site)\n- Find and click by 'SSO'.\n- Find and click by 'ADD IDENTITY CONFIGURATION'.\n\n  \u003e Google config  \n  \u003e *Name : Google  \n  \u003e *Validation Mode : Authorization Code  \n  \u003e *Client ID : 45823498-349823hfjnlfna98r722903470.apps.googleusercontent.com  \n  \u003e *Client Secret : AGSdaskjqASJFnsdfal  \n  \u003e *Issuer : https://accounts.google.com  \n  \u003e *Grant Type : authorization_code  \n  \u003e *Scope : openid profile email  \n  \u003e *Classification : USER | DEVELOPER  \n  \u003e *Developer Organization Type (#type): admin  \n  \u003e *Developer Account Type (#type): admin  \n  \u003e \\*Developer Account Roles (#roles):dev-admin\n  \u003e\n  \u003e \u003e Google claims mappings :  \n  \u003e \u003e *accountId : {{sub}}  \n  \u003e \u003e *organizationName : {{use your custom JWT claim or for test '{{aud}}'  \n  \u003e \u003e *email : {{email}}  \n  \u003e \u003e *name : {{given_name}} {{family_name}}  \n  \u003e \u003e *username : {{name}}  \n  \u003e \u003e *organizationId :{{aud}}\n\n  \u003e Okta config  \n  \u003e *Name : Okta  \n  \u003e *Validation Mode : Authorization Code\n\n       Note: ('Authorization Code' - signup used special endpoints, but 'Introspect'\n\n  and 'Public key' use all CAP endpoints)  \n  *Client ID : OAuth clientId  \n  *Client Secret : OAuth client secret  \n  *Issuer : https://dev-2468217.okta.com (use your ID into domain)  \n  *Grant Type : authorization_code  \n  *Scope : openid profile email  \n  *Classification : USER | DEVELOPER  \n  *Developer Organization Type (#type): default  \n  *Developer Account Type (#type): default  \n  \\*Developer Account Roles (#roles): dev-admin\n\n  \u003e \u003e Okta claims mappings :  \n  \u003e \u003e *accountId : {{sub}}  \n  \u003e \u003e *organizationId : {{idp}}  \n  \u003e \u003e *organizationName : {{name}}-company  \n  \u003e \u003e *email : {{email}}  \n  \u003e \u003e \\*name : {{name}}\n\n## Usage\n\n#### Run project with the remote site configs:\n\n- In order to use different endpoints, need to create .env files, for example .env.dev1 or .env.stage1, each file should contain environments variables:\n\n```\nREACT_APP_API_URL\nREACT_APP_MARKETPLACE_NAME\nPORT\nREACT_APP_ENABLE_CMS\n```\n\n- Open file:\n\n```\n/etc/hosts\n```\n\n- Add to file your custom domain. (Note: this domain can be invalid, because used only in 'Origin' headers.)\n\n```\n127.0.0.1 my-custom-domain.com\n```\n\n- Run project with the production environment:\n\n```\nsudo npm run start-with-host my-custom-domain.com\n```\n\n#### Run project with the Moesif plugin for Chrome:\n\n- Install [Moesif](https://chrome.google.com/webstore/detail/moesif-origin-cors-change/digfbfaphojjndkpccljibejjbppifbc/related) CORS plugin for Chrome\n- Submit your work email address there\n- Open advanced settings\n- Fill in the 'Access-Control-Allow-Credentials'\u003cbr\u003e\n  ` true`\n- Fill in the 'Response headers' field: \u003cbr\u003e\n  ` http://localhost:4200`\n- Fill in the 'Request Headers' field:\u003cbr\u003e\n  (Note: this domain can be invalid, because used only in 'Origin' headers.)\n  ` https://my-custom-domain.com`\n- Then start project with command:\u003cbr\u003e\n  ` npm run start`\u003cbr\u003e\n\n## Documentation Compodoc\n\nCompodoc shows project structure. (modules, components, routes etc.)\n\n- Install NPM packages:\n\n```\nnpm install\n```\n\n- Generate Documentation:\n\n```\nnpm run create-compodoc\n```\n\n- Run Compodoc:\n\n```\nnpm run start-compodoc\n```\n\nDocumentation [http://localhost:8803](http://localhost:8803)\n\n## Search engine discoverability\n\nProject contains the `robots.txt` file. This file tells search engine crawlers which URLs the crawler can\naccess on your site. This is used mainly to avoid overloading your site with requests. Access is disallowed to the whole\nsite by default. If you want to allow access, change property:\n\n```\nDisallow: /\n```\n\nto\n\n```\nAllow: /\n```\n\nDocumentation: [https://developers.google.com/search/docs/advanced/robots/create-robots-txt?hl=en](https://developers.google.com/search/docs/advanced/robots/create-robots-txt?hl=en)\n\n## Contact\n\nWebsite: [https://openchannel.io](https://openchannel.io)\n\n## Designs\n\nApp Store Designs: [https://support.openchannel.io/guides/app-store-designs/](https://support.openchannel.io/guides/app-store-designs/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftkitit%2Freact-portal-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoftkitit%2Freact-portal-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoftkitit%2Freact-portal-template/lists"}