Test

.devcontainer/Dockerfile

@@ -0,0 +1,16 @@
+FROM mcr.microsoft.com/devcontainers/base:ubuntu
+
+# Node v22 setup - refer to below URL for details
+# https://github.com/nodesource/distributions?tab=readme-ov-file#using-ubuntu-nodejs-20
+RUN apt-get install -y curl \
+    && curl -fsSL https://deb.nodesource.com/setup_22.x -o nodesource_setup.sh \
+    && bash nodesource_setup.sh \
+    && apt-get install -y nodejs python3-setuptools \
+    && node -v  # verify Node installation
+
+# Ghost setup
+RUN npm install ghost-cli@latest -g
+USER vscode
+RUN mkdir ~/ghost \
+    && cd ~/ghost \
+    && ghost install local

.devcontainer/devcontainer.json

@@ -0,0 +1,28 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/ubuntu
+{
+    "name": "Ubuntu 24.04 w/ Ghost",
+    // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+    "build": { "dockerfile": "Dockerfile" },
+
+    // Features to add to the dev container. More info: https://containers.dev/features.
+    // "features": {},
+
+    // Use 'forwardPorts' to make a list of ports inside the container available locally.
+    "forwardPorts": [2368],
+
+    "containerEnv": {
+        "REPO": "/workspaces/dawn-advisory-theme"
+    },
+
+    // Use 'postCreateCommand' to run commands after the container is created.
+    "postCreateCommand": "$REPO/.devcontainer/ghost_setup.sh",
+    "postStartCommand": "npm run prepare && cd ~/ghost && ghost start",
+    "postAttachCommand": "npm run dev"
+
+    // Configure tool-specific properties.
+    // "customizations": {},
+
+    // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+    // "remoteUser": "root"
+}

.devcontainer/ghost_setup.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+export REPO="/workspaces/dawn-advisory-theme"
+
+# Step 1: Create symbolic link to theme
+ln -s $REPO ~/ghost/content/themes
+
+# Step 2: Start Ghost
+cd ~/ghost
+ghost start
+
+# Step 3: Install dependencies + run setup script
+cd $REPO/.devcontainer/ghost_setup
+npm install && npm start

.devcontainer/ghost_setup/index.js

@@ -0,0 +1,52 @@
+const readline = require("readline");
+const GhostAdminAPI = require("@tryghost/admin-api");
+
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    prompt: "> ",
+});
+
+console.log("---");
+console.log("Please do the following steps:");
+console.log("Step 1: Complete the setup at http://localhost:2368/ghost/.");
+console.log(
+    "The actual details don't matter, but make sure to save your username and password.",
+);
+console.log(
+    "Step 2: Follow https://ghost.org/docs/admin-api/#token-authentication to create an integration.",
+);
+console.log("Step 3: Copy the Admin API key into the following prompt.");
+console.log("---");
+
+(async () => {
+    const apiKey = await new Promise((callback) => {
+        rl.question("Admin API Key: ", callback);
+    });
+
+    const api = new GhostAdminAPI({
+        url: "http://localhost:2368",
+        version: "v5.0",
+        key: apiKey,
+    });
+
+    console.log("Activating repository theme...");
+    await api.themes.activate("dawn-advisory-theme").then((res) => {
+        console.log(JSON.stringify(res));
+    });
+    console.log("Finished setup!");
+
+    console.log("---");
+    console.log("The remaining steps need to be done manually:");
+    console.log(
+        "1. Under Settings > Advanced > Import/Export, import an export of the main Ghost website.",
+    );
+    console.log("2. Under Settings > Labs, import redirects and routes.");
+    console.log("For more details, please reach out to the maintainers! :)");
+    console.log("---");
+
+    await new Promise((callback) => {
+        rl.question("Press enter to continue...", callback);
+    });
+    rl.close();
+})();

.devcontainer/ghost_setup/package.json

@@ -0,0 +1,14 @@
+{
+    "name": "ghost_setup",
+    "version": "1.0.0",
+    "main": "index.js",
+    "scripts": {
+        "start": "node index.js"
+    },
+    "author": "",
+    "license": "MIT",
+    "description": "",
+    "dependencies": {
+        "@tryghost/admin-api": "^1.14.0"
+    }
+}

.djlintrc

@@ -0,0 +1,5 @@
+{
+    "profile": "handlebars",
+    "extension": "hbs",
+    "ignore": "H006,H013,H017,H021,H030,H031"
+}

.github/dependabot.yml

@@ -1,9 +1,27 @@
 version: 2
 updates:
-  - package-ecosystem: npm
+  - package-ecosystem: "npm"
     directory: "/"
     schedule:
-      interval: weekly
-    reviewers:
-      - "AdvisorySG/ghost-reviewers"
-    open-pull-requests-limit: 4
+      interval: "weekly"
+    groups:
+      production-dependencies:
+        dependency-type: "production"
+      development-dependencies:
+        dependency-type: "development"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      all-dependencies:
+        patterns: ["*"]
+
+  - package-ecosystem: "devcontainers"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      all-dependencies:
+        patterns: ["*"]

.github/workflows/deploy.yml

@@ -3,23 +3,37 @@ on:
   pull_request:
   push:
 jobs:
+  pre_build:
+    continue-on-error: true
+    runs-on: ubuntu-24.04
+    outputs:
+      should_skip: ${{ steps.skip_check.outputs.should_skip }}
+    steps:
+      - id: skip_check
+        uses: fkirc/skip-duplicate-actions@v4
+        with:
+          concurrent_skipping: "same_content_newer"
+          paths_ignore: '["CONTRIBUTING.md", "LICENSE", "**/README.md"]'
+
   build:
+    needs: pre_build
+    if: ${{ (github.event_name == 'push' && github.ref == 'refs/heads/main') || needs.pre_build.outputs.should_skip != 'true' }}
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [22.x]
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Cache Node modules
-        uses: actions/cache@v1
+        uses: actions/cache@v4
         with:
           path: ~/.npm
           key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
           restore-keys: |
             ${{ runner.os }}-node-
       - name: Setup Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
 
@@ -30,7 +44,7 @@ jobs:
       - run: unzip dist/dawn-advisory-theme.zip -d dist/
       - run: rm dist/dawn-advisory-theme.zip
       - name: Upload build
-        uses: actions/upload-artifact@v1
+        uses: actions/upload-artifact@v4
         with:
           name: dawn-advisory-theme-${{ github.sha }}
           path: dist/
@@ -41,27 +55,27 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [22.x]
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Cache Node modules
-        uses: actions/cache@v1
+        uses: actions/cache@v4
         with:
           path: ~/.npm
           key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
           restore-keys: |
             ${{ runner.os }}-node-
       - name: Setup Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
 
       - run: npm install
       - run: npm run zip
 
       - name: Deploy Ghost theme
-        uses: TryGhost/action-deploy-theme@v1.4.1
+        uses: TryGhost/action-deploy-theme@v1.6.6
         with:
           api-url: ${{ secrets.GHOST_API_URL }}
           api-key: ${{ secrets.GHOST_DEPLOY_THEME_ADMIN_API_KEY }}

.github/workflows/lint.yml

@@ -4,10 +4,10 @@ on:
   push:
 jobs:
   lint:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [22.x]
     steps:
       - uses: actions/checkout@v2
 
@@ -22,7 +22,14 @@ jobs:
         uses: actions/setup-node@v1
         with:
           node-version: ${{ matrix.node-version }}
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: 3.11
 
       - run: npm install
+      - run: pip install djlint
+
       - run: npx eslint .
       - run: npx prettier -c .
+      - run: djlint . --lint

.gitignore

@@ -27,3 +27,6 @@ dist/
 config.json
 changelog.md
 changelog.md.bk
+
+replit.nix
+.replit

README.md

@@ -22,29 +22,12 @@ npm run zip
 
 4. Upload the zipfile at `dist/dawn-advisory-theme.zip` onto your local Ghost instance at `Settings > Theme > Change theme > Upload theme`.
 
-Optionally, if you have access to the [Admin panel of Advisory](https://beta.advisory.sg/ghost/), you can go to `Settings > Labs > Migration Options > Export your content` in order to export the posts and settings used for the actual website as a JSON file. This file can be imported into your local instance of Ghost, at `Settings > Labs > Migration Options > Import content`. Take note that this will not remove existing posts/pages.
+For new developers, please ask Tech Management for the posts and settings to be exported, and to pass you the output JSON file.
+This file can be imported into your local instance of Ghost, at `Settings > Labs > Migration Options > Import content`. Take note that this will not remove existing posts/pages.
 
-# Search
+Optionally, if you have access to the [Admin panel of Advisory](https://beta.advisory.sg/ghost/), you can go to `Settings > Labs > Migration Options > Export your content` in order to export the posts and settings used for the actual website as a JSON file.
 
-1. Navigate to the `Integrations` and click on `Add custom integration`.
-2. Copy the content API key; this will be used to fetch posts from your site.
-3. Insert the generated key in `Settings > Design > Site-wide > Content API key for search".
-
-The theme generates an index of posts for highly performant search. The index is updated automatically when posts are added or updated. However, it isn't updated when posts are unpublished or deleted.
-
-To force update the index, increment the search index migration version like `'v2'`.
-
-## Disable Content Search
-
-When your site has lots of posts, including the post content in the index cache ends up with exceeding the browser local storage quota. In that case, disabling content search is recommended. Also make sure increase the migration version to force update the old index.
-
-```html
-<script>
-    var gh_search_key = "API_KEY";
-    var gh_search_migration = "v2"; // Increased from v1
-    var gh_search_content = false; // Disables content search
-</script>
-```
+Furthermore, also make sure to setup `routes.yaml` as explained further down below
 
 # Dropdown Menu
 
@@ -88,6 +71,24 @@ For the homepage and separate [Stories](https://beta.advisory.sg/stories) page t
 
 **Note**: The `routes.yaml` file supplied in the repository is not automatically deployed onto the main website.
 
+# Typesense Search
+
+The `/events/` and `/interviews/` pages have a typo-tolerant search box backed by [Typesense](https://typesense.org/), and the bottom-of-article "you might also like" widget uses Typesense for content-relevance ranking. Three settings live under `config.custom` in `package.json` and are admin-overridable in **Ghost Admin -> Settings -> Design -> Customize**:
+
+| Setting                | Default                         | What it is                                                         |
+| ---------------------- | ------------------------------- | ------------------------------------------------------------------ |
+| `typesense_host`       | `https://typesense.advisory.sg` | Typesense host URL (no trailing slash). HTTPS recommended.         |
+| `typesense_api_key`    | (Advisory SG search-only key)   | Typesense **search-only** API key. Embedded client-side by design. |
+| `typesense_collection` | `ghost`                         | Name of the indexed Ghost-posts collection on the Typesense host.  |
+
+The flow is: `package.json` defaults → `default.hbs` injects them as `window.__TYPESENSE_CONFIG__` → `assets/js/typesense-search.js` reads from that global at search time, falling back to the same defaults if the global is missing.
+
+**About the API key in source.** Typesense splits keys into _admin_ (read/write, secret) and _search-only_ (read-only, scoped to a collection). The search-only key is the analogue of Ghost's Content API key — it's designed to ship in client-side JavaScript and only grants read access to data that's already public. Don't paste an admin key here.
+
+**Deploying to a different Ghost instance.** If your instance points at a different Typesense backend, override the three settings in **Design → Customize** rather than editing the theme. The defaults in `package.json` are only the fallback for installs that don't override.
+
+**About the indexer.** This theme expects an existing Typesense collection populated with Ghost posts (`title`, `slug`, `excerpt`, `plaintext`, `feature_image`, `url`, `tags.name`, `tags.slug`, `published_at`, etc.). The sync mechanism (e.g. [MagicPages' Ghost-Typesense integration](https://github.com/magicpages/ghost-typesense)) is **not** part of this theme.
+
 # PostCSS Features Used
 
 -   Autoprefixer - Don't worry about writing browser prefixes of any kind, it's all done automatically with support for the latest 2 major versions of every browser.