diff --git a/README.md b/README.md
index 5d3529e..e13e938 100644
--- a/README.md
+++ b/README.md
@@ -2,20 +2,20 @@
 
 [![Build Status](https://github.com/criticalstack/ui/workflows/push/badge.svg)](https://github.com/criticalstack/ui/actions)
 
-The Critical Stack UI! See [design](./docs/design.md) for more details.
+The Critical Stack UI! See [the design docs](https://criticalstack.github.io/ui/design.html) for more details.
 
 ![demo](./docs/src/images/demo.gif)
 
 ## Features
 
-- [SSO integration](./docs/sso.md) via [Dex](https://dexidp.io/)
-- [Helm Marketplace](./docs/marketplace.md)
+- [SSO integration](https://criticalstack.github.io/ui/features/sso.html) via [Dex](https://dexidp.io/)
+- [Helm Marketplace](https://criticalstack.github.io/ui/features/marketplace.html)
 - Container Shell & Logs View
-- [Developer Shell](./docs/shell.md)
-- [Intuitive Cluster Access Management](./docs/user-management.md)
+- [Developer Shell](https://criticalstack.github.io/ui/features/developer-shell.html)
+- [Intuitive Cluster Access Management](https://criticalstack.github.io/ui/features/user-management.html)
 - Namespace Resource Overview
-- [Worker Management](./docs/machine-api.md) via [machine-api](https://github.com/criticalstack/machine-api)
-- [StackApps Integration](./docs/stackapps.md)
+- [Worker Management](https://criticalstack.github.io/ui/features/machine-api.html) via [machine-api](https://github.com/criticalstack/machine-api)
+- [StackApps Integration](https://criticalstack.github.io/ui/features/stackapps.html)
 
 ## Installation
 
@@ -23,7 +23,7 @@ Deployable as a Helm chart: see TODO docs link
 
 ## Troubleshooting
 
-Check out our [Frequently Asked Questions](./docs/faq.md)
+Check out our [Frequently Asked Questions](https://criticalstack.github.io/ui/faq.html)
 
 ## Contributing