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

.env.example

@@ -4,5 +4,5 @@ VITE_CONTENTSTACK_API_KEY=your_api_key_here
 VITE_CONTENTSTACK_DELIVERY_TOKEN=your_delivery_token_here
 VITE_CONTENTSTACK_PREVIEW_TOKEN=your_preview_token_here
 VITE_CONTENTSTACK_ENVIRONMENT=preview
-VITE_CONTENTSTACK_REGION=EU # Options: EU or NA
+VITE_CONTENTSTACK_REGION=EU # Options: NA, EU, AU, AZURE-NA, AZURE-EU, GCP-NA, GCP-EU
 VITE_CONTENTSTACK_PREVIEW=true # Set to true to enable preview

.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

.npmrc

@@ -1 +1,2 @@
-engine-strict=true
+engine-strict=false
+optional=true

.vscode/settings.json

@@ -0,0 +1 @@
+{}

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

@@ -103,4 +103,44 @@ Go to `http://localhost:5173`.
 
 Go to Entries and select the only entry in the list.
 In the sidebar, click on the live preview icon.
-Or, see your entry in the visual builder
+Or, see your entry in the visual builder
+
+## Regions and endpoint configuration
+
+Set `VITE_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. 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:
+
+```
+VITE_CONTENTSTACK_CONTENT_DELIVERY=your-custom-cdn.example.com
+VITE_CONTENTSTACK_PREVIEW_HOST=your-custom-preview.example.com
+VITE_CONTENTSTACK_CONTENT_APPLICATION=your-custom-app.example.com
+```
+
+These override values take precedence over the region-resolved endpoints.