BlueGit

timfa questward

Build FrameworkV3 on every production service start.

Submodule init and npm run build:client run after pull so framework.js exists before Node starts.

timfa Tim Falken · pushed by timfa

Authored 2026-08-28 · 2 months ago

Hash
e276dca484bbc2aa88086daba42fc4c056702823
Parent
c3c8b6bc
2 files changed +24 −1
deploy/README.md +13 −1
@@ -7,7 +7,9 @@ On **every** service start (clean midnight restart, crash, or power loss recover
7 7 1. `git fetch` + `git reset --hard origin/<branch>`
8 8 2. `git pull --ff-only`
9 9 3. `npm install --omit=dev`
10 4. start `node --experimental-sqlite server/src/index.js`
10 4. `git submodule update --init --recursive`
11 5. `npm run build:client` (concatenates FrameworkV3 → `client/frameworkv3/js/framework.js`)
12 6. start `node --experimental-sqlite server/src/index.js`
11 13
12 14 Pull-on-crash is intentional so a fixed commit on origin can recover a bad build.
13 15
@@ -31,6 +33,16 @@ Optional env overrides:
31 33 | `QUESTWARD_GIT_BRANCH` | `master` |
32 34 | `QUESTWARD_AUTH_CLIENT_SECRET` | (unset — stub auth) |
33 35
36 Production secrets: **`/etc/questward/env`** (loaded by the unit). Example:
37
38 ```bash
39 sudo mkdir -p /etc/questward
40 sudo nano /etc/questward/env
41 # QUESTWARD_AUTH_CLIENT_SECRET=...
42 # QUESTWARD_AUTH_REDIRECT_URI=http://questward.timfalken.com:1234/auth/callback
43 sudo chmod 600 /etc/questward/env
44 ```
45
34 46 See root `README.md` for OAuth / auth.timfalken.com setup.
35 47
36 48 `TILE_MMO_*` env vars are still accepted as fallbacks for older installs.
@@ -7,7 +7,9 @@ On **every** service start (clean midnight restart, crash, or power loss recover
71. `git fetch` + `git reset --hard origin/<branch>`
71. `git fetch` + `git reset --hard origin/<branch>`
82. `git pull --ff-only`
82. `git pull --ff-only`
93. `npm install --omit=dev`
93. `npm install --omit=dev`
104. start `node --experimental-sqlite server/src/index.js`
104. `git submodule update --init --recursive`
115. `npm run build:client` (concatenates FrameworkV3 → `client/frameworkv3/js/framework.js`)
126. start `node --experimental-sqlite server/src/index.js`
11
13
12Pull-on-crash is intentional so a fixed commit on origin can recover a bad build.
14Pull-on-crash is intentional so a fixed commit on origin can recover a bad build.
13
15
@@ -31,6 +33,16 @@ Optional env overrides:
31| `QUESTWARD_GIT_BRANCH` | `master` |
33| `QUESTWARD_GIT_BRANCH` | `master` |
32| `QUESTWARD_AUTH_CLIENT_SECRET` | (unset — stub auth) |
34| `QUESTWARD_AUTH_CLIENT_SECRET` | (unset — stub auth) |
33
35
36Production secrets: **`/etc/questward/env`** (loaded by the unit). Example:
37
38```bash
39sudo mkdir -p /etc/questward
40sudo nano /etc/questward/env
41# QUESTWARD_AUTH_CLIENT_SECRET=...
42# QUESTWARD_AUTH_REDIRECT_URI=http://questward.timfalken.com:1234/auth/callback
43sudo chmod 600 /etc/questward/env
44```
45
34See root `README.md` for OAuth / auth.timfalken.com setup.
46See root `README.md` for OAuth / auth.timfalken.com setup.
35
47
36`TILE_MMO_*` env vars are still accepted as fallbacks for older installs.
48`TILE_MMO_*` env vars are still accepted as fallbacks for older installs.
deploy/start-server.sh +11 −0
@@ -17,5 +17,16 @@ git pull --ff-only origin "$BRANCH" || true
17 17 echo "[deploy] npm install…"
18 18 npm install --omit=dev
19 19
20 echo "[deploy] Submodules…"
21 git submodule update --init --recursive
22
23 echo "[deploy] Build client framework…"
24 npm run build:client
25
26 if [[ ! -f client/frameworkv3/js/framework.js ]]; then
27 echo "[deploy] ERROR: client/frameworkv3/js/framework.js missing after build." >&2
28 exit 1
29 fi
30
20 31 echo "[deploy] Starting server…"
21 32 exec node --experimental-sqlite server/src/index.js
@@ -17,5 +17,16 @@ git pull --ff-only origin "$BRANCH" || true
17echo "[deploy] npm install…"
17echo "[deploy] npm install…"
18npm install --omit=dev
18npm install --omit=dev
19
19
20echo "[deploy] Submodules…"
21git submodule update --init --recursive
22
23echo "[deploy] Build client framework…"
24npm run build:client
25
26if [[ ! -f client/frameworkv3/js/framework.js ]]; then
27 echo "[deploy] ERROR: client/frameworkv3/js/framework.js missing after build." >&2
28 exit 1
29fi
30
20echo "[deploy] Starting server…"
31echo "[deploy] Starting server…"
21exec node --experimental-sqlite server/src/index.js
32exec node --experimental-sqlite server/src/index.js