{"id":19665978,"url":"https://github.com/microsoftedge/hwa-starter","last_synced_at":"2025-09-16T19:31:35.144Z","repository":{"id":137928302,"uuid":"59860592","full_name":"MicrosoftEdge/hwa-starter","owner":"MicrosoftEdge","description":"Everything you need to get started building a Windows Universal Hosted Web App.","archived":true,"fork":false,"pushed_at":"2016-07-28T23:59:07.000Z","size":123,"stargazers_count":13,"open_issues_count":0,"forks_count":15,"subscribers_count":8,"default_branch":"master","last_synced_at":"2024-11-11T16:30:08.258Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://microsoftedge.github.io/WebAppsDocs/","language":"HTML","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/MicrosoftEdge.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}},"created_at":"2016-05-27T20:10:27.000Z","updated_at":"2024-07-31T11:40:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"67208599-fd5c-4053-a6c0-30e79fa9f92b","html_url":"https://github.com/MicrosoftEdge/hwa-starter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftEdge%2Fhwa-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftEdge%2Fhwa-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftEdge%2Fhwa-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftEdge%2Fhwa-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MicrosoftEdge","download_url":"https://codeload.github.com/MicrosoftEdge/hwa-starter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233287882,"owners_count":18653430,"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":"2024-11-11T16:25:44.417Z","updated_at":"2025-09-16T19:31:29.731Z","avatar_url":"https://github.com/MicrosoftEdge.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hosted Web App Starter Pack\r\n\r\n#### Everything you need to get started building a Windows Hosted Web App as quickly as possible.\r\n\r\nThe Starter Pack makes it easy to start a new Hosted Web App project based on a W3C Web App manifest. It comes with everything you need, including:\r\n- Tools to help you generate, package, and launch your Windows App\r\n- Template W3C Manifest\r\n- ES6 support using Babel\r\n- Code linting using ESLint\r\n- JS bundling using WebPack\r\n- Sass support\r\n- Automatic Browser/App refresh on HTML, CSS, JS changes using BrowserSync\r\n\r\n## Getting started\r\n\r\n#### Setup\r\nTo get started, first fork the repo. Then clone to your machine and install the dependencies.\r\n\r\n```\r\ngit clone https://github.com/\u003cUSERNAME\u003e/hwa-starter.git \u0026\u0026 cd hwa-starter\r\nnpm install\r\n```\r\n\r\n#### Test\r\n\r\nTo set up a local server with BrowswerSync to serve the content:\r\n\r\n```\r\nnpm run serve\r\n```\r\n\r\nNext you can generate and launch a Windows app pointing to `localhost`. This has the same features as viewing your app in the browser, such as automatic refresh with BrowserSync, but it also allows you to access the Windows APIs from JavaScript.\r\n\r\n```\r\nnpm run launch:local\r\n```\r\n\r\n## Deploy\r\n\r\n#### Deploying content\r\n\r\nThe first step to move to production is to deploy the build output from the `dist/` folder. If you'd like to use Github Pages, you can simply run the following command:\r\n\r\n```\r\nnpm run deploy\r\n```\r\n\r\n#### Build Production App, Submit to Store\r\nYou can create an APPX package with your app contents for submission to the Windows Store, even on platforms that do not support installing the Windows SDK such as OS X and Linux.\r\n\r\n1. Set up a Microsoft Developer account [here](http://dev.windows.com/en-us).\r\n\r\n1. Reserve the name of your app and obtain its identity details (under **App management | App identity**), including _Name_, _Publisher_, and _PublisherDisplayName_.\r\n\r\n1. Generate the app pointing at production content:\r\n\r\n```\r\nnpm run generate:prod\r\n```\r\n\r\nOptionally test the production app using:\r\n\r\n```\r\nnpm run launch:prod\r\n```\r\n\r\n1. Update the **appmanifest.xml** file located in the **_tmp/prod/\u003cAPP-NAME\u003e/windows/manifest_** directory of the app with the identity details. The app manifest XML has already included placeholders indicating where each piece of information needs to be replaced.\r\n\r\n1. Build the APPX package:\r\n\r\n```\r\nnpm run package\r\n```\r\n\r\n1. Upload package to the Windows Store, and then complete the submission process.\r\n\r\n## Code of Conduct\r\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoftedge%2Fhwa-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoftedge%2Fhwa-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoftedge%2Fhwa-starter/lists"}