HELIOS-3D
Project Ops Updated 2026-06-07

Deployment

HELIOS-3D is automatically deployed via GitHub Actions.

PROPOSED

The site is built with Astro + MDX and automatically deployed on every push to main. Build and deployment are governed by GitHub Actions; no manual deploy step is required.

Vercel (primary)

Live

Auto-deploy on every push to main. Vercel reads the Astro build output and serves the static site.

https://helios-3d.vercel.app/

GitHub Pages (mirror)

Live

Mirrored deployment via the GitHub Actions workflow at .github/workflows/deploy.yml.

https://myrqyry.github.io/HELIOS-3D/

Source

Public

All Astro + MDX source, visual summaries, r3f scenes, and Python analysis tooling. Issues and PRs welcome.

https://github.com/myrqyry/HELIOS-3D

CI/CD workflow

  1. 1.Validation: pnpm check && pnpm test ensures code and documentation integrity.
  2. 2.Build: pnpm build produces the static dist/ directory.
  3. 3.Deploy: Vercel auto-detects the push and serves the build. GitHub Pages mirrors via actions/deploy-pages.

Local preview

pnpm install
pnpm dev          # http://localhost:4321
pnpm build
pnpm preview      # serve the production build

Deployed Site

The technical documentation is live at myrqyry.github.io/HELIOS-3D/.

The site is built with Astro + MDX and automatically deployed via GitHub Actions and Vercel on every push to the main branch.

CI/CD Workflow

The deployment is managed by the workflow file at .github/workflows/deploy.yml.

  1. Validation: Runs pnpm check and pnpm test to ensure code and documentation integrity.
  2. Build: Executes pnpm build to generate the static site in the dist/ directory.
  3. Publish: Publishes the build artifacts directly to GitHub Pages.

Local Development & Preview

To preview the site locally before pushing to GitHub:

  1. Install dependencies: 
    pnpm install
  2. Run development server: 
    pnpm dev
  3. Build & Preview: 
    pnpm build
pnpm preview