feat: update Aurora build process and configuration for Cloudflare Pages

Author: leandromqrs

README.md

@@ -51,13 +51,32 @@ by editing the `available` check when its first release lands.
 `aurora.luminusos.org` is a second build of this same project:
 
 ```sh
-npm run build:aurora   # static output in dist-aurora/
-npm run deploy:aurora  # deploy dist-aurora to Cloudflare Pages
+npm run build:aurora   # static output in aurora/dist/
+npm run deploy:aurora  # local/manual upload with Wrangler
 ```
 
 With `SITE_VARIANT=aurora` the Aurora Shell page becomes the site root
 (`/` and `/pt-br/`), cross-links point back to `https://luminusos.org`, and
-`dist-aurora/CNAME` is written as `aurora.luminusos.org`.
+`aurora/dist/CNAME` is written as `aurora.luminusos.org`.
+
+Cloudflare Pages settings for `aurora.luminusos.org`:
+
+| Setting | Value |
+| --- | --- |
+| Root directory | `website` |
+| Build command | `npm run build:aurora` |
+| Build output directory | `aurora/dist` |
+| Deploy command | leave empty |
+
+The `deploy:aurora` script is only for a local/manual Wrangler upload. Do not
+use it as the Cloudflare Pages deploy command; Git-connected Pages deployments
+upload the configured output directory automatically after the build command.
+
+This repository intentionally does not keep a default `wrangler.jsonc` in the
+Pages root. The same source tree is used by multiple Cloudflare Pages projects
+with different output directories, so each Pages project should use its own UI
+settings. The Worker config used by the manual `npm run deploy` command lives
+in `wrangler.worker.jsonc`.
 
 ## Wiki & Blog (sub-projects)
 
@@ -80,6 +99,9 @@ npm run build:wiki
 npm run deploy:wiki
 ```
 
+For Git-connected Cloudflare Pages projects, use only the build command and
+output directory. Leave the deploy command empty there as well.
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

astro.config.mjs

@@ -11,13 +11,17 @@ const sites = {
   '': 'https://luminusos.org',
   aurora: 'https://aurora.luminusos.org',
 };
+const outDirs = {
+  '': './dist',
+  aurora: './aurora/dist',
+};
 if (!(variant in sites)) {
   throw new Error(`Unknown SITE_VARIANT "${variant}" (expected aurora)`);
 }
 
 export default defineConfig({
   site: sites[/** @type {keyof typeof sites} */ (variant)],
-  outDir: variant ? `./dist-${variant}` : './dist',
+  outDir: outDirs[/** @type {keyof typeof outDirs} */ (variant)],
   trailingSlash: 'ignore',
 
   i18n: {
@@ -29,4 +33,4 @@ export default defineConfig({
   },
 
   adapter: cloudflare()
-});
+});

aurora/.gitignore

@@ -0,0 +1,2 @@
+dist/
+.astro/

package.json

@@ -8,18 +8,18 @@
     "dev:site": "astro dev",
     "build": "npm run build:site && npm run build:blog:site && npm run build:wiki:site && node scripts/add-embedded-routes.mjs",
     "build:site": "astro build",
-    "build:aurora": "SITE_VARIANT=aurora astro build && node scripts/clean-aurora-build.mjs && echo aurora.luminusos.org > dist-aurora/CNAME",
+    "build:aurora": "SITE_VARIANT=aurora astro build && node scripts/clean-aurora-build.mjs && echo aurora.luminusos.org > aurora/dist/CNAME",
     "build:blog": "astro build --root blog",
     "build:blog:site": "SITE_BASE=/blog SITE_URL=https://luminusos.org astro build --root blog && rm -rf dist/blog && mkdir -p dist/blog && cp -R blog/dist/. dist/blog/",
     "build:wiki": "astro build --root wiki",
     "build:wiki:site": "SITE_BASE=/wiki SITE_URL=https://luminusos.org astro build --root wiki && rm -rf dist/wiki && mkdir -p dist/wiki && cp -R wiki/dist/. dist/wiki/",
-    "preview": "npm run build && wrangler dev",
+    "preview": "npm run build && wrangler dev --config wrangler.worker.jsonc",
     "astro": "astro",
-    "deploy": "npm run build && wrangler deploy",
-    "deploy:aurora": "npm run build:aurora && wrangler pages deploy dist-aurora --project-name luminusos-aurora",
+    "deploy": "npm run build && wrangler deploy --config wrangler.worker.jsonc",
+    "deploy:aurora": "npm run build:aurora && wrangler pages deploy aurora/dist --project-name luminusos-aurora",
     "deploy:blog": "npm run build:blog && wrangler pages deploy blog/dist --project-name luminusos-blog",
     "deploy:wiki": "npm run build:wiki && wrangler pages deploy wiki/dist --project-name luminusos-wiki",
-    "cf-typegen": "wrangler types"
+    "cf-typegen": "wrangler types --config wrangler.worker.jsonc"
   },
   "dependencies": {
     "@astrojs/cloudflare": "^12.6.13",

scripts/clean-aurora-build.mjs

@@ -1,6 +1,6 @@
 import { rmSync } from 'node:fs';
 
-const dist = new URL('../dist-aurora/', import.meta.url);
+const dist = new URL('../aurora/dist/', import.meta.url);
 
 for (const path of ['aetheris', 'aurora', 'pt-br/aetheris', 'pt-br/aurora']) {
   rmSync(new URL(path, dist), { recursive: true, force: true });

wrangler.jsonc wrangler.worker.jsoncwrangler.jsonc renamed to wrangler.worker.jsonc

@@ -1,6 +1,6 @@
 {
   "$schema": "node_modules/wrangler/config-schema.json",
-  "name": "luminusos",
+  "name": "website",
   "compatibility_date": "2026-07-05",
   "observability": {
     "enabled": true