Bug Report Template
Copy the template below for every new bug. Then look at the 2 filled examples.
| Field | Value |
|---|---|
| Bug ID | BUG-001 |
| Title | [Where]: [What happens] [When/How] |
| Reported by | Your name |
| Date | YYYY-MM-DD |
| Environment | Browser/OS/Device/App version/Build |
| Severity | Critical / Major / Minor / Trivial |
| Priority | High / Medium / Low |
| Preconditions | State before the steps begin |
| Steps to Reproduce | 1. ... 2. ... 3. ... |
| Expected Result | What should happen |
| Actual Result | What really happens |
| Reproducible | Always / Sometimes / Once |
| Attachments | Screenshots, video, logs |
| Notes | Extra info, workaround, related bugs |
| Field | Value |
|---|---|
| Bug ID | BUG-114 |
| Title | Profile page: app crashes when saving a name longer than 50 characters |
| Reported by | A. Tester |
| Date | 2026-09-01 |
| Environment | Chrome 126 / Windows 11 / staging / build 2.4.1 |
| Severity | Major |
| Priority | High |
| Preconditions | User is logged in (user@test.com). User is on the Profile page. |
| Steps to Reproduce | 1. Go to https://app.example.com/profile 2. Click "Edit" 3. In the "Name" field, enter 51 characters, e.g. "Aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" 4. Click "Save" |
| Expected Result | Name is saved and shown on the profile page, OR a clear validation message "Name must be 50 characters or less" is shown. |
| Actual Result | The page goes white and the app stops working. Browser console shows Uncaught RangeError: Invalid string length. User must reload the page. The name is not saved. |
| Reproducible | Always (5/5 tries) |
| Attachments | crash-video.mp4, console-log.txt |
| Notes | Works fine with exactly 50 characters. Fails from 51. |
| Field | Value |
|---|---|
| Bug ID | BUG-121 |
| Title | Mobile: "Buy now" button is cut off on the product page on small screens |
| Reported by | A. Tester |
| Date | 2026-09-02 |
| Environment | Safari / iPhone SE (iOS 17) / production / app version 5.1.0 |
| Severity | Minor |
| Priority | Medium |
| Preconditions | User is on any product page, e.g. https://shop.example.com/product/123 |
| Steps to Reproduce | 1. Open https://shop.example.com/product/123 on an iPhone SE (or Chrome DevTools with iPhone SE size) 2. Scroll to the "Buy now" button |
| Expected Result | The full "Buy now" button is visible and clickable. |
| Actual Result | The right side of the button is cut off by the screen edge. Only "Buy n" is visible. The button still works if tapped. |
| Reproducible | Always on screens ≤ 375px wide. Not reproducible on larger screens. |
| Attachments | screenshot-iphone-se.png |
| Notes | Also reproducible on Android with the same screen width — looks like a CSS issue, not device-specific. |
💡 Tip: The "Notes" field is a good place for helpful details — like "works fine on desktop" or "started in build 2.4.0". These hints help the developer find the cause faster.