{"id":15710504,"url":"https://github.com/aws/porting-assistant-dotnet-ui","last_synced_at":"2025-10-08T06:11:51.161Z","repository":{"id":36964170,"uuid":"325113551","full_name":"aws/porting-assistant-dotnet-ui","owner":"aws","description":"Porting Assistant for .NET is an analysis tool that scans .NET Framework applications and generates a .NET Core compatibility assessment, helping customers port their applications to Linux faster.","archived":true,"fork":false,"pushed_at":"2025-08-26T22:20:53.000Z","size":9067,"stargazers_count":65,"open_issues_count":69,"forks_count":14,"subscribers_count":15,"default_branch":"main","last_synced_at":"2025-09-29T21:17:34.181Z","etag":null,"topics":["aws","dotnet","dotnet-core"],"latest_commit_sha":null,"homepage":"https://aws.amazon.com/porting-assistant-dotnet/","language":"TypeScript","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/aws.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-28T20:47:18.000Z","updated_at":"2025-09-09T02:36:23.000Z","dependencies_parsed_at":"2024-04-26T00:04:07.672Z","dependency_job_id":null,"html_url":"https://github.com/aws/porting-assistant-dotnet-ui","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":"amazon-archives/__template_Apache-2.0","purl":"pkg:github/aws/porting-assistant-dotnet-ui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Fporting-assistant-dotnet-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Fporting-assistant-dotnet-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Fporting-assistant-dotnet-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Fporting-assistant-dotnet-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aws","download_url":"https://codeload.github.com/aws/porting-assistant-dotnet-ui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aws%2Fporting-assistant-dotnet-ui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278898333,"owners_count":26064976,"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","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["aws","dotnet","dotnet-core"],"created_at":"2024-10-03T21:08:19.585Z","updated_at":"2025-10-08T06:11:51.109Z","avatar_url":"https://github.com/aws.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UI for Porting Assistant for .NET Standalone Tool\n\nPorting Assistant for .NET is an analysis tool that scans .NET Framework applications and generates a .NET Core compatibility assessment, helping customers port their applications to Linux faster.\n\nPorting Assistant for .NET quickly scans .NET Framework applications to identify incompatibilities with .NET Core, finds known replacements, and generates detailed compatibility assessment reports. This reduces the manual effort involved in modernizing applications to Linux.\n\n**PortingAssistant.UI** package provides the source code of Porting Assistant standalone tool's UI.\n\nFor more information about Porting Assistant and to try the tool, please refer to the documenation: https://aws.amazon.com/porting-assistant-dotnet/\n\n## Introduction\n\nPorting Assistant for .NET standalone tool is an electron application. The UI is a react application that is running on an Electron application.\n\n## Repository Structure\n\nWe are using lerna to manage multiple packages in a single repository.\n\nAll code is located within the `./packages` folder.\n\n\n* `./packages/csharp` - C# code that interfaces with Porting Assistant for .NET client\n* `./packages/electron` - Electron related code. Including electron.js and electron build scripts.\n* `./packages/react` - The React app that electron runs.\n* `./packages/integration-test` - Integration tests.\n\n## Developing Porting Assistant for .NET\n\n### Prereq\n\nWe require the following:\n\n* Node 14 (newer versions are not supported)\n* .NET Core 3.1\n* [.NET Runtime 6.0.12 ](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-6.0.12-windows-x64-installer?cid=getdotnetcore)\n\n### Getting started developing\n\n#### Single commands\n\nTo start a local dev environment from scratch.\n\n\n```\nnpm install \u0026\u0026 npm run build \u0026\u0026 npm start\n```\n\n\n#### Add a new dependency\n\n\n1. Run `lerna add some-dependency --scope @porting-assistant/some-package`. For example `lerna add redux --scope @porting-assistant/react`.\n\nYou can also run `npm install` inside a package. But you will need to run `lerna bootstrap` afterwards.\n\n#### Steps to package a dev exe.\n\n\n1. Build the apps\n\n```\nnpm run build\n```\n\n\n\n1. Package the apps, by default we package for Windows only.\n\n```\nnpm run build:exe:dev\n```\n\n\n\n1. Find the exe in the ./dist/ folder.\n\n### AWS UI\n\nPorting Assistant for .NET standalone tool makes use of the newly released AWS UI design framework for UI components. AWS UI contains a collection of React components that help create intuitive, responsive, and accessible user experiences for web applications. It is available on NPM (Package manager of Node.JS). This work is available under the terms of the [Apache 2.0 open source license](http://#).\n\nAWS UI’s source code and documentation has not been opensourced or released yet. For now the best way to obtain the list of available components and parameters for the components is to look into the package within node_modules. If you need additional help with AWS UI please file an issue, we will be happy to provide the help you need.\n\n\n#### Steps to find list of components\n\n\n1. Run npm \n\n```\nnpm install\n```\n\n1. Go into `packages/react/node_modules/@awsui/components-react/` to check the list of components.\n2. The typescript typing files will also allow typescript intellisense / plugins to perform auto completion within IDEs.\n\n# Additional Resources\n\n[Porting Assistant for .NET](https://docs.aws.amazon.com/portingassistant/index.html)\n\n[AWS Developer Center - Explore .NET on AWS](https://aws.amazon.com/developer/language/net/)\nFind all the .NET code samples, step-by-step guides, videos, blog content, tools, and information about live events that you need in one place.\n\n[AWS Developer Blog - .NET](https://aws.amazon.com/blogs/developer/category/programing-language/dot-net/)\nCome see what .NET developers at AWS are up to! Learn about new .NET software announcements, guides, and how-to's.\n\n\n# License\n\nLibraries in this repository are licensed under the Apache 2.0 License.\n\nSee [LICENSE](./LICENSE) and [NOTICE](./NOTICE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws%2Fporting-assistant-dotnet-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faws%2Fporting-assistant-dotnet-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faws%2Fporting-assistant-dotnet-ui/lists"}