Migrated website from python to nodejs and merged HAR docs

.github/workflows/code-static-analysis.yml

@@ -9,7 +9,6 @@ on:
     branches: [main]
     paths:
       - '**.js'
-      - '**.py'
   schedule:
     #        ┌───────────── minute (0 - 59)
     #        │ ┌───────────── hour (0 - 23)
@@ -29,22 +28,10 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        language: ['javascript', 'python']
+        language: ['javascript']
     steps:
       - name: Checkout repository
         uses: actions/checkout@v6
-      - name: Set up Python 3.12
-        if: ${{ matrix.language == 'python' }}
-        uses: actions/setup-python@v6
-        with:
-          python-version: '3.12'
-      - name: Install dependencies
-        if: ${{ matrix.language == 'python' }}
-        run: |
-          pip install -r requirements.txt;
-          # Set the `CODEQL-PYTHON` environment variable to the Python executable
-          # that includes the dependencies
-          echo "CODEQL_PYTHON=$(which python)" >> $GITHUB_ENV
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v4
         with:

.github/workflows/deploy.yml

@@ -37,15 +37,9 @@ jobs:
     - name: Install Python dependencies
       run: pip install -r requirements.txt
 
-    - name: Build static assets
+    - name: Build website
       run: npm run build
 
-    - name: Update timestamps
-      run: npm run timestamps
-
-    - name: Generate scripts
-      run: npm run generate
-
     - name: Authenticate to Google Cloud
       uses: google-github-actions/auth@v3
       with:

.github/workflows/predeploy.yml

@@ -25,14 +25,8 @@ jobs:
       uses: actions/setup-node@v6
       with:
         node-version: '24'
-    - name: Set up Python 3.14
-      uses: actions/setup-python@v6
-      with:
-        python-version: '3.14'
     - name: Run the website
       run: ./tools/scripts/run_and_test_website.sh
-    - name: Update timestamps
-      run: npm run timestamps
     - name: Create Pull Request
       id: cpr
       uses: peter-evans/create-pull-request@v8

.github/workflows/test-website.yml

@@ -24,10 +24,6 @@ jobs:
       uses: actions/setup-node@v6
       with:
         node-version:  '24'
-    - name: Set up Python 3.14
-      uses: actions/setup-python@v6
-      with:
-        python-version: '3.14'
     - name: Run the website
       run: ./tools/scripts/run_and_test_website.sh
     - name: Remove node modules to avoid linting errors

.gitignore

@@ -11,3 +11,7 @@ templates/sitemap.xml
 .coverage
 .idx/dev.nix
 .coverage.*
+.pytest_cache
+__pycache__
+.astro/
+/dist

app.yaml

@@ -1,48 +1,84 @@
-runtime: python312
-entrypoint: gunicorn -b :$PORT main:app
+runtime: nodejs24
+entrypoint: node server.js
 default_expiration: 3h
 
 handlers:
 
-# Add longer caching for fonts
-- url: /static/fonts/(.*\.(woff|woff2))$
-  static_files: static/fonts/\1
-  upload: static/fonts/.*\.(woff|woff2)$
-  secure: always
-  expiration: 365d
-  http_headers:
-    strict-transport-security: max-age=31556926; includeSubDomains
-    x-content-type-options: nosniff
-    vary: Accept-Encoding
-
-# Set the UTF-8 charset for CSS and JS files.
-# Makes the assumption that only CSS and JS files existing in the relevant dirs
-# but avoids complex regexes
-- url: /static/css
-  static_dir: static/css
-  secure: always
-  http_headers:
-    content-type: text/css; charset=utf-8
-    strict-transport-security: max-age=31556926; includeSubDomains
-    x-content-type-options: nosniff
-    vary: Accept-Encoding
-- url: /static/js
-  static_dir: static/js
-  secure: always
-  http_headers:
-    content-type: application/javascript; charset=utf-8
-    strict-transport-security: max-age=31556926; includeSubDomains
-    x-content-type-options: nosniff
-    vary: Accept-Encoding
-
-- url: /static
-  static_dir: static
-  secure: always
-  http_headers:
-    strict-transport-security: max-age=31556926; includeSubDomains
-    x-content-type-options: nosniff
-    vary: Accept-Encoding
-
-- url: /.*
-  script: auto
-  secure: always
+  # Python API endpoints — must be routed to gunicorn before static handlers
+  - url: /metric.json
+    script: auto
+    secure: always
+
+  - url: /api/.*
+    script: auto
+    secure: always
+
+  - url: /.well-known/(.*)
+    static_files: static/well-known/\1
+    upload: static/well-known/.*
+    secure: always
+
+  # Add longer caching for fonts
+  - url: /static/fonts/(.*\.(woff|woff2))$
+    static_files: static/fonts/\1
+    upload: static/fonts/.*\.(woff|woff2)$
+    secure: always
+    expiration: 365d
+    http_headers:
+      strict-transport-security: max-age=31556926; includeSubDomains
+      x-content-type-options: nosniff
+      vary: Accept-Encoding
+
+  # Set the UTF-8 charset for CSS and JS files.
+  - url: /static/css
+    static_dir: static/css
+    secure: always
+    http_headers:
+      content-type: text/css; charset=utf-8
+      strict-transport-security: max-age=31556926; includeSubDomains
+      x-content-type-options: nosniff
+      vary: Accept-Encoding
+  - url: /static/js
+    static_dir: static/js
+    secure: always
+    http_headers:
+      content-type: application/javascript; charset=utf-8
+      strict-transport-security: max-age=31556926; includeSubDomains
+      x-content-type-options: nosniff
+      vary: Accept-Encoding
+
+  - url: /static
+    static_dir: static
+    secure: always
+    http_headers:
+      strict-transport-security: max-age=31556926; includeSubDomains
+      x-content-type-options: nosniff
+      vary: Accept-Encoding
+
+  # Serve Astro-built HTML pages as static files from dist/
+  # Index page
+  - url: /$
+    static_files: dist/index.html
+    upload: dist/index.html
+    secure: always
+    expiration: 1h
+    http_headers:
+      strict-transport-security: max-age=31556926; includeSubDomains
+      x-content-type-options: nosniff
+      content-security-policy: "default-src 'self' https:; script-src 'self' https: 'unsafe-inline'; style-src 'self' https: 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' https: data:; connect-src 'self' https:; frame-ancestors 'none'"
+
+  # Astro pages — serve /path as dist/path/index.html
+  - url: /(.+)
+    static_files: dist/\1/index.html
+    upload: dist/.*/index\.html
+    secure: always
+    expiration: 1h
+    http_headers:
+      strict-transport-security: max-age=31556926; includeSubDomains
+      x-content-type-options: nosniff
+      content-security-policy: "default-src 'self' https:; script-src 'self' https: 'unsafe-inline'; style-src 'self' https: 'unsafe-inline'; img-src 'self' https: data:; font-src 'self' https: data:; connect-src 'self' https:; frame-ancestors 'none'"
+
+  # Fallback: all remaining routes to Python (legacy redirects, 404s, robots.txt, .well-known)
+  - url: /.*
+    script: auto
+    secure: always

astro.config.mjs

@@ -0,0 +1,66 @@
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+import starlightLinksValidator from 'starlight-links-validator';
+import starlightLlmsTxt from 'starlight-llms-txt';
+
+export default defineConfig({
+  output: 'static',
+  outDir: 'dist',
+  // Static assets pass-through from /static directory
+  publicDir: 'static',
+  // Base URL
+  site: 'https://httparchive.org',
+  build: {
+    // Don't add trailing slashes to output filenames
+    format: 'directory',
+  },
+  integrations: [
+    starlight({
+      title: 'HTTP Archive Docs',
+      components: {
+        Header: './src/components/docs/Header.astro',
+      },
+      sidebar: [
+        {
+          label: 'Guides',
+          items: [
+            { label: 'Getting started', link: 'docs/guides/getting-started' },
+            { label: 'Minimizing query costs', link: 'docs/guides/minimizing-costs' },
+            { label: 'Guided tour', link: 'docs/guides/guided-tour' },
+            { label: 'Release cycle', link: 'docs/guides/release-cycle' },
+          ],
+        },
+        {
+          label: 'Tables',
+          items: [{ autogenerate: { directory: 'docs/reference/tables' } }]
+        },
+        {
+          label: 'Structs',
+          items: [{ autogenerate: { directory: 'docs/reference/structs' } }]
+        },
+        {
+          label: 'Blobs',
+          items: [{ autogenerate: { directory: 'docs/reference/blobs' } }]
+        },
+        {
+          label: 'Custom Metrics',
+          items: [{ autogenerate: { directory: 'docs/reference/custom-metrics' } }]
+        },
+        {
+          label: 'Functions',
+          items: [{ autogenerate: { directory: 'docs/reference/functions' } }]
+        },
+      ],
+      plugins: [starlightLlmsTxt()],
+    }),
+  ],
+  vite: {
+    server: {
+      proxy: {
+        '/api': 'http://127.0.0.1:8080',
+        '/metric.json': 'http://127.0.0.1:8080',
+        '/.well-known': 'http://127.0.0.1:8080',
+      },
+    },
+  },
+});