DX | 12-08-2026 | Release | Back-merge

.env.example

@@ -4,5 +4,5 @@ NG_APP_CONTENTSTACK_API_KEY=your_api_key_here
 NG_APP_CONTENTSTACK_DELIVERY_TOKEN=your_delivery_token_here
 NG_APP_CONTENTSTACK_PREVIEW_TOKEN=your_preview_token_here
 NG_APP_CONTENTSTACK_ENVIRONMENT=preview
-NG_APP_CONTENTSTACK_REGION=EU
+NG_APP_CONTENTSTACK_REGION=EU # Options: NA, EU, AU, AZURE-NA, AZURE-EU, GCP-NA, GCP-EU
 NG_APP_CONTENTSTACK_PREVIEW=true

.github/workflows/sca-scan.yml

@@ -5,6 +5,9 @@ on:
 jobs:
   security-sca:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
     steps:
       - uses: actions/checkout@master
       - name: Run Snyk to check for vulnerabilities
@@ -13,3 +16,6 @@ jobs:
           SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
         with:
           args: --all-projects --fail-on=all
+          json: true
+        continue-on-error: true
+      - uses: contentstack/sca-policy@main

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Contentstack
+Copyright (c) 2026 Contentstack
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -113,3 +113,43 @@ Go to `http://localhost:4200/`.
 Go to Entries and select the only entry in the list.
 In the sidebar, click on the live preview icon.
 Or, click on visual experience in the sidebar.
+
+## Regions and endpoint configuration
+
+Set `NG_APP_CONTENTSTACK_REGION` to the value matching your Contentstack account region:
+
+| Region | Value |
+|---|---|
+| North America (default) | `NA` or `US` |
+| Europe | `EU` |
+| Australia | `AU` |
+| Azure North America | `AZURE-NA` |
+| Azure Europe | `AZURE-EU` |
+| GCP North America | `GCP-NA` |
+| GCP Europe | `GCP-EU` |
+
+The app uses `getContentstackEndpoint` from `@contentstack/utils` to resolve the correct API hostnames for your region automatically (via `generate-env.js` at build time). The following endpoint keys are resolved:
+
+| Key | NA value |
+|---|---|
+| `contentDelivery` | `cdn.contentstack.io` |
+| `preview` | `rest-preview.contentstack.com` |
+| `application` | `app.contentstack.com` |
+| `graphqlDelivery` | `graphql.contentstack.com` |
+| `graphqlPreview` | `graphql-preview.contentstack.com` |
+| `images` | `images.contentstack.io` |
+| `assets` | `assets.contentstack.io` |
+| `contentManagement` | `api.contentstack.io` |
+| `auth` | `auth.contentstack.io` |
+
+### Custom or dedicated environments
+
+If you are on a dedicated or private cloud Contentstack instance, you can override the resolved endpoints via environment variables:
+
+```
+NG_APP_CONTENTSTACK_CONTENT_DELIVERY=your-custom-cdn.example.com
+NG_APP_CONTENTSTACK_PREVIEW_HOST=your-custom-preview.example.com
+NG_APP_CONTENTSTACK_CONTENT_APPLICATION=your-custom-app.example.com
+```
+
+These override values take precedence over the region-resolved endpoints.

generate-env.js

@@ -1,9 +1,6 @@
 #!/usr/bin/env node
 
-const {
-  getContentstackEndpoints,
-  getRegionForString,
-} = require("@timbenniks/contentstack-endpoints");
+const { getContentstackEndpoint } = require("@contentstack/utils");
 
 const fs = require("fs");
 const path = require("path");
@@ -30,8 +27,7 @@ if (fs.existsSync(envPath)) {
   });
 }
 
-const region = getRegionForString(envVars.NG_APP_CONTENTSTACK_REGION);
-const endpoints = getContentstackEndpoints(region, true);
+const endpoints = getContentstackEndpoint(envVars.NG_APP_CONTENTSTACK_REGION || 'NA', '', true);
 
 // Generate environment.ts content
 const environmentContent = `export const environment = {
@@ -41,21 +37,12 @@ const environmentContent = `export const environment = {
     deliveryToken: '${envVars.NG_APP_CONTENTSTACK_DELIVERY_TOKEN || ""}',
     previewToken: '${envVars.NG_APP_CONTENTSTACK_PREVIEW_TOKEN || ""}',
     environment: '${envVars.NG_APP_CONTENTSTACK_ENVIRONMENT || "preview"}',
-    region: '${region ? region : envVars.NG_APP_CONTENTSTACK_REGION}',
+    region: '${envVars.NG_APP_CONTENTSTACK_REGION || "NA"}',
     preview: ${envVars.NG_APP_CONTENTSTACK_PREVIEW === "true"},
 
-    contentDelivery: '${
-      envVars.NG_APP_CONTENTSTACK_CONTENT_DELIVERY ||
-      (endpoints && endpoints.contentDelivery)
-    }',
-    previewHost: '${
-      envVars.NG_APP_CONTENTSTACK_PREVIEW_HOST ||
-      (endpoints && endpoints.preview)
-    }',
-    applicationHost: '${
-      envVars.NG_APP_CONTENTSTACK_CONTENT_APPLICATION ||
-      (endpoints && endpoints.application)
-    }'
+    contentDelivery: '${envVars.NG_APP_CONTENTSTACK_CONTENT_DELIVERY || endpoints.contentDelivery}',
+    previewHost: '${envVars.NG_APP_CONTENTSTACK_PREVIEW_HOST || endpoints.preview}',
+    applicationHost: '${envVars.NG_APP_CONTENTSTACK_CONTENT_APPLICATION || endpoints.application}'
   }
 };
 `;
@@ -68,21 +55,12 @@ const environmentProdContent = `export const environment = {
     deliveryToken: '${envVars.NG_APP_CONTENTSTACK_DELIVERY_TOKEN || ""}',
     previewToken: '${envVars.NG_APP_CONTENTSTACK_PREVIEW_TOKEN || ""}',
     environment: '${envVars.NG_APP_CONTENTSTACK_ENVIRONMENT || "preview"}',
-    region: '${region ? region : envVars.NG_APP_CONTENTSTACK_REGION}',
+    region: '${envVars.NG_APP_CONTENTSTACK_REGION || "NA"}',
     preview: ${envVars.NG_APP_CONTENTSTACK_PREVIEW === "true"},
 
-    contentDelivery: '${
-      envVars.NG_APP_CONTENTSTACK_CONTENT_DELIVERY ||
-      (endpoints && endpoints.contentDelivery)
-    }',
-    previewHost: '${
-      envVars.NG_APP_CONTENTSTACK_PREVIEW_HOST ||
-      (endpoints && endpoints.preview)
-    }',
-    applicationHost: '${
-      envVars.NG_APP_CONTENTSTACK_CONTENT_APPLICATION ||
-      (endpoints && endpoints.application)
-    }'
+    contentDelivery: '${envVars.NG_APP_CONTENTSTACK_CONTENT_DELIVERY || endpoints.contentDelivery}',
+    previewHost: '${envVars.NG_APP_CONTENTSTACK_PREVIEW_HOST || endpoints.preview}',
+    applicationHost: '${envVars.NG_APP_CONTENTSTACK_CONTENT_APPLICATION || endpoints.application}'
 
   }
 };