{"id":43472759,"url":"https://github.com/cosmo-tech/azure-sample-webapp","last_synced_at":"2026-05-13T11:01:00.573Z","repository":{"id":37410872,"uuid":"318564488","full_name":"Cosmo-Tech/azure-sample-webapp","owner":"Cosmo-Tech","description":"Accelerator to build web applications on top of Cosmo Tech Digital Twins Solutions.","archived":false,"fork":false,"pushed_at":"2026-05-13T09:18:49.000Z","size":19039,"stargazers_count":13,"open_issues_count":21,"forks_count":6,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-05-13T10:35:20.565Z","etag":null,"topics":["app-deposite","generic","react","reactjs","webapp"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"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/Cosmo-Tech.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-12-04T15:56:25.000Z","updated_at":"2026-05-13T08:42:18.000Z","dependencies_parsed_at":"2023-12-26T16:01:45.634Z","dependency_job_id":"73345efe-73e8-4347-ac23-ec1f4d9ab6e9","html_url":"https://github.com/Cosmo-Tech/azure-sample-webapp","commit_stats":{"total_commits":1455,"total_committers":18,"mean_commits":80.83333333333333,"dds":0.5415807560137458,"last_synced_commit":"1fad689477fbce7ede4edee9bc480a89339e4f07"},"previous_names":[],"tags_count":154,"template":false,"template_full_name":null,"purl":"pkg:github/Cosmo-Tech/azure-sample-webapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo-Tech%2Fazure-sample-webapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo-Tech%2Fazure-sample-webapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo-Tech%2Fazure-sample-webapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo-Tech%2Fazure-sample-webapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cosmo-Tech","download_url":"https://codeload.github.com/Cosmo-Tech/azure-sample-webapp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cosmo-Tech%2Fazure-sample-webapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32979305,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T06:31:55.726Z","status":"ssl_error","status_checked_at":"2026-05-13T06:31:51.336Z","response_time":115,"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":["app-deposite","generic","react","reactjs","webapp"],"created_at":"2026-02-03T07:18:05.687Z","updated_at":"2026-05-13T11:01:00.565Z","avatar_url":"https://github.com/Cosmo-Tech.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Azure Sample Webapp\n\n[![Test](https://github.com/Cosmo-Tech/azure-sample-webapp/actions/workflows/test.yml/badge.svg)](https://github.com/Cosmo-Tech/azure-sample-webapp/actions/workflows/test.yml)\n[![Lint](https://github.com/Cosmo-Tech/azure-sample-webapp/actions/workflows/eslint.yml/badge.svg)](https://github.com/Cosmo-Tech/azure-sample-webapp/actions/workflows/eslint.yml)\n[![Deploy](https://github.com/Cosmo-Tech/azure-sample-webapp/actions/workflows/azure-static-web-apps-nice-wave-0f618f503.yml/badge.svg)](https://github.com/Cosmo-Tech/azure-sample-webapp/actions/workflows/azure-static-web-apps-nice-wave-0f618f503.yml)\n\nThe **_Azure Sample Webapp_** aims to be an example of a [React](https://reactjs.org/) web application based on the [Cosmo Tech](https://cosmotech.com/) [Simulation Digital Twin Platform](https://portal.cosmotech.com/) and Azure cloud technology.\\\nThis project demonstrates how to setup a web application with authentication, scenario management features and [PowerBI](https://powerbi.microsoft.com/en-us/) visualization.\nIt thus provides a fully configured solution **based on an example simulator** made using our Platform to illustrate the possible features (the example simulator, \"Brewery\", models customers satisfaction and beer stocks evolution in bars).\n\nYou can use this project as a base to build a front-end for your own Digital Twin solution.\n\nTo do that, **you need the Simulation Digital Twin Platform to be deployed in your Azure tenant** with a ready-to-use simulator.\nPlease note that we provide detailed step-by-step tutorials on [our portal](https://portal.cosmotech.com/) - Contact Cosmo Tech for access.\n\n# Getting Started\n\nRecommended Operating System: Debian (other OS have not been tested)\nSupported browsers: Chromium 90, Chrome 91, Firefox 78\n\n## Clone this project\n\nThe instructions below explain how to clone this project to build your own customized front-end for a Simulation Digital Twin\nsolution.\n\nFirst, from the GitHub interface, [create a new repository](https://github.com/new/import) by importing the\nazure-sample-webapp repository.\n\n![Create a new repository in GitHub by importing the project \"https://github.com/Cosmo-Tech/azure-sample-webapp\"](doc/assets/github_project_import.png)\n\nThis will allow you to develop your own front-end using git, and still be able to receive the new features of the\nazure-sample-webapp project.\n\nYou can now use the commands below to clone and configure your github project:\n\n```\n# Replace by the URL of your own repository (e.g. my-org/my-project.git)\ngit clone git@github.com:\u003cYOUR_GITHUB_REPOSITORY_URL\u003e\ncd \u003cYOUR REPOSITORY_NAME\u003e\ngit remote add upstream https://github.com/Cosmo-Tech/azure-sample-webapp.git\ngit remote set-url upstream --push \"NO\"\ngit fetch upstream --tags\n```\n\n## Create an App registration, Azure Static Webapp resource \u0026 configure it for deployment\n\nYou need an Azure Static Webapp resource in the tenant to deploy your webapp.\nFor more information, follow our step-by-step tutorials on [our portal](https://portal.cosmotech.com/) - Contact Cosmo Tech for access.\n\n## Configure the webapp for your use-case\n\nThe webapp must be configured so that it fits your simulation use-case (tenant ID, scenario parameters, visualization...).\nPlease refer to [Webapp configuration](doc/README.md)\n\n## Start the webapp locally\n\n### Pre-requisites: install `node` and `yarn`\n\nThe _azure sample webapp_ currently requires **node 24**. If you don't have NodeJS installed on your system, you\nfirst need to install it. It is recommended to use [nvm](https://github.com/nvm-sh/nvm) to install node.\n\n[Install nvm](https://github.com/nvm-sh/nvm#install--update-script):\n\n```bash\ncurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash\n```\n\nInstall node 24:\n\n```bash\nnvm install 24\nnvm use 24\n# To define v24 as the default version of node when opening a new terminal, run:\nnvm alias default 24\n```\n\nThis project is configured to be used with the [Yarn](https://yarnpkg.com/getting-started/install) package manager, in\nits Modern version. You can install yarn by enabling node's corepack:\n\n```bash\ncorepack enable\n```\n\n### Local azure function\n\nThis section describes how to run a local Azure Function, in order to provide the webapp users with a valid token for the PowerBI service. **This step is only necessary if you use the \"service account\" mode to share PowerBI charts**. If you prefer to let users communicate with PowerBI with their own accounts, then the Azure Function won't be necessary, and you can skip this section (please refer to [doc/powerBI.md](doc/powerBI.md) for the charts configuration documentation).\n\nFirst, install the\n[Azure Function Core Tools](https://learn.microsoft.com/en-us/azure/azure-functions/functions-run-local?tabs=v4). This\ntool does not support node 24 yet, so we have to switch to node 22 in the terminal running the functions:\n\n```bash\nnvm install 22  # Only necessary the first time\nnvm use 22\n```\n\nYou can then start the Azure Functions, that are required for the PowerBI embedded reports to work correctly, by running\nthe commands below:\n\n```\ncd api\nyarn install\nyarn start\n```\n\n### Local webapp server\n\nIn another terminal, you can then start the webapp with:\n\n```\nyarn install\nyarn start\n```\n\nPlease note that the `yarn install` command is only necessary if the dependencies have not been installed, you do not\nneed to use this command every time.\n\n## Available Scripts\n\n### React scripts\n\nThis application has been created with _create-react-app_, that provides some scripts directly in the project directory.\n\n#### `yarn start`\n\nRuns the app in the development mode.\\\nOpen [http://localhost:3000](http://localhost:3000) to view it in the browser.\n\nThe page will reload if you make edits.\\\nYou will also see any lint errors in the console.\n\n#### `yarn test`\n\nLaunches the test runner in the interactive watch mode.\\\nSee the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.\n\n#### `yarn build`\n\nBuilds the app for production to the `build` folder.\\\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\\\nYour app is ready to be deployed!\n\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\n\n#### `yarn cache clean --force \u0026\u0026 rm -rf node_modules \u0026\u0026 yarn install`\n\nClean the cache being sure to avoid packages and dependencies issues.\n\n## Deploy your webapp\n\nYou can use continuous deployment to trigger deployment when committing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmo-tech%2Fazure-sample-webapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcosmo-tech%2Fazure-sample-webapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmo-tech%2Fazure-sample-webapp/lists"}