Enhance documentation with detailed usage examples and feature descriptions for Prettymaps.

docs/usage.md

@@ -1,5 +1,55 @@
 # Usage
 
-This page will describe how to use Prettymaps.
+## Installation
 
-_More details coming soon!_ 
+Install Prettymaps and its dependencies:
+
+```sh
+pip install prettymaps
+```
+
+## Basic Usage
+
+Generate a map for a location:
+
+```python
+import prettymaps
+
+prettymaps.plot("Paris, France")
+```
+
+## Customizing Layers and Styles
+
+You can customize which map layers to show and their appearance:
+
+```python
+layers = {
+    "perimeter": {},
+    "streets": {"width": 8},
+    "buildings": {},
+    "water": {},
+}
+style = {
+    "perimeter": {"fc": "#f2efe9", "ec": "#333"},
+    "streets": {"fc": "#cccccc"},
+    "buildings": {"fc": "#b0b0b0"},
+    "water": {"fc": "#aadaff"},
+}
+prettymaps.plot("Berlin, Germany", layers=layers, style=style)
+```
+
+## Saving Maps
+
+You can save the generated map to a file:
+
+```python
+prettymaps.plot("Tokyo, Japan", save_as="tokyo_map.png")
+```
+
+## Advanced Features
+
+- **Keypoints:** Highlight specific places or features on the map.
+- **Presets:** Save and reuse your favorite map styles.
+- **Hillshade:** Add elevation shading for a 3D effect.
+
+See the [API Reference](api.md) for all available options.