diff --git a/libs/ui-toolkit/README.md b/libs/ui-toolkit/README.md
index d5785e37d..bd225c7b7 100644
--- a/libs/ui-toolkit/README.md
+++ b/libs/ui-toolkit/README.md
@@ -5,3 +5,11 @@ This library was generated with [Nx](https://nx.dev).
 ## Running unit tests
 
 Run `nx test ui-toolkit` to execute the unit tests via [Jest](https://jestjs.io).
+
+## Build
+
+Run `yarn nx run ui-toolkit:build-storybook`
+
+## Deployment
+
+deployed at: `ui.vega.rocks`