Troubleshooting HTML, CSS and publishing
CSS is not applied
Likely cause: .card in HTML is misspelled.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.card { color:blue }Repair or investigation direction
<p class="card">A matching class.</p>
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Image does not display
Likely cause: The path, case or uploaded resource is wrong.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
<img src="wrong.png" alt="Study">
Repair or investigation direction
<img src="assets/landscape.svg" alt="Blue hills">
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Link does not work
Likely cause: The fragment or page does not exist.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
<a href="#missing">Details</a>
Repair or investigation direction
<a href="#details">Details</a><section id="details"><h2>Details</h2></section>
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Box is wider than expected
Likely cause: content-box adds padding/border outside width.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.card { width:240px; padding:24px; border:4px solid; }Repair or investigation direction
.card { box-sizing:border-box; width:240px; padding:24px; border:4px solid; }Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Horizontal scrolling
Likely cause: A rigid width or intrinsic content exceeds the viewport.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.layout { width:1200px; }Repair or investigation direction
.layout { max-width:100%; overflow-wrap:anywhere; }Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Flex alignment does not work
Likely cause: The element is not flex or has no extra space.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.layout { align-items:center; }Repair or investigation direction
.layout { display:flex; min-height:15rem; align-items:center; }Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Grid columns are incorrect
Likely cause: Fixed tracks or invalid syntax do not match available space.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.layout { grid-template-columns:400px 400px; }Repair or investigation direction
.layout { display:grid; grid-template-columns:repeat(2,minmax(0,1fr)); }Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
z-index does not work
Likely cause: An ancestor stacking context constrains the child.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.child { z-index:999999; }Repair or investigation direction
Inspect positioned/transformed ancestors and simplify the intended stacking context.
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Sticky does not stick
Likely cause: Missing inset, scroll space or an unexpected ancestor constraint.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.header { position:sticky; }Repair or investigation direction
.header { position:sticky; top:0; }Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Media query does not apply
Likely cause: The condition does not match the actual iframe viewport.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
@media(min-width:1700px){.layout{display:grid}}Repair or investigation direction
@media(min-width:700px){.layout{display:grid}}Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Animation does not start
Likely cause: Name mismatch, no duration, reduced-motion rule or unsupported conditions.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
.card { animation:missing 1s; }Repair or investigation direction
@keyframes reveal{from{opacity:0}to{opacity:1}} .card{animation:reveal 1s both}Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Form does not send email
Likely cause: No backend or configured delivery service exists.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
<form><input name="email"><button>Send</button></form>
Repair or investigation direction
Keep an honest local preview or implement and review an authorized backend.
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Mobile layout differs
Likely cause: Viewport, fonts, content and input conditions differ from the desktop test.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
meta viewport missing; fixed columns
Repair or investigation direction
Add viewport metadata and test content-driven mobile-first CSS on real target devices.
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Text is difficult to read
Likely cause: Tiny type, poor measure, low contrast or cramped leading.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
font-size:8px; line-height:.8
Repair or investigation direction
font-size:1rem; line-height:1.6; max-width:65ch
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Exported site loses styling
Likely cause: An absolute or wrong-case path does not match the exported folder.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
href="/my-local-folder/styles.css"
Repair or investigation direction
href="styles.css"
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.
Published updates do not appear
Likely cause: Wrong upload destination, file case, browser/server/CDN cache.
Investigate the active file, actual DOM, matching rules, computed values and viewport conditions. Reproduce one controlled change, apply a repair and verify the specific result plus a second case.
Broken or incomplete example
Old resources remain cached.
Repair or investigation direction
Verify the actual uploaded file, URL and cache layers, then restore a recovery copy if needed.
Prevention: retain a regression check, validate local paths and record tested browser/input conditions.