docs(getting-started): add guide for customizing base URLs

Add a new documentation page explaining how to override the default developer hub
and assets base URLs in Clever Cloud components.
Includes usage examples for `setDevHubBaseUrl` and `setAssetsBaseUrl`, and highlights
the importance of configuring URLs before importing components.

Author: florian-sanders-cc

docs/getting-started/custom-base-urls.md

@@ -0,0 +1,68 @@
+---
+kind: '🚀 Getting started'
+title: 'Customizing base URLs'
+---
+
+# Customizing base URLs
+
+By default, Clever Cloud components generate URLs that point to:
+* `https://www.clever.cloud/developers` for documentation and developer hub links
+* `https://assets.clever-cloud.com` for static assets
+
+You can override these base URLs.
+
+## Customizing the developer hub base URL
+
+Use `setDevHubBaseUrl()` to change the base URL for documentation and developer hub links.
+
+```js
+import { setDevHubBaseUrl } from '@clevercloud/components/dist/dev-hub-url.js';
+
+// Set a custom base URL
+setDevHubBaseUrl('https://staging.clever-cloud.com/developers');
+
+// Now import components
+import '@clevercloud/components/dist/cc-addon-info.js';
+```
+
+After this configuration, all documentation links generated by components will use your custom base URL:
+
+* `getDocUrl('/addons/postgresql')` → `https://staging.clever-cloud.com/developers/doc/addons/postgresql`
+* `getDevHubUrl('/api/v4')` → `https://staging.clever-cloud.com/developers/api/v4`
+
+## Customizing the assets base URL
+
+Use `setAssetsBaseUrl()` to change the base URL for static assets like logos, flags, and icons.
+
+```js
+import { setAssetsBaseUrl } from '@clevercloud/components/dist/assets-url.js';
+
+// Set a custom assets URL
+setAssetsBaseUrl('https://cdn.example.com');
+
+// Now import components
+import '@clevercloud/components/dist/cc-addon-info.js';
+```
+
+After this configuration, all asset URLs generated by components will use your custom base URL:
+
+* `getAssetUrl('/logos/java-jar.svg')` → `https://cdn.example.com/logos/java-jar.svg`
+* `getFlagUrl('fr')` → `https://cdn.example.com/flags/fr.svg`
+
+## Important: call before importing components
+
+You **must** call `setDevHubBaseUrl()` and `setAssetsBaseUrl()` **before** importing any components. Otherwise, some URLs may still use the default base URLs.
+
+```js
+import { setDevHubBaseUrl } from '@clevercloud/components/dist/dev-hub-url.js';
+import { setAssetsBaseUrl } from '@clevercloud/components/dist/assets-url.js';
+
+// Configure base URLs first
+setDevHubBaseUrl('https://staging.clever-cloud.com/developers');
+setAssetsBaseUrl('https://cdn.example.com');
+
+// Then import components
+import '@clevercloud/components/dist/cc-addon-info.js';
+import '@clevercloud/components/dist/cc-invoice-list.js';
+```
+