Metadata-Version: 2.4
Name: azurea
Version: 0.2.2
Summary: Matplotlib themes by azuka — dark & light plotting styles with bundled Poppins font.
Author-email: azuka <azkarohbiya@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/azkarohbiya/azurea
Keywords: matplotlib,theme,style,dark-mode,visualization
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: matplotlib>=3.7

# azurea

Matplotlib themes by **azuka** — dark & light plotting styles with a bundled Poppins font and a hand-picked color palette.

[![PyPI](https://img.shields.io/pypi/v/azurea.svg)](https://pypi.org/project/azurea/)
[![Python](https://img.shields.io/pypi/pyversions/azurea.svg)](https://pypi.org/project/azurea/)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](#license)

## Install

From PyPI:

```bash
pip install azurea
```

Upgrade:

```bash
pip install --upgrade azurea
```

Or from GitHub:

```bash
pip install git+https://github.com/azkarohbiya/azurea.git
```

## Quick start

```python
import azurea
import matplotlib.pyplot as plt
import numpy as np

azurea.use("react_dark")   # or "react_light"

x = np.linspace(0, 4 * np.pi, 200)
plt.plot(x, np.sin(x), label="sin(x)")
plt.plot(x, np.cos(x), label="cos(x)")
plt.legend()
plt.show()
```

You can also apply the style the standard matplotlib way:

```python
import azurea  # registers styles + fonts
import matplotlib.pyplot as plt

plt.style.use("azurea.react_dark")   # or "azurea.react_light"
```

## Available styles

```python
azurea.available()
# ['azurea.react_dark', 'azurea.react_light']
```

| Name | Background | Use case |
|---|---|---|
| `azurea.react_dark`  | `#282c34` | dark-mode dashboards, notebooks |
| `azurea.react_light` | `#FFFFFF` | reports, print, docs |

Both share the Poppins typeface (bundled — no manual font install needed) and a React-inspired palette led by `#0472f7` blue, `#06b45e` green, `#fc3d51` red.

## Samples

### Dark mode — `azurea.react_dark`

![dark sample](assets/sample_dark.png)

### Light mode — `azurea.react_light`

![light sample](assets/sample_light.png)

## Custom color palette

`azurea.custom_colors` is a curated list of 23 hex colors you can use directly:

```python
import azurea
import matplotlib.pyplot as plt

azurea.use("react_light")
plt.bar(["A", "B", "C", "D", "E"], [30, 55, 42, 78, 60],
        color=azurea.custom_colors[:5])
plt.show()
```

## Test notebook

See [`test_azurea.ipynb`](test_azurea.ipynb) for a full demo covering line, bar, scatter, and histogram plots in both modes, plus the color palette.

## License

MIT © azuka
