# Azure Icons Quick Start

## Quick Setup

1. **Setup assets directory**:
   ```bash
   make -f Makefile.assets assets
   ```

2. **Download Azure icons**:
   ```bash
   make -f Makefile.assets download-icons
   ```

3. **Create Draw.io stencil**:
   ```bash
   make -f Makefile.assets create-stencil
   ```

## Using Icons

### In Draw.io

1. Open [Draw.io](https://app.diagrams.net/)
2. Click "More Shapes" → "+" → "From Device"
3. Navigate to `assets/azure-icons/svg/`
4. Select icons to import

### In Documentation

```markdown
![Azure Kubernetes Service](assets/azure-icons/svg/Icon-service-kubernetes-Azure.svg)
```

### Icon Location

- **SVG**: `assets/azure-icons/svg/`
- **PNG**: `assets/azure-icons/png/`
- **Metadata**: `assets/azure-icons/metadata/`

## Common Icons

- AKS: `Icon-service-kubernetes-Azure.svg`
- Virtual Network: `Icon-service-virtual-network-Azure.svg`
- Application Gateway: `Icon-service-application-gateway-Azure.svg`
- Key Vault: `Icon-service-key-vaults-Azure.svg`
- Storage Account: `Icon-service-storage-accounts-Azure.svg`

See `assets/azure-icons/metadata/icon-mapping.json` for complete mapping.

## Documentation

- [Assets Guide](../docs/ASSETS_GUIDE.md)
- [Architecture Diagrams Guide](../docs/ARCHITECTURE_DIAGRAMS.md)
- [Icon Catalog](azure-icons/metadata/icon-catalog.md)