--- title: "Lint rules" sidebarTitle: "Lint rules" description: "Every lint finding code with its severity, what it catches, and how to fix it." --- `hyperframes lint`, `hyperframes check` and the `@hyperframes/lint` package report findings with a stable code. This page lists every code with its severity, what it catches, and how to fix it. The codes come straight from the rule set in `packages/lint/src/rules/` plus the project-level probes that run as part of a project lint. Severities: - **Error** — the composition is broken or the render will fail or visibly diverge. Fails `hyperframes check` by default. - **Warning** — a quality, determinism or maintainability hazard. Does not fail `hyperframes check` unless you pass `--strict`; in `render`, warnings abort only under `--strict-all`. - **Info** — a heads-up that needs no action. Shown by `hyperframes lint --verbose`. Looking for a code from a render or check log? Codes appear in the output of `npx hyperframes lint [dir]` — add `--json` to script over them. `check` additionally runs runtime, layout and motion audits beyond these lint rules; see [Troubleshooting](/help). ## Structure and timeline Source: `packages/lint/src/rules/structure.ts`. The five codes marked **Warning or error** are warnings when the CLI lints a project, and errors when the browser editor lints the file it is editing. ### `nested_structure_needs_subcomposition` **Warning or error.** A top-level timeline element contains another nested structure instead of a sub-composition mount. The timeline draws one row per top-level element, and the root composition is built only from sub-compositions. **Fix:** Move the element and its contents into a sub-composition file and mount it with `data-composition-src`. ### `timeline_element_missing_timing` **Warning or error.** A timeline element has no `data-duration`, so the timeline cannot draw where it ends. **Fix:** Add `data-duration` (in seconds) to the element. ### `caption_track_kind_missing` **Warning or error.** An element looks like a caption row but is not marked as one, so the timeline cannot group it on the caption track. **Fix:** Add `data-track-kind="captions"` to the element. ### `multiple_caption_tracks` **Warning or error.** Captions are spread across several timeline tracks instead of one caption lane. **Fix:** Give every caption element the same `data-track-index`. ### `multiple_scene_templates` **Warning.** A file has more than one `