pages: migrate to Astro build

Author: yuchanns

.github/actions/sample/action.yml

@@ -71,7 +71,8 @@ runs:
       shell: bash
       working-directory: ${{ inputs.soluna_path }}
       run: |
-        SAMPLE_WASM_PATH=$(find bin -name "sample.wasm" | head -n 1)
+        soluna_root=$(pwd -P)
+        SAMPLE_WASM_PATH=$(find "$soluna_root/bin" -name "sample.wasm" | head -n 1)
         if [ -z "$SAMPLE_WASM_PATH" ]; then
           echo "sample.wasm not found" >&2
           exit 1

.github/actions/soluna/action.yml

@@ -114,7 +114,14 @@ runs:
     - name: Set Output Build Path
       id: set-output
       run: |
-        bin_dir=${{inputs.soluna_path}}/bin
+        soluna_root=$(cd "${{ inputs.soluna_path }}" && pwd -P)
+        if [ "${{ runner.os }}" == "Windows" ]; then
+          soluna_root_output=$(cd "${{ inputs.soluna_path }}" && pwd -W | sed 's#\\#/#g')
+        else
+          soluna_root_output="$soluna_root"
+        fi
+        bin_dir="$soluna_root/bin"
+        bin_dir_output="$soluna_root_output/bin"
         if [ "${{ runner.os }}" == "Windows" ]; then
           SOLUNA_BINARY="soluna.exe"
           RENAME_BINARY="soluna-windows-amd64.exe"
@@ -125,17 +132,17 @@ runs:
           SOLUNA_BINARY="soluna"
           RENAME_BINARY="soluna-linux-amd64"
         fi
-        SOLUNA_PATH=$(find $bin_dir -name "$SOLUNA_BINARY" | head -n 1)
+        SOLUNA_PATH=$(find "$bin_dir" -name "$SOLUNA_BINARY" | head -n 1)
         cp "$SOLUNA_PATH" "$bin_dir/$RENAME_BINARY"
-        echo "SOLUNA_PATH=$bin_dir/$RENAME_BINARY" >> $GITHUB_OUTPUT
+        echo "SOLUNA_PATH=$bin_dir_output/$RENAME_BINARY" >> $GITHUB_OUTPUT
         echo "SOLUNA_BINARY=$RENAME_BINARY" >> $GITHUB_OUTPUT
         if [ "${{ runner.os }}" == "Linux" ]; then
-          SOLUNA_WASM_PATH=$(find $bin_dir -name "soluna.wasm" | head -n 1)
-          SOLUNA_JS_PATH=$(find $bin_dir -name "soluna.js" | head -n 1)
+          SOLUNA_WASM_PATH=$(find "$bin_dir" -name "soluna.wasm" | head -n 1)
+          SOLUNA_JS_PATH=$(find "$bin_dir" -name "soluna.js" | head -n 1)
           echo "SOLUNA_WASM_PATH=$SOLUNA_WASM_PATH" >> $GITHUB_OUTPUT
           echo "SOLUNA_JS_PATH=$SOLUNA_JS_PATH" >> $GITHUB_OUTPUT
           if [ "${{ inputs.debug }}" == "true" ]; then
-            SOLUNA_WASM_MAP_PATH=$(find $bin_dir -name "soluna.wasm.map" | head -n 1)
+            SOLUNA_WASM_MAP_PATH=$(find "$bin_dir" -name "soluna.wasm.map" | head -n 1)
             echo "SOLUNA_WASM_MAP_PATH=$SOLUNA_WASM_MAP_PATH" >> $GITHUB_OUTPUT
           fi
         fi

.github/workflows/nightly.yml

@@ -18,7 +18,7 @@ jobs:
     outputs:
       proceed: ${{ steps.check.outputs.proceed }}
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
       - name: Get the last nightly commit
@@ -71,7 +71,7 @@ jobs:
       matrix:
         os: [windows-latest, macos-latest, ubuntu-latest]
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           submodules: recursive
       - uses: ./.github/actions/soluna
@@ -105,7 +105,7 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
       - name: Download all artifacts
         uses: actions/download-artifact@v5
         with:

.github/workflows/pages.yml

@@ -24,59 +24,44 @@ jobs:
     runs-on: ubuntu-latest
     concurrency:
       group: ${{ github.workflow }}-${{ github.event.workflow_run.head_branch || github.ref }}
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
     steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
         with:
           submodules: recursive
           fetch-depth: 0
           ref: ${{ github.event.workflow_run.head_sha || github.sha }}
 
-      - name: Build Soluna (WASM)
+      - name: Build Soluna
         uses: ./.github/actions/soluna
         id: build
         with:
           soluna_path: "."
           debug: ${{ github.event.inputs.debug }}
 
-      - name: Build WASM side module (sample)
+      - name: Build Sample
         uses: ./.github/actions/sample
         id: sample
         with:
           soluna_path: "."
 
-      - name: Install web build tools
-        run: |
-          sudo apt-get update
-          sudo apt-get install -y lua5.4 zip
-
-      - name: Prepare web assets
-        run: |
-          lua5.4 script/build_web.lua \
-            --soluna . \
-            --site web \
-            --wasm "${{ steps.build.outputs.SOLUNA_WASM_PATH }}" \
-            --js "${{ steps.build.outputs.SOLUNA_JS_PATH }}"
-          if [ -f "${{ steps.build.outputs.SOLUNA_WASM_MAP_PATH }}" ]; then
-            cp "${{ steps.build.outputs.SOLUNA_WASM_MAP_PATH }}" web/static/runtime/soluna.wasm.map
-          fi
-
-      - name: Copy WASM side module into runtime
-        run: |
-          cp "${{ steps.sample.outputs.SAMPLE_WASM_PATH }}" web/static/runtime/sample.wasm
-
-      - name: Setup Hugo
-        uses: peaceiris/actions-hugo@v3
-        with:
-          hugo-version: "0.154.5"
-
-      - name: Build
-        run: hugo --source web --minify
-
-      - name: Upload static files as artifact
-        id: deployment
-        uses: actions/upload-pages-artifact@v3
+      - name: Build Astro
+        uses: withastro/action@v6
+        env:
+          SITE_BASE: /soluna/
+          SOLUNA_JS_PATH: ${{ steps.build.outputs.SOLUNA_JS_PATH }}
+          SOLUNA_WASM_PATH: ${{ steps.build.outputs.SOLUNA_WASM_PATH }}
+          SOLUNA_WASM_MAP_PATH: ${{ steps.build.outputs.SOLUNA_WASM_MAP_PATH }}
+          SAMPLE_WASM_PATH: ${{ steps.sample.outputs.SAMPLE_WASM_PATH }}
         with:
-          path: web/public
+          path: website
+          node-version: 24
+          package-manager: pnpm@10.28.2
+          build-cmd: pnpm run build
+          out-dir: dist
 
   deploy:
     name: Deploy to GitHub Pages

.gitignore

@@ -1,8 +1,10 @@
 bin
 build
-web/public
-web/data
-web/static/runtime
-web/static/data
-web/content/examples/*.md
-!web/content/examples/_index.md
+node_modules
+.pnpm-store
+pnpm-debug.log*
+website/node_modules
+website/packages/*/node_modules
+website/dist
+website/.astro
+website/public/runtime/

README.md

@@ -14,13 +14,14 @@ A framework you can use to make 2D games in Lua with multithreading, living on W
 
 It is built on top of [sokol](https://github.com/floooh/sokol) and leverages the power of ltask for multithreading.
 
-[![Nightly](/../../actions/workflows/nightly.yml/badge.svg)](/../../actions/workflows/nightyly.yml)
+[![Nightly](/../../actions/workflows/nightly.yml/badge.svg)](/../../actions/workflows/nightly.yml)
 
 ## Documentation
 
 - [API Reference](./docs)
 - [Examples](./test)
 - [Wiki](https://github.com/cloudwu/soluna/wiki)
+- [Website](./website/README.md)
 
 ## Precompiled Binaries
 
@@ -33,7 +34,7 @@ You can build Soluna from source by `make` for Windows and by `luamake` for all
 ### Integration with the Actions of your projects
 
 ```yaml
-- uses: actions/checkout@v5
+- uses: actions/checkout@v6
   with:
     repository: cloudwu/soluna
     ref: <a fixed commit hash to avoid breaking changes>

README.zh-CN.md

@@ -14,13 +14,14 @@ Sokol + Lua = Soluna
 
 Soluna 可以运行在 Windows、Linux、macOS 和现代浏览器（通过 WebAssembly）上。
 
-[![Nightly](/../../actions/workflows/nightly.yml/badge.svg)](/../../actions/workflows/nightyly.yml)
+[![Nightly](/../../actions/workflows/nightly.yml/badge.svg)](/../../actions/workflows/nightly.yml)
 
 ## 文档
 
 - [API 参考](./docs)
 - [示例](./test)
 - [Wiki](https://github.com/cloudwu/soluna/wiki)
+- [演示网站说明](./website/README.zh-CN.md)
 
 ## 预编译二进制文件
 
@@ -35,7 +36,7 @@ WebAssembly 的预编译二进制文件。
 ### 在你的项目的 Actions 中集成
 
 ```yaml
-- uses: actions/checkout@v5
+- uses: actions/checkout@v6
   with:
     repository: cloudwu/soluna
     ref: <a fixed commit hash to avoid breaking changes>