diff --git a/docs/source/conf.py b/docs/source/conf.py
index a956b38..1af8efd 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -78,9 +78,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'1.0.0a0'
+version = u'1.0.0'
 # The full version, including alpha/beta/rc tags.
-release = u'1.0.0a0'
+release = u'1.0.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/falwa/__init__.py b/falwa/__init__.py
index 6fe1204..74494cc 100644
--- a/falwa/__init__.py
+++ b/falwa/__init__.py
@@ -4,7 +4,7 @@
 Author: Clare Huang, Christopher Polster
 """
 
-__version__ = "1.0.0a0"
+__version__ = "1.0.0"
 from .interpolate_fields import interpolate_fields
 from .interpolate_fields_direct_inv import interpolate_fields_direct_inv
 from .compute_qref_and_fawa_first import compute_qref_and_fawa_first
diff --git a/readme.md b/readme.md
index 08f644c..9d2e977 100644
--- a/readme.md
+++ b/readme.md
@@ -1,7 +1,8 @@
-## Python Library: falwa (v1.0.0a0)
+## Python Library: falwa (v1.0.0)
 
 [![Build Status](https://github.com/csyhuang/hn2016_falwa/actions/workflows/python-build-test.yml/badge.svg)](https://github.com/csyhuang/hn2016_falwa/actions/workflows/workflow.yml)[![codecov.io](https://codecov.io/gh/csyhuang/hn2016_falwa/branch/master/graph/badge.svg)](https://codecov.io/gh/csyhuang/hn2016_falwa)[![Documentation Status](https://readthedocs.org/projects/hn2016-falwa/badge/?version=latest)](http://hn2016-falwa.readthedocs.io/en/latest/?badge=latest)[![DOI](https://zenodo.org/badge/63908662.svg)](https://zenodo.org/badge/latestdoi/63908662)
 
+**Important:** this python package has been renamed from `hn2016_falwa` to `falwa` since version v1.0.0.
 
 ![hn2016_falwa_diagram](https://github.com/csyhuang/csyhuang.github.io/blob/master/assets/img/hn2016_falwa_diagram.png)
 
diff --git a/recipe/meta.yaml b/recipe/meta.yaml
index 4140197..c423935 100644
--- a/recipe/meta.yaml
+++ b/recipe/meta.yaml
@@ -1,6 +1,6 @@
 package:
   name: "falwa"
-  version: "1.0.0a0"
+  version: "1.0.0"
 
 source:
   path: ../
diff --git a/setup.py b/setup.py
index e2d28ab..a41d9cb 100644
--- a/setup.py
+++ b/setup.py
@@ -60,7 +60,7 @@
 
 setup(
     name='falwa',
-    version='1.0.0a0',
+    version='1.0.0',
     description='python package to compute finite-amplitude local wave activity (Huang and Nakamura 2016, JAS)',
     long_description=LONG_DESCRIPTION,
     long_description_content_type='text/markdown',
@@ -74,6 +74,7 @@
     install_requires=['numpy', 'scipy', 'xarray'],
     tests_require=['pytest'],
     test_suite="tests",
+    obsoletes_dist="hn2016_falwa",
     ext_modules=[ext1, ext2, ext3, ext4, ext5, ext6, ext7, ext8, ext9],
     zip_safe=False
 )