diff --git a/.github/workflows/gh_pages.yml b/.github/workflows/gh_pages.yml
index 3d7a4586..759aa9bd 100644
--- a/.github/workflows/gh_pages.yml
+++ b/.github/workflows/gh_pages.yml
@@ -13,21 +13,19 @@ jobs:
         uses: actions/setup-python@v6
         with:
           python-version: '3.13'
-      - name: install dependencies
+      - name: Install dependencies
         run: |
-          python -m pip install --upgrade pip
-          python -m pip install .
-          python -m pip install sphinx
-          python -m pip install sphinx_rtd_theme
-          python -m pip install sphinx-click
-      - name: build documentation
+          pip install ".[docs]"
+
+      - name: Build the documentation
         run: |
-          cd docs
-          make html
-      - name: deploy
-        uses: peaceiris/actions-gh-pages@v3.6.1
+          jupyter-book build docs
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v5
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs/_build/html
-          force_orphan: true
-          full_commit_message: ${{ github.event.head_commit.message }}
+          path: "docs/_build/html"
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5
diff --git a/pyproject.toml b/pyproject.toml
index cabd7202..25dd982e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -10,7 +10,7 @@ authors = [
   {name = "Rob Hammond", email = "rob.hammond@nlr.gov"},
   {name = "Jake Nunemaker", email = "jacob.nunemaker@nlr.gov"},
 ]
-readme = {file = "README.rst", content-type = "text/x-rst"}
+readme = {file = "README.md", content-type = "text/markdown"}
 description = "Offshore Renewables Balance of system and Installation Tool"
 requires-python = ">3.9"
 license = {file = "LICENSE"}