plotform 0.1.0__tar.gz

plotform-0.1.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to Plotform are documented here. The project follows
+[Semantic Versioning](https://semver.org/) while it remains pre-1.0.
+
+## 0.1.0 — Initial public release
+
+### Added
+
+- Minimalist global and scoped Matplotlib themes.
+- Vivid categorical palettes and three continuous colormaps.
+- Native-style `legend`, `bar`, `barh`, `colorbar`, and `annotate` helpers.
+- Exact capsule annotations, circular bar caps, and separate squircle geometry.
+- Solid and soft pill legends with adaptive text contrast.
+- Vertical capsule colorbars with external ticks.
+- Minimal 3D styling and preserved face shading.
+- Bundled Plotform Sans and Plotform Mono fonts with licenses and attribution.
+- A 27-chart comparison gallery, geometry reference board, and native Matplotlib example.
+- CI, package build checks, and trusted-publishing release workflows.
+
+### Removed
+
+- The optional compatibility layer. Use Plotform when themed output is wanted,
+  or ordinary Matplotlib when a script must run without the package.

plotform-0.1.0/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Econ01
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Bundled font software is licensed separately under the SIL Open Font License.
+See src/plotform/assets/fonts/ for the font licenses and attributions.

plotform-0.1.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include pyproject.toml
+recursive-include docs *.md
+recursive-include docs/images *.png
+recursive-include examples *.py
+recursive-include tools *.py
+recursive-include src/plotform/assets/fonts *.ttf *.txt *.md

plotform-0.1.0/PKG-INFO

@@ -0,0 +1,267 @@
+Metadata-Version: 2.4
+Name: plotform
+Version: 0.1.0
+Summary: A minimalist Matplotlib theme and plotting toolkit with customizable palettes, capsule-shaped chart elements, and bundled fonts.
+Author: Econ01
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Econ01/plotform
+Project-URL: Repository, https://github.com/Econ01/plotform
+Project-URL: Issues, https://github.com/Econ01/plotform/issues
+Project-URL: Changelog, https://github.com/Econ01/plotform/blob/main/CHANGELOG.md
+Keywords: matplotlib,plotting,visualization,theme,capsule,publication
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: matplotlib>=3.8
+Requires-Dist: numpy>=1.24
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: fonttools>=4.50; extra == "dev"
+Requires-Dist: pillow>=9; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: tomli>=2; python_version < "3.11" and extra == "dev"
+Dynamic: license-file
+
+# Plotform
+
+[![CI](https://github.com/Econ01/plotform/actions/workflows/ci.yml/badge.svg)](https://github.com/Econ01/plotform/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/plotform.svg)](https://pypi.org/project/plotform/)
+[![Python](https://img.shields.io/pypi/pyversions/plotform.svg)](https://pypi.org/project/plotform/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+**A minimalist Matplotlib theme and plotting toolkit with customizable palettes, capsule-shaped chart elements, and bundled fonts.**
+
+Plotform combines a vivid, minimalist visual style with native-style helpers for pill legends, circularly rounded bars, capsule annotations, vertical capsule colorbars, and clean 3D plots. Fonts are bundled, so system font installation is not required.
+
+[![Plotform examples showing a line chart, rounded bars, a heatmap, and a 3D scatter plot](https://raw.githubusercontent.com/Econ01/plotform/main/docs/images/overview.png)](https://github.com/Econ01/plotform/tree/main/examples)
+
+## Requirements
+
+- Python 3.10 or newer
+- Matplotlib 3.8 or newer
+- NumPy 1.24 or newer
+
+## Installation
+
+```bash
+python -m pip install plotform
+```
+
+For development from a source checkout:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Quick start
+
+```python
+import matplotlib.pyplot as plt
+import plotform as tm
+
+tm.apply_theme()
+
+fig, ax = plt.subplots()
+ax.plot([1, 2, 3], [2, 4, 3], label="Example")
+ax.set(title="A minimalist chart", xlabel="Time", ylabel="Signal")
+tm.legend(ax)
+
+fig.savefig("chart.png", dpi=800)
+fig.savefig("chart.pdf")
+```
+
+`apply_theme()` resets Matplotlib's style before applying Plotform and changes process-global settings. Call it once before creating figures. To preserve and later restore another style, use the scoped form:
+
+```python
+with tm.theme():
+    fig, ax = plt.subplots()
+    ax.plot([1, 2, 3], [2, 4, 3], label="Example")
+    tm.legend(ax)
+    fig.savefig("chart.png")
+# Previous rcParams are restored here.
+```
+
+## Plain Matplotlib, without Plotform
+
+Scripts that must run without the package do not need a compatibility layer. Use native Matplotlib directly:
+
+```python
+import matplotlib.pyplot as plt
+
+fig, ax = plt.subplots()
+ax.bar([0, 1, 2], [3, 5, 4], label="Example")
+ax.legend()
+fig.savefig("plot.png")
+```
+
+`examples/native_matplotlib.py` is a complete instructor-friendly example. Plotform is an opt-in enhancement, not a requirement for these scripts.
+
+## Native-style helpers
+
+| Helper | Purpose |
+| --- | --- |
+| `tm.legend(ax)` | Solid or soft pill legends with adaptive text contrast |
+| `tm.bar(x, height, ax=ax)` | Vertical bars with circular caps |
+| `tm.barh(y, width, ax=ax)` | Horizontal bars with circular caps |
+| `tm.colorbar(image, ax=ax)` | Vertical capsule colorbar with external ticks |
+| `tm.annotate(text, xy, ax=ax)` | Exact capsule annotation |
+| `tm.style_3d(ax)` | Minimal 3D panes, grids, ticks, and viewing angle |
+
+`legend()` uses the current axes when `ax` is omitted. `colorbar()` uses the current figure and axes. Advanced geometry remains available through `plotform.rounded`; font utilities remain available through `plotform.fonts`.
+
+## Fonts
+
+- **Plotform Sans**, derived from Google Sans Flex with `ROND=100` and default weight 400.
+- **Plotform Mono**, derived from Google Sans Code at its default weight.
+- DejaVu fallbacks for mathematical notation and missing glyphs.
+
+The package registers its bundled fonts directly with Matplotlib. No operating-system installation or cache clearing is needed. Font licenses and attribution are included under `src/plotform/assets/fonts/`.
+
+## Colors
+
+The default vivid categorical cycle is:
+
+| Order | Color | Hex |
+| --- | --- | --- |
+| 1 | Teal | `#008080` |
+| 2 | Amber | `#E69F00` |
+| 3 | Blue | `#0072B2` |
+| 4 | Coral/vermillion | `#D55E00` |
+| 5 | Purple | `#6A51A3` |
+| 6 | Green | `#4C9A2A` |
+| 7 | Rose | `#CC79A7` |
+| 8 | Dark slate | `#4B5563` |
+
+Extend the cycle deterministically:
+
+```python
+tm.apply_theme(n_colors=14)
+colors = tm.get_palette(14)
+```
+
+Axes, labels, and ticks are black by default while grids remain light. For muted-gray decorations:
+
+```python
+tm.apply_theme(gray_decorations=True)
+```
+
+Three continuous colormaps are registered:
+
+```python
+ax.imshow(values, cmap=tm.SCALAR_CMAP)  # Full-range scalar default
+ax.imshow(values, cmap=tm.DIVERGING_CMAP)  # Signed/diverging data
+ax.imshow(values, cmap=tm.SEQUENTIAL_CMAP)  # Optional pale brand-teal map
+```
+
+`SCALAR_CMAP` follows navy → blue → teal → green → amber, avoiding near-white endpoints. Use fully opaque scalar markers and `depthshade=False` for mplot3d scatter plots. Use `shade=True` for `bar3d` to preserve face lighting.
+
+## Pill legends
+
+Solid category-color fills use adaptive white or black text, targeting at least 4.5:1 contrast. Marker and line handles are explicitly hidden so they cannot overlap labels.
+
+```python
+tm.legend(ax, ncols=3)
+```
+
+For auxiliary uncertainty regions, use an explicitly tinted entry:
+
+```python
+tm.legend(ax, styles={"95% interval": "soft"})
+```
+
+For dense plots, place the legend outside or add a white group capsule:
+
+```python
+tm.legend(ax, outside=True)
+tm.legend(ax, backdrop=True, backdrop_alpha=0.88)
+```
+
+## Rounded bars and annotations
+
+```python
+import numpy as np
+
+x = np.arange(4)
+
+# Exact semicircular cap with a square baseline.
+tm.bar(x, [3, 5, -2, 4], radius="full", ends="free", ax=ax)
+
+# Complete vertical capsule.
+tm.bar(x, [3, 5, -2, 4], radius="full", ends="both", ax=ax)
+
+# Clamp bars too short for an exact full capsule.
+tm.bar(x, [3, 5, -2, 4], radius="fit", ends="both", ax=ax)
+
+# Numeric circular corner radius.
+tm.bar(x, [3, 5, -2, 4], radius=0.16, ax=ax)
+```
+
+Exact full mode raises a clear error when the display geometry cannot contain the requested semicircle. Use `radius="fit"` to opt into clamping instead.
+
+Annotations use exact stadium geometry:
+
+```python
+tm.annotate("New", (0.15, 0.85), ax=ax, transform=ax.transAxes)
+```
+
+`plotform.rounded` also exposes `capsule_path`, `CapsuleBox`, and separate squircle primitives for advanced use.
+
+[![Exact horizontal and vertical capsule geometry](https://raw.githubusercontent.com/Econ01/plotform/main/docs/images/capsules.png)](https://github.com/Econ01/plotform/blob/main/examples/geometry_check.py)
+
+## Capsule colorbars
+
+```python
+image = ax.imshow(values, cmap=tm.SCALAR_CMAP)
+colorbar = tm.colorbar(image, ax=ax)
+```
+
+The visible gradient is clipped to an exact vertical capsule in display space. Ticks and labels remain outside. Image, contour, streamplot, scatter, and surface mappables are supported. Standard rectangular `fig.colorbar()` output remains available.
+
+## 3D plots
+
+```python
+fig = plt.figure()
+ax = fig.add_subplot(projection="3d")
+tm.style_3d(ax)
+ax.plot_surface(xx, yy, zz, cmap=tm.DIVERGING_CMAP, shade=True)
+```
+
+`style_3d()` clears panes and applies consistent grids, ticks, and viewing geometry. Pass `gray_decorations=True` for muted decorations.
+
+## Visual showcase
+
+```bash
+python examples/showcase.py
+python examples/geometry_check.py
+```
+
+The showcase creates 27 default-versus-Plotform comparisons at 800 DPI, lightweight previews, selected PDF/SVG exports, and a contact sheet under `artifacts/showcase/`. The geometry script creates exact capsule reference boards under `artifacts/`.
+
+[View the complete 27-chart contact sheet](https://github.com/Econ01/plotform/blob/main/docs/images/contact-sheet.png) or regenerate the documentation images with `python tools/make_doc_images.py`.
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+pytest
+ruff check .
+ruff format --check .
+python -m build
+```
+
+See `CHANGELOG.md` for release history and `docs/RELEASING.md` for the GitHub, TestPyPI, and PyPI release process.
+
+## License
+
+Code is MIT licensed. Bundled font software remains under the SIL Open Font License; see the font asset notices for details.

plotform-0.1.0/README.md

@@ -0,0 +1,232 @@
+# Plotform
+
+[![CI](https://github.com/Econ01/plotform/actions/workflows/ci.yml/badge.svg)](https://github.com/Econ01/plotform/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/plotform.svg)](https://pypi.org/project/plotform/)
+[![Python](https://img.shields.io/pypi/pyversions/plotform.svg)](https://pypi.org/project/plotform/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+**A minimalist Matplotlib theme and plotting toolkit with customizable palettes, capsule-shaped chart elements, and bundled fonts.**
+
+Plotform combines a vivid, minimalist visual style with native-style helpers for pill legends, circularly rounded bars, capsule annotations, vertical capsule colorbars, and clean 3D plots. Fonts are bundled, so system font installation is not required.
+
+[![Plotform examples showing a line chart, rounded bars, a heatmap, and a 3D scatter plot](https://raw.githubusercontent.com/Econ01/plotform/main/docs/images/overview.png)](https://github.com/Econ01/plotform/tree/main/examples)
+
+## Requirements
+
+- Python 3.10 or newer
+- Matplotlib 3.8 or newer
+- NumPy 1.24 or newer
+
+## Installation
+
+```bash
+python -m pip install plotform
+```
+
+For development from a source checkout:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Quick start
+
+```python
+import matplotlib.pyplot as plt
+import plotform as tm
+
+tm.apply_theme()
+
+fig, ax = plt.subplots()
+ax.plot([1, 2, 3], [2, 4, 3], label="Example")
+ax.set(title="A minimalist chart", xlabel="Time", ylabel="Signal")
+tm.legend(ax)
+
+fig.savefig("chart.png", dpi=800)
+fig.savefig("chart.pdf")
+```
+
+`apply_theme()` resets Matplotlib's style before applying Plotform and changes process-global settings. Call it once before creating figures. To preserve and later restore another style, use the scoped form:
+
+```python
+with tm.theme():
+    fig, ax = plt.subplots()
+    ax.plot([1, 2, 3], [2, 4, 3], label="Example")
+    tm.legend(ax)
+    fig.savefig("chart.png")
+# Previous rcParams are restored here.
+```
+
+## Plain Matplotlib, without Plotform
+
+Scripts that must run without the package do not need a compatibility layer. Use native Matplotlib directly:
+
+```python
+import matplotlib.pyplot as plt
+
+fig, ax = plt.subplots()
+ax.bar([0, 1, 2], [3, 5, 4], label="Example")
+ax.legend()
+fig.savefig("plot.png")
+```
+
+`examples/native_matplotlib.py` is a complete instructor-friendly example. Plotform is an opt-in enhancement, not a requirement for these scripts.
+
+## Native-style helpers
+
+| Helper | Purpose |
+| --- | --- |
+| `tm.legend(ax)` | Solid or soft pill legends with adaptive text contrast |
+| `tm.bar(x, height, ax=ax)` | Vertical bars with circular caps |
+| `tm.barh(y, width, ax=ax)` | Horizontal bars with circular caps |
+| `tm.colorbar(image, ax=ax)` | Vertical capsule colorbar with external ticks |
+| `tm.annotate(text, xy, ax=ax)` | Exact capsule annotation |
+| `tm.style_3d(ax)` | Minimal 3D panes, grids, ticks, and viewing angle |
+
+`legend()` uses the current axes when `ax` is omitted. `colorbar()` uses the current figure and axes. Advanced geometry remains available through `plotform.rounded`; font utilities remain available through `plotform.fonts`.
+
+## Fonts
+
+- **Plotform Sans**, derived from Google Sans Flex with `ROND=100` and default weight 400.
+- **Plotform Mono**, derived from Google Sans Code at its default weight.
+- DejaVu fallbacks for mathematical notation and missing glyphs.
+
+The package registers its bundled fonts directly with Matplotlib. No operating-system installation or cache clearing is needed. Font licenses and attribution are included under `src/plotform/assets/fonts/`.
+
+## Colors
+
+The default vivid categorical cycle is:
+
+| Order | Color | Hex |
+| --- | --- | --- |
+| 1 | Teal | `#008080` |
+| 2 | Amber | `#E69F00` |
+| 3 | Blue | `#0072B2` |
+| 4 | Coral/vermillion | `#D55E00` |
+| 5 | Purple | `#6A51A3` |
+| 6 | Green | `#4C9A2A` |
+| 7 | Rose | `#CC79A7` |
+| 8 | Dark slate | `#4B5563` |
+
+Extend the cycle deterministically:
+
+```python
+tm.apply_theme(n_colors=14)
+colors = tm.get_palette(14)
+```
+
+Axes, labels, and ticks are black by default while grids remain light. For muted-gray decorations:
+
+```python
+tm.apply_theme(gray_decorations=True)
+```
+
+Three continuous colormaps are registered:
+
+```python
+ax.imshow(values, cmap=tm.SCALAR_CMAP)  # Full-range scalar default
+ax.imshow(values, cmap=tm.DIVERGING_CMAP)  # Signed/diverging data
+ax.imshow(values, cmap=tm.SEQUENTIAL_CMAP)  # Optional pale brand-teal map
+```
+
+`SCALAR_CMAP` follows navy → blue → teal → green → amber, avoiding near-white endpoints. Use fully opaque scalar markers and `depthshade=False` for mplot3d scatter plots. Use `shade=True` for `bar3d` to preserve face lighting.
+
+## Pill legends
+
+Solid category-color fills use adaptive white or black text, targeting at least 4.5:1 contrast. Marker and line handles are explicitly hidden so they cannot overlap labels.
+
+```python
+tm.legend(ax, ncols=3)
+```
+
+For auxiliary uncertainty regions, use an explicitly tinted entry:
+
+```python
+tm.legend(ax, styles={"95% interval": "soft"})
+```
+
+For dense plots, place the legend outside or add a white group capsule:
+
+```python
+tm.legend(ax, outside=True)
+tm.legend(ax, backdrop=True, backdrop_alpha=0.88)
+```
+
+## Rounded bars and annotations
+
+```python
+import numpy as np
+
+x = np.arange(4)
+
+# Exact semicircular cap with a square baseline.
+tm.bar(x, [3, 5, -2, 4], radius="full", ends="free", ax=ax)
+
+# Complete vertical capsule.
+tm.bar(x, [3, 5, -2, 4], radius="full", ends="both", ax=ax)
+
+# Clamp bars too short for an exact full capsule.
+tm.bar(x, [3, 5, -2, 4], radius="fit", ends="both", ax=ax)
+
+# Numeric circular corner radius.
+tm.bar(x, [3, 5, -2, 4], radius=0.16, ax=ax)
+```
+
+Exact full mode raises a clear error when the display geometry cannot contain the requested semicircle. Use `radius="fit"` to opt into clamping instead.
+
+Annotations use exact stadium geometry:
+
+```python
+tm.annotate("New", (0.15, 0.85), ax=ax, transform=ax.transAxes)
+```
+
+`plotform.rounded` also exposes `capsule_path`, `CapsuleBox`, and separate squircle primitives for advanced use.
+
+[![Exact horizontal and vertical capsule geometry](https://raw.githubusercontent.com/Econ01/plotform/main/docs/images/capsules.png)](https://github.com/Econ01/plotform/blob/main/examples/geometry_check.py)
+
+## Capsule colorbars
+
+```python
+image = ax.imshow(values, cmap=tm.SCALAR_CMAP)
+colorbar = tm.colorbar(image, ax=ax)
+```
+
+The visible gradient is clipped to an exact vertical capsule in display space. Ticks and labels remain outside. Image, contour, streamplot, scatter, and surface mappables are supported. Standard rectangular `fig.colorbar()` output remains available.
+
+## 3D plots
+
+```python
+fig = plt.figure()
+ax = fig.add_subplot(projection="3d")
+tm.style_3d(ax)
+ax.plot_surface(xx, yy, zz, cmap=tm.DIVERGING_CMAP, shade=True)
+```
+
+`style_3d()` clears panes and applies consistent grids, ticks, and viewing geometry. Pass `gray_decorations=True` for muted decorations.
+
+## Visual showcase
+
+```bash
+python examples/showcase.py
+python examples/geometry_check.py
+```
+
+The showcase creates 27 default-versus-Plotform comparisons at 800 DPI, lightweight previews, selected PDF/SVG exports, and a contact sheet under `artifacts/showcase/`. The geometry script creates exact capsule reference boards under `artifacts/`.
+
+[View the complete 27-chart contact sheet](https://github.com/Econ01/plotform/blob/main/docs/images/contact-sheet.png) or regenerate the documentation images with `python tools/make_doc_images.py`.
+
+## Development
+
+```bash
+python -m pip install -e ".[dev]"
+pytest
+ruff check .
+ruff format --check .
+python -m build
+```
+
+See `CHANGELOG.md` for release history and `docs/RELEASING.md` for the GitHub, TestPyPI, and PyPI release process.
+
+## License
+
+Code is MIT licensed. Bundled font software remains under the SIL Open Font License; see the font asset notices for details.

plotform-0.1.0/docs/RELEASING.md

@@ -0,0 +1,125 @@
+# Releasing Plotform
+
+This project uses GitHub Actions and PyPI **trusted publishing** (OIDC). Do not
+store long-lived PyPI tokens in the repository.
+
+## 1. Validate the source
+
+Before creating a release:
+
+```bash
+pytest
+ruff check .
+ruff format --check .
+python -m build
+python tools/check_sdist.py
+```
+
+Install the wheel into a clean environment and run a small import and plotting
+smoke test. The CI workflow must also be green.
+
+## 2. Push the release branch
+
+The repository remote is `https://github.com/Econ01/plotform.git`.
+
+If using the `release/0.1.0` branch:
+
+```bash
+git push -u origin release/0.1.0
+```
+
+Open a pull request into `main`, review the diff and CI checks, and merge when
+ready. A direct push to `main` is also possible for a solo project, but the pull
+request provides a useful release review.
+
+## 3. Create GitHub environments
+
+In **Settings → Environments**, create:
+
+- `testpypi`
+- `pypi`
+
+For the first production release, require manual approval on the `pypi`
+environment so publication cannot happen accidentally.
+
+## 4. Configure TestPyPI trusted publishing
+
+Sign in to TestPyPI and add a **pending trusted publisher** with exactly:
+
+- PyPI project name: `plotform`
+- Owner: `Econ01`
+- Repository name: `plotform`
+- Workflow name: `release.yml`
+- Environment name: `testpypi`
+
+If a TestPyPI project already exists, add the publisher under its publishing
+settings instead.
+
+## 5. Configure production PyPI trusted publishing
+
+On production PyPI, add the same publisher identity, except:
+
+- Environment name: `pypi`
+
+The workflow filename and environment names must match exactly. GitHub Actions
+uses these values when requesting an OIDC token.
+
+## 6. Publish to TestPyPI
+
+In the GitHub repository, open **Actions → Release → Run workflow** and run the
+workflow on the release branch. A manual workflow run publishes only to
+TestPyPI; production publication happens through a GitHub release.
+
+Then create a clean environment and install:
+
+```bash
+python -m pip install \
+  --index-url https://test.pypi.org/simple/ \
+  --extra-index-url https://pypi.org/simple/ \
+  plotform
+```
+
+The extra index supplies dependencies such as Matplotlib and NumPy that may not
+be available on TestPyPI.
+
+Verify:
+
+```python
+import plotform as tm
+
+assert tm.__version__ == "0.1.0"
+tm.apply_theme()
+```
+
+Run a small plotting example as well.
+
+## 7. Create the production release
+
+After TestPyPI validation:
+
+1. Ensure `pyproject.toml` contains version `0.1.0`.
+2. Update `CHANGELOG.md` if needed.
+3. Create and push tag `v0.1.0`:
+
+   ```bash
+   git tag -a v0.1.0 -m "Plotform 0.1.0"
+   git push origin v0.1.0
+   ```
+
+4. In GitHub, choose **Releases → Draft a new release**, select `v0.1.0`, add
+   the changelog notes, and publish.
+5. The Release workflow checks the tag, builds the distributions, and publishes
+   to production PyPI through the `pypi` environment.
+6. Approve the production environment if protection is enabled.
+
+## 8. Verify the public installation
+
+In another clean environment:
+
+```bash
+python -m pip install plotform
+python -c "import plotform; print(plotform.__version__)"
+```
+
+Finally, add the repository description, topics, and PyPI link in GitHub's About
+section. The README already contains CI, PyPI, Python, and license badges.