Corp/backend/static/README.md

38 lines
1.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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
```bash
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`](js/components/CHAT_MODULES.md).
Browser-oriented smoke pages and the available Node test are documented in
[`js/tests/README.md`](js/tests/README.md).