diff --git a/tools/apis/index.md b/tools/apis/index.md
index 81292f188..b685c76e9 100644
--- a/tools/apis/index.md
+++ b/tools/apis/index.md
@@ -12,7 +12,7 @@ This guide is about programmatic CDS design-time APIs.
 The design-time APIs are provided with package `@sap/cds-dk` which needs to be installed locally in your project:
 
 ```sh
-npm add @sap/cds-dk
+npm add @sap/cds-dk --save-dev
 ```
 
 That given, you can use the APIs in your project like this:
@@ -21,6 +21,10 @@ const cds = require('@sap/cds-dk')
 cds.import(...)
 ```
 
+> [!important] Don't load cds-dk code at runtime
+> Note that `@sap/cds-dk` is a design-time dependency that runs locally or in continuous integration (CI) pipelines. 
+> Avoid loading the previously shown code at application runtime in deployed applications.
+
 <script setup>
 import { data as pages } from './index.data.ts'
 </script>