OpenStudio Website

Static marketing site and public release-surface publisher for openstudio.org.in.

This repo is now the only public publisher for:

/releases/latest.json
/releases/stable/latest.json
/releases/ai-runtime/latest.json
/releases/ai-runtime/stable/latest.json
/appcast/windows-stable.xml
/appcast/macos-stable.xml
/appcast/linux-stable.xml
/download/windows/latest
/download/macos/latest
/download/linux/latest
/download/ai-runtime/windows/latest
/download/ai-runtime/macos/latest
/download/ai-runtime/macos/arm64/latest
/download/ai-runtime/macos/x64/latest
/download/ai-runtime/linux/latest
/download/ai-runtime/linux/x64/latest
/download/ai-runtime/linux/arm64/latest

GitHub Releases remain the binary origin. This repo publishes release metadata and appcasts, then exposes stable redirect surfaces that resolve to GitHub-hosted binaries.

Local

npm install
npm run dev

Build

npm run stage-release-publish-inputs
npm run validate-release-publish-inputs
npm run build
npm run preview

npm run build stages deploy inputs into public/, validates them again from the staged output, and then runs the Vite build.

Deploy Inputs

The desktop release pipeline is expected to generate these files and publish them as GitHub Release assets. The website workflow or a local operator stages them into release-input/ before the build runs.

Expected staged deploy-input files:

release-input/releases/latest.json
release-input/releases/stable/latest.json
release-input/releases/ai-runtime/latest.json
release-input/releases/ai-runtime/stable/latest.json
release-input/appcast/windows-stable.xml
release-input/appcast/macos-stable.xml
release-input/appcast/linux-stable.xml when releases/stable/latest.json includes platforms.linux

Expected desktop release asset filenames:

OpenStudio-release-latest.json
OpenStudio-release-stable-latest.json
OpenStudio-ai-runtime-latest.json
OpenStudio-ai-runtime-stable-latest.json
OpenStudio-appcast-windows-stable.xml
OpenStudio-appcast-macos-stable.xml
OpenStudio-appcast-linux-stable.xml when Linux app metadata is published

Common AI runtime binary asset names referenced by metadata:

OpenStudio-AI-Runtime-windows-base-x64.zip
OpenStudio-AI-Runtime-windows-directml-x64.zip when a downloadable backend archive is published instead of an install plan
OpenStudio-AI-Runtime-windows-cuda-x64.zip when a downloadable backend archive is published instead of an install plan
OpenStudio-AI-Runtime-macos-arm64.zip
OpenStudio-AI-Runtime-macos-x64.zip
OpenStudio-AI-Runtime-linux-x64.zip
OpenStudio-AI-Runtime-linux-arm64.zip

Published output paths:

/releases/latest.json
/releases/stable/latest.json
/releases/ai-runtime/latest.json
/releases/ai-runtime/stable/latest.json
/appcast/windows-stable.xml
/appcast/macos-stable.xml
/appcast/linux-stable.xml when provided

Validation rules:

app release root/stable manifests must both exist and match after JSON normalization
AI runtime root/stable manifests must both exist and match after JSON normalization
app release JSON must include schemaVersion, channel, version, publishedAt, releasePageUrl, platforms.windows, and platforms.macos; platforms.linux is optional
AI runtime JSON must include schemaVersion, channel, appVersion, runtimeVersion, publishedAt, platforms.windows, and platforms.macos; platforms.linux is optional
AI runtime Windows metadata may be published as a legacy flat platforms.windows entry, an old nested backend-asset shape under platforms.windows.backends, the new platforms.windows.base plus platforms.windows.backends.<backend>.installPlan shape, or a mixed transition manifest that contains both legacy and new fields
AI runtime macOS metadata may be published either as the legacy flat platforms.macos entry or as the current nested platforms.macos.arm64 and platforms.macos.x64 entries
AI runtime Linux metadata may be published either as a legacy flat platforms.linux entry or as nested platforms.linux.x64 and platforms.linux.arm64 entries
downloadable manifest asset entries must include url, sha256, size, and fileName
Windows backend install-plan entries must expose an installPlan object and are published verbatim
Windows and macOS stable appcasts must be present, valid XML, and align with the stable app manifest enclosure data; the Linux appcast is required when Linux app metadata is published

Current AI runtime manifest shape:

{
  "schemaVersion": 4,
  "channel": "stable",
  "appVersion": "0.0.22",
  "runtimeVersion": "2026.04.05",
  "publishedAt": "2026-04-05T00:00:00.000Z",
  "platforms": {
    "windows": {
      "base": {
        "url": "https://github.com/sdevil7th/OpenStudio/releases/download/v0.0.22/OpenStudio-AI-Runtime-windows-base-x64.zip",
        "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
        "size": 123,
        "fileName": "OpenStudio-AI-Runtime-windows-base-x64.zip"
      },
      "backends": {
        "cuda": {
          "installPlan": {
            "version": 1,
            "steps": [
              {
                "action": "detect",
                "backend": "cuda"
              },
              {
                "action": "install",
                "package": "openstudio-cuda-runtime"
              }
            ]
          }
        },
        "directml": {
          "installPlan": {
            "version": 1,
            "steps": [
              {
                "action": "detect",
                "backend": "directml"
              },
              {
                "action": "install",
                "package": "openstudio-directml-runtime"
              }
            ]
          }
        }
      }
    },
    "macos": {
      "arm64": {
        "url": "https://github.com/sdevil7th/OpenStudio/releases/download/v0.0.22/OpenStudio-AI-Runtime-macos-arm64.zip",
        "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
        "size": 123,
        "fileName": "OpenStudio-AI-Runtime-macos-arm64.zip"
      },
      "x64": {
        "url": "https://github.com/sdevil7th/OpenStudio/releases/download/v0.0.22/OpenStudio-AI-Runtime-macos-x64.zip",
        "sha256": "fedcba9876543210fedcba9876543210fedcba9876543210fedcba9876543210",
        "size": 123,
        "fileName": "OpenStudio-AI-Runtime-macos-x64.zip"
      }
    },
    "linux": {
      "x64": {
        "url": "https://github.com/sdevil7th/OpenStudio/releases/download/v0.0.22/OpenStudio-AI-Runtime-linux-x64.zip",
        "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "size": 123,
        "fileName": "OpenStudio-AI-Runtime-linux-x64.zip"
      },
      "arm64": {
        "url": "https://github.com/sdevil7th/OpenStudio/releases/download/v0.0.22/OpenStudio-AI-Runtime-linux-arm64.zip",
        "sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
        "size": 123,
        "fileName": "OpenStudio-AI-Runtime-linux-arm64.zip"
      }
    }
  }
}

Environment Variables And Secrets

Build/runtime env:

GITHUB_TOKEN
- Optional at runtime, recommended to reduce GitHub API rate-limit risk for the snapshot and installer redirect functions.
OPENSTUDIO_RELEASE_METADATA_DIR
- Optional. Defaults to release-input.
OPENSTUDIO_REQUIRE_RELEASE_METADATA
- Optional in local dev.
- Set to true for release-publish builds so missing or malformed metadata/appcasts fail the build.
OPENSTUDIO_DESKTOP_REPO
- Optional. Defaults to sdevil7th/OpenStudio.
- Used by runtime GitHub helpers and by the publish workflow contract.

Website workflow secrets:

NETLIFY_AUTH_TOKEN
NETLIFY_SITE_ID
OPENSTUDIO_RELEASE_SOURCE_TOKEN
- Optional but recommended if desktop release assets are private or if you want a dedicated token for release asset downloads.

Desktop-side secret outside this repo:

a token with permission to send repository_dispatch events to this website repo

Redirect Behavior

/download/windows/latest, /download/macos/latest, and /download/linux/latest resolve from /releases/stable/latest.json first, then fall back to GitHub latest-release asset matching if metadata is not available.
/download/ai-runtime/windows/latest resolves to platforms.windows.base.url when the new Windows manifest shape is present, otherwise it falls back to the legacy flat platforms.windows.url entry when available.
Windows backend install-plan metadata is preserved verbatim in the published JSON at /releases/ai-runtime/latest.json and /releases/ai-runtime/stable/latest.json.
/download/ai-runtime/windows/latest does not treat platforms.windows.backends.cuda or platforms.windows.backends.directml as downloadable URLs when those entries only contain installPlan.
/download/ai-runtime/macos/arm64/latest and /download/ai-runtime/macos/x64/latest resolve from the published AI runtime manifest and should be preferred when the caller knows the target architecture.
/download/ai-runtime/macos/latest remains a best-effort convenience redirect. It still supports the legacy flat macOS manifest entry, and for the new nested shape it will honor ?arch=arm64 or ?arch=x64 when present, otherwise it only redirects when it can infer the architecture safely.
/download/ai-runtime/linux/x64/latest and /download/ai-runtime/linux/arm64/latest resolve from the published AI runtime manifest and should be preferred when the caller knows the target architecture.
/download/ai-runtime/linux/latest supports the legacy flat Linux manifest entry and otherwise falls back to x64, then arm64, when no architecture is provided.
Netlify never hosts the .exe, .dmg, .AppImage, or AI runtime archive files.

Website Publish Workflow

This repo includes a release-publish workflow triggered by repository_dispatch.

Assumed event name:

openstudio_release_published

Assumed payload shape:

{
  "tag": "v1.2.3",
  "channel": "stable",
  "desktopRepo": "sdevil7th/OpenStudio"
}

Workflow behavior:

validate the dispatch payload and reject non-stable channels
validate desktopRepo matches the configured OPENSTUDIO_DESKTOP_REPO
download the generated metadata/appcast assets from the desktop GitHub Release for tag, including the Linux appcast when present
map them into release-input/
run npm ci
run npm run validate-release-publish-inputs -- --root release-input
run npm run build with OPENSTUDIO_REQUIRE_RELEASE_METADATA=true
deploy dist/ to Netlify

Netlify

Netlify config lives in netlify.toml.
Release metadata and appcasts are published as static files from the site build output.
The latest download paths are real Netlify redirects/functions, not React routes.
All metadata and appcast surfaces are served with:
- Cache-Control: no-store, no-cache, must-revalidate, max-age=0

Manual Verification

After deploy, verify:

curl https://openstudio.org.in/releases/latest.json
curl https://openstudio.org.in/releases/stable/latest.json
curl https://openstudio.org.in/releases/ai-runtime/latest.json
curl https://openstudio.org.in/releases/ai-runtime/stable/latest.json
curl https://openstudio.org.in/appcast/windows-stable.xml
curl https://openstudio.org.in/appcast/macos-stable.xml
curl https://openstudio.org.in/appcast/linux-stable.xml
curl -I https://openstudio.org.in/download/windows/latest
curl -I https://openstudio.org.in/download/macos/latest
curl -I https://openstudio.org.in/download/linux/latest
curl -I https://openstudio.org.in/download/ai-runtime/windows/latest
curl -I https://openstudio.org.in/download/ai-runtime/macos/latest
curl -I https://openstudio.org.in/download/ai-runtime/macos/arm64/latest
curl -I https://openstudio.org.in/download/ai-runtime/macos/x64/latest
curl -I https://openstudio.org.in/download/ai-runtime/linux/latest
curl -I https://openstudio.org.in/download/ai-runtime/linux/x64/latest
curl -I https://openstudio.org.in/download/ai-runtime/linux/arm64/latest

Check that:

metadata/appcast files are live
metadata/appcast files are uncached
app download redirects resolve through the published app release metadata to GitHub Release asset URLs
AI runtime redirects resolve through the published AI runtime metadata to GitHub Release asset URLs

Assets

Branding assets live in public/assets/openstudio/branding/
Screenshot assets live in public/assets/openstudio/screenshots/
Share image contract lives at public/assets/openstudio/branding/og-image.png?v=2

Name		Name	Last commit message	Last commit date
Latest commit History 35 Commits
.github/workflows		.github/workflows
blogs		blogs
netlify/functions		netlify/functions
public		public
release-input		release-input
scripts		scripts
shared		shared
src		src
test		test
tmp/dev-server		tmp/dev-server
.gitignore		.gitignore
README.md		README.md
components.json		components.json
eslint.config.js		eslint.config.js
index.html		index.html
netlify.toml		netlify.toml
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.app.json		tsconfig.app.json
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
vite.config.ts		vite.config.ts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

OpenStudio Website

Local

Build

Deploy Inputs

Environment Variables And Secrets

Redirect Behavior

Website Publish Workflow

Netlify

Manual Verification

Assets

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

OpenStudio Website

Local

Build

Deploy Inputs

Environment Variables And Secrets

Redirect Behavior

Website Publish Workflow

Netlify

Manual Verification

Assets

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages