nue-lang.com

Official website implementation for Nue.

Directory Layout

• site/: Astro + MDX website project (deploy this directory only).

Local Development

cd site
npm install
npm run dev

Build

cd site
npm run build

For project pages (https://<user>.github.io/<repo>/), set PUBLIC_SITE_BASE:

cd site
PUBLIC_SITE_BASE=/nue-lang.com/ npm run build

Theme can be selected at build time via PUBLIC_THEME:

cd site
PUBLIC_THEME=tuna npm run build
PUBLIC_THEME=fjord npm run build
PUBLIC_THEME=newsprint npm run build
PUBLIC_THEME=signal npm run build

If PUBLIC_THEME is omitted, signal is used.

GitHub Pages Deploy

The workflow .github/workflows/deploy.yml deploys site/dist to GitHub Pages on push to main.

Setup once in repository settings:

• Settings > Pages > Source to GitHub Actions

PUBLIC_SITE_BASE is wired automatically by actions/configure-pages in CI. For custom domain deployment, site/public/CNAME is published as-is.

Home Playground Embed

Home embeds the WASM playground as an Astro React island. The required runtime files are committed in this repository, so deployment does not depend on $HOME/Developer/Workspace/nue/web.

• Runtime module default: /pkg/nue_wasm.js (bundled in site/public/pkg)
• Override at build/dev time with PUBLIC_PLAYGROUND_WASM_MODULE_URL

cd site
PUBLIC_PLAYGROUND_WASM_MODULE_URL=http://localhost:4173/pkg/nue_wasm.js npm run dev
PUBLIC_PLAYGROUND_WASM_MODULE_URL=https://playground.example.com/pkg/nue_wasm.js npm run build