Files
cosmos-explorer/preview
dependabot[bot] c6e56692a0 Bump qs from 6.15.2 to 6.16.0 in /preview
Bumps [qs](https://github.com/ljharb/qs) from 6.15.2 to 6.16.0.
- [Changelog](https://github.com/ljharb/qs/blob/main/CHANGELOG.md)
- [Commits](https://github.com/ljharb/qs/compare/v6.15.2...v6.16.0)

---
updated-dependencies:
- dependency-name: qs
  dependency-version: 6.16.0
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>
2026-09-03 05:05:40 +00:00
..
2026-09-02 13:28:31 -07:00
2026-09-02 13:28:31 -07:00
2026-09-02 13:28:31 -07:00

Cosmos Explorer Preview

Cosmos Explorer Preview makes it possible to try a working version of any commit on master or in a PR. No need to run the app locally or deploy to staging.

Initial support is for Hosted (Connection string only) or the Azure Portal. Examples:

Connection string URLs: https://dataexplorer-preview.portal.cosmos.azure.com/commit/COMMIT_SHA/hostedExplorer.html Portal URLs: https://ms.portal.azure.com/?dataExplorerSource=https://dataexplorer-preview.portal.cosmos.azure.com/commit/COMMIT_SHA/explorer.html#home

In both cases replace COMMIT_SHA with the commit you want to view. It must have already completed its build on GitHub Actions.

Architechture

  • This folder contains a NodeJS app deployed to Azure App Service that powers preview URLs:
    • Paths starting with /commit/ are proxied to an Azure Storage account containing build artifacts
    • Paths starting with /proxy/ are proxied dynamically to Cosmos account endpoints. Required otherwise CORS would need to be configured for every account accessed.
    • Paths starting with /api/ are proxied to Portal APIs that do not support CORS.
  • On GitHub Actions build completion:
    • All files in dist are uploaded to an Azure Storage account namespaced by the SHA of the commit
    • /preview/config.json is uploaded to the same folder with preview specific configuration