diff --git a/.gitignore b/.gitignore
index 0f762d2..a1d1fab 100644
--- a/.gitignore
+++ b/.gitignore
@@ -54,3 +54,4 @@ bitmathenv3
bitmathenv2
bitmath2
.vscode
+.DS_Store
diff --git a/README.rst b/README.rst
index 769a2eb..723ad84 100644
--- a/README.rst
+++ b/README.rst
@@ -40,6 +40,10 @@
:alt: License
+.. image:: https://raw.githubusercontent.com/timlnx/bitmath/refs/heads/master/assets/logo/masthead.png
+ :alt: Bitmath logo
+
+
bitmath
=======
@@ -49,9 +53,8 @@ bitmath
* Bugs: https://github.com/timlnx/bitmath/issues
* Contributing: https://bitmath.readthedocs.io/en/latest/contributing.html
-`bitmath `_ simplifies many
-facets of interacting with file sizes in various units. Originally
-focusing on file size unit conversion, functionality now includes:
+`bitmath `_ lets you treat
+files sizes like any other number in Python.
* Converting between **SI** and **NIST** prefix units (``kB`` to ``GiB``)
* Converting between units of the same type (SI to SI, or NIST to NIST)
diff --git a/assets/logo/colored-logo-simple.png b/assets/logo/colored-logo-simple.png
new file mode 100644
index 0000000..2d6322e
Binary files /dev/null and b/assets/logo/colored-logo-simple.png differ
diff --git a/assets/logo/colored-logo.png b/assets/logo/colored-logo.png
new file mode 100644
index 0000000..1001fdb
Binary files /dev/null and b/assets/logo/colored-logo.png differ
diff --git a/assets/logo/colored-logo.svg b/assets/logo/colored-logo.svg
new file mode 100644
index 0000000..5576b07
--- /dev/null
+++ b/assets/logo/colored-logo.svg
@@ -0,0 +1,68 @@
+
+
\ No newline at end of file
diff --git a/assets/logo/colored-logo_simple.svg b/assets/logo/colored-logo_simple.svg
new file mode 100644
index 0000000..2ad8242
--- /dev/null
+++ b/assets/logo/colored-logo_simple.svg
@@ -0,0 +1,63 @@
+
+
\ No newline at end of file
diff --git a/assets/logo/mark.svg b/assets/logo/mark.svg
new file mode 100644
index 0000000..0eea169
--- /dev/null
+++ b/assets/logo/mark.svg
@@ -0,0 +1,31 @@
+
+
\ No newline at end of file
diff --git a/assets/logo/masthead.png b/assets/logo/masthead.png
new file mode 100644
index 0000000..802a5ec
Binary files /dev/null and b/assets/logo/masthead.png differ
diff --git a/assets/logo/masthead.svg b/assets/logo/masthead.svg
new file mode 100644
index 0000000..d934eb0
--- /dev/null
+++ b/assets/logo/masthead.svg
@@ -0,0 +1,89 @@
+
+
\ No newline at end of file