Skip to main content
← 🎨 CSS as a design systemΒ·Module B6 Β· Lesson 13
πŸ” Step 1 Β· Repro the bugReproduce: build a .card div containing an <h3> and a <p>. The card must have width: 280px, padding: 16px, and a border. The <p> must contain a long unbreakable token (a URL like 'https://example.com/very-long-pathname-that-keeps-going-and-going-with-no-breaks'). When rendered, the URL will overflow the card β€” that's the bug we'll fix in step 2.

Repro the bug report: long URLs blowing out a card

150 XP12 minStep 1 of 2 Β· Repro

Bug report

Mobile users report: 'The whole page scrolls sideways. I see a long URL sticking out of the card and the rest of the screen is cut off.' Screen recordings show a single product card with a URL in the description; on iPhone 13 the card is wider than the viewport and the page scrolls horizontally. Your job: build the SMALLEST HTML + CSS that triggers the same visual bug. Don't fix anything yet β€” just make it happen.

Theory

Reading a bug report like an engineer

When you're new, "the layout is broken" feels overwhelming. Senior engineers do something specific: they reproduce the bug locally first, in the smallest possible code, before touching the actual codebase. This is the single highest-leverage habit you can build.

This lesson teaches it in two steps.

Step 1 β€” reproduce. You're handed a real-shape bug report. Your job: write the smallest HTML + CSS that triggers the same visual problem. You're not fixing anything yet. You're making the bug *show up on your screen*.

Step 2 β€” fix. Once your repro shows the bug, you'll get the standard fix task and the broken starter the rest of the team is staring at. Now you fix it.

Why this order matters

  • If you can't repro, you can't verify a fix. You might "fix" something that wasn't broken and ship a bug that still exists.
  • Repro forces you to read the bug report carefully β€” what device, what content, what action. Junior devs skip this and start grep-ing the codebase blind.
  • The minimal repro often IS the bug. Once you have 20 lines of HTML that show it, the cause is usually staring at you.

The actual content rule today

A common bug pattern: a card layout that looks fine with short text breaks on the right edge when content has a long unbreakable token β€” a URL, a hash, a German compound word. Fixed-width cards leak; the container overflows the screen; a horizontal scrollbar appears on mobile.

The fix is one CSS property. But first β€” reproduce the bug.

πŸ”’

Sign up to start coding

Theory is open to everyone. The interactive editor, live preview, and check are unlocked with a 7-day free trial β€” card required, cancel anytime.

Sign up β€” free trial β†’

First 10 lessons in each track are free. No card needed for those.

← PreviousNext lesson β†’

Get one Python or web tip a day β€” by email

Short, hand-written, no spam. Unsubscribe in one click.