1# File Shares — TypeScript SDK Quick Reference
2 
3> Condensed from **azure-storage-file-share-ts**. Full patterns (SAS generation,
4> snapshots, range operations, streaming, copy operations)
5> in the **azure-storage-file-share-ts** plugin skill if installed.
6 
7## Install
8npm install @azure/storage-file-share @azure/identity
9 
10## Quick Start
11```typescript
12import { ShareServiceClient } from "@azure/storage-file-share";
13import { DefaultAzureCredential } from "@azure/identity";
14const client = new ShareServiceClient(`https://${accountName}.file.core.windows.net`, new DefaultAzureCredential());
15```
16 
17## Best Practices
18- Use connection strings for simplicity in development
19- Use DefaultAzureCredential for **local development only** — in production, use ManagedIdentityCredential. See [auth-best-practices.md](../auth-best-practices.md)
20- Set quotas on shares to prevent unexpected storage costs
21- Use streaming for large files — `uploadStream`/`downloadToFile` for files > 256MB
22- Use ranges for partial updates — more efficient than full file replacement
23- Create snapshots before major changes — point-in-time recovery
24- Handle errors gracefully — check `RestError.statusCode` for specific handling
25- Use `*IfExists` methods for idempotent operations
26