# Azure Tools for Visual Studio Code (preview)
## Overview
Azure Tools for Visual Studio Code (preview) lets you browse and manage Azure resources, create and deploy applications, and work with Azure projects without leaving your editor.
This monorepo contains the extension and its shared utility packages. See [docs/](docs/) for architecture, patterns, and development guides.
## Extensions
* [Azure Tools for Visual Studio Code (preview)](extensions/vscode-azure/README.md) -- resource browsing and management, with dedicated experiences for Azure Container Registry, Container Apps, Functions, and Static Web Apps.
## Packages
* [@microsoft/vscode-azure-azutils](packages/azutils/README.md) -- Azure-specific utilities (SDK client wrappers, auth, resource models) shared by the extension.
* [@microsoft/vscode-azure-utils](packages/utils/README.md) -- general-purpose utilities (tree data/view layers, dependency injection, wizards, VS Code helpers) shared across the repository.
## Contributing
There are several ways you can contribute to this extension. Please read [CONTRIBUTING.md](CONTRIBUTING.md) for the full guidelines.
### Ideas, feature requests, and bugs
We are open to all ideas and we want to get rid of bugs! Use the Issues section to either report a new issue, provide your ideas or contribute to existing threads.
### Code
To contribute bug fixes, features, or design changes:
* Clone the repository locally and open in VS Code.
* Install [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint), [TypeScript 7](https://marketplace.visualstudio.com/items?itemName=typescriptteam.native-preview) and [esbuild Problem Matchers](https://marketplace.visualstudio.com/items?itemName=connor4312.esbuild-problem-matchers) for Visual Studio Code.
* Open the terminal (<kbd>Ctrl</kbd>+ <kbd>\`</kbd> by default) and run `pnpm install`.
* To build, open the Command Palette (<kbd>F1</kbd> by default) and type in `Tasks: Run Build Task`.
* Debug: press <kbd>F5</kbd> (by default) to start debugging the extension.
### Legal
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
### Code of Conduct
This 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.
## Telemetry
VS Code collects usage data and sends it to Microsoft to help improve our products and services. Read our [privacy statement](https://go.microsoft.com/fwlink/?LinkID=521839) to learn more. If you don’t wish to send usage data to Microsoft, you can set the `telemetry.telemetryLevel` setting to `off`. Learn more in our [FAQ](https://code.visualstudio.com/docs/supporting/faq#_how-to-disable-telemetry-reporting).
## License
[MIT](LICENSE.md)