DiscoveryVIP / HTML & CSS AcademyHelp

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>

Open related lesson

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">

Open related lesson

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>

Open related lesson

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; }

Open related lesson

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; }

Open related lesson

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; }

Open related lesson

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)); }

Open related lesson

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.

Open related lesson

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; }

Open related lesson

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}}

Open related lesson

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}

Open related lesson

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.

Open related lesson

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.

Open related lesson

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

Open related lesson

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"

Open related lesson

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.

Open related lesson

Prevention: retain a regression check, validate local paths and record tested browser/input conditions.