Legacy Django static assets

This directory contains the CSS, SCSS and JavaScript used by server-rendered Django templates. The primary Next.js frontend has a separate build in frontend/.

CSS build

cd backend/static
npm install
npm run build

Available scripts from package.json:

  • build:bootstrap — compile scss/custom-bootstrap.scss;
  • build:app — compile scss/main.scss;
  • build / build:css — compile both outputs;
  • watch:bootstrap, watch:app, watch:css and dev — watch mode.

Generated outputs are css/bootstrap-custom.css and css/app.css. Source partials live below scss/; do not edit generated CSS when an SCSS source exists.

The legacy spacing scale currently maps Bootstrap utilities 1–5 to 4, 8, 12, 16 and 24 pixels. Treat scss/custom-bootstrap.scss and scss/main.scss as the source of truth because this area is still being migrated.

JavaScript

Reusable modules live in js/components/, chat orchestration in js/controllers/ and js/renderers/, and page entry points in js/pages/. The legacy chat pages use the same /ws/ contract as Next.js; see CHAT_MODULES.md.

Browser-oriented smoke pages and the available Node test are documented in js/tests/README.md.