diff --git a/docs/releasenotes/0.8.4.rst b/docs/releasenotes/0.8.4.rst
new file mode 100644
index 00000000..77dc2b04
--- /dev/null
+++ b/docs/releasenotes/0.8.4.rst
@@ -0,0 +1,19 @@
+v0.8.4
+======
+
+- Update README.rst by @tushar5526 in `<https://github.com/p5py/p5/pull/453>`_
+- Fix minor typos in install.rst by @pszemsza in `<https://github.com/p5py/p5/pull/456>`_
+- fix mouse button always set to None in handlers by @tushar5526 in `<https://github.com/p5py/p5/pull/458>`_
+- fix: keyerror 'SQAURE' when using stroke_cap(SQUARE) by @abastola0 in `<https://github.com/p5py/p5/pull/459>`_
+- feat: migrate to 3.11 by @tushar5526 in `<https://github.com/p5py/p5/pull/461>`_
+
+New Contributors
+----------------
+
+* @pszemsza made their first contribution in `<https://github.com/p5py/p5/pull/456>`_
+* @abastola0 made their first contribution in `<https://github.com/p5py/p5/pull/459>`_
+
+Full Changelog
+--------------
+
+`Compare v0.8.1 to v0.8.3 <https://github.com/p5py/p5/compare/v0.8.3...v0.8.4>`_
diff --git a/docs/releasenotes/index.rst b/docs/releasenotes/index.rst
index db729529..b1ae6f7d 100644
--- a/docs/releasenotes/index.rst
+++ b/docs/releasenotes/index.rst
@@ -4,6 +4,7 @@ Release Notes
 .. toctree::
    :maxdepth: 1
 
+   0.8.4
    0.8.3
    0.8.0-0.8.2
    0.7.0-0.7.1
diff --git a/p5/__version__.py b/p5/__version__.py
index 39219562..74a68d7a 100644
--- a/p5/__version__.py
+++ b/p5/__version__.py
@@ -19,7 +19,7 @@
 __title__ = "p5"
 __description__ = "Creative coding in Python"
 __url__ = "https://p5py.github.io"
-__version__ = "0.8.3"
+__version__ = "0.8.4"
 __author__ = "Abhik Pal"
 __author_email__ = "theabhikpal@gmail.com"
 __license__ = " GNU GPLv3"