Files
dawnline/rules/frontend.md
T
Aemeath 2388603322
Build packages / CI (push) Blocked by required conditions
Build packages / Version (push) Waiting to run
CI / Web (format, types, tests, bundles) (push) Blocked by required conditions
CI / ShellCheck (push) Blocked by required conditions
CI / ucode static checks (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 24.10) (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 25.12) (push) Blocked by required conditions
Dawnline 0.16.0
- The personal page loads faster and costs the router less: its script
  and styles come compressed, stay in the browser until the next update,
  and the icon comes with the page instead of a request of its own
- The page uses the system's own font (SF Pro on Apple devices, Segoe UI
  on Windows, Roboto on Android) instead of downloading one
- The top of the page shows the server's name alone, so it fits on a
  phone
- Text can be selected only where it is there to be copied (addresses,
  file names, the configuration), with the name field's own selection:
  a soft highlight with handles that glides after the pointer
- Sheets scroll without a scrollbar
- Red buttons (Remove) light up under the pointer, as the others do
- Demo: "Demo" and GitHub are one button; on a phone it floats at the
  bottom of the screen, and switching scenarios no longer makes the
  edge fades jump
2026-10-24 21:33:48 +03:00

1.9 KiB

Frontend (TypeScript: admin UI and portal)

Read with code-standards.md and, for anything visible, ui-design.md and i18n.md (every visible string goes through _()). Portal work starts with DESIGN.md (its tokens, components and motion).

Code

  • Strict TS, no any without a comment; types for RPC answers live in shared/types.ts / admin/api.ts and mirror the backend's shapes.
  • Layout of web/src/admin: ui/ generic components (button, menu, modal, drawer, tooltip, toast, controls), widgets/ composite house widgets, state/ polling and scoping, events/ the activity vocabulary (model without DOM, render separate), updater/ the Components data layer, cores/ per-protocol bits, pages/<page>/ one folder per page split by section, styles/*.css one file per feature joined in styles/index.ts. Shared with the portal: src/shared/.
  • Pages build from ui/ and widgets/; a page never defines a generic component. Logic that does not touch the DOM (formatting, models, CSV, sorting) lives outside the render code and gets tests.

Live data

  • Admin pages use createPoller (state/poller.ts): newest answer wins, no repaint of a region that holds focus, every RPC failure shows a toast or an inline error, never a blank section.
  • Changes reach open pages through the revision (state/live.ts): one small rev call every 2 s while the page is visible; pollers that opt in (live: true) refresh when it moves. Their own every stays as a slow fallback.
  • The portal does not poll (each request is a CGI process on the router, see backend.md): it loads once, after the visitor's own changes, and while it waits for a new device's first connection.

Checks

  • In web/: npm run format:check, npm run typecheck, npm run lint, npm run knip, npm run i18n:check, npm test, npm run build; the catalogs are committed, the bundles under package/ are git-ignored (CI builds them before packaging).