# BUG-004 — Final UI, Font Awesome & Platform Consistency Audit

Act as Senior Frontend Engineer, Senior UI/UX Designer, Senior PHP Engineer, and Senior QA Engineer.

This release is BUG-004.

Objective:

Perform the final UI consistency, icon standardization, frontend audit, and interaction polish before the platform enters Feature Development (RC-017).

This is NOT a feature release.

Do NOT add new modules.

Do NOT redesign the application.

Do NOT change business logic.

Only fix inconsistencies, missing assets, layout issues, responsiveness, icons, and frontend behavior.

====================================================
PART A
Font Awesome Audit
====================================================

Perform a FULL PROJECT audit.

Search the entire project for:

- inline SVG
- Heroicons
- Lucide
- Feather
- custom SVG paths
- emoji icons
- missing icons
- broken icons
- deprecated FA classes

Replace everything with ONE standard:

Font Awesome Free 6.4.x

Only ONE icon library may exist.

Verify:

Admin

Couple

Crew

Landing

Invitation

Guest

Wedding Day

Settings

Error Pages

Components

Modals

Tables

Dropdowns

Forms

Pagination

====================================================
PART B
Font Awesome Loader
====================================================

Verify every layout.

There must only be ONE Font Awesome loader.

Do not mix versions.

Do not duplicate CSS includes.

Verify:

layouts/admin.php

layouts/couple.php

layouts/crew.php

layouts/public.php

layouts/auth.php

====================================================
PART C
Icon Consistency
====================================================

Review every page.

Buttons

Menus

Cards

Inputs

Tables

Badges

Alerts

Dropdowns

Breadcrumbs

Action buttons

Status indicators

Every icon should match the same visual language.

No oversized icons.

No tiny icons.

No inconsistent spacing.

====================================================
PART D
Scanner Audit
====================================================

Review Wedding Day Scanner completely.

Verify:

html5-qrcode loads correctly

local library path

camera detection

desktop webcam

multiple webcams

camera selector

mobile rear camera

permission handling

loading state

retry state

success state

failure state

scanner close

scanner reopen

If no camera exists,

show friendly message.

No JavaScript exceptions.

====================================================
PART E
Invitation Preview
====================================================

Verify:

Desktop Preview

90–95% width

Browser chrome

Proper scaling

Tablet Preview

Large preview

Centered

Browser chrome

Mobile Preview

Phone simulator

Correct scaling

Verify Zoom

50%

75%

100%

125%

No clipping.

No overflow.

====================================================
PART F
Visual Consistency
====================================================

Audit:

Spacing

Margins

Padding

Typography

Cards

Buttons

Tables

Badges

Forms

Dialogs

Sidebar

Header

Footer

Empty State

Loading State

Hover State

Focus State

Everything must follow the Design System.

====================================================
PART G
Color Audit
====================================================

Verify the requested palette.

White

↓

Sky Blue

↓

Soft Blue

↓

Lavender

↓

Soft Pink

Remove harsh gradients.

Remove purple-heavy gradients.

Buttons should never bleed color outside rounded corners.

====================================================
PART H
Responsive Audit
====================================================

Verify:

Desktop

Laptop

Tablet

Mobile

Review:

Landing

Admin

Couple

Crew

Invitation

Guest

Scanner

Workspace

Settings

No overlap.

No clipping.

No broken flex/grid.

====================================================
PART I
Frontend Console Audit
====================================================

Verify browser console.

No:

JavaScript errors

Missing assets

404 resources

Undefined variables

Duplicate CSS

Duplicate JS

Broken imports

====================================================
PART J
PHP Audit
====================================================

Run syntax verification.

Every modified file:

php -l

Zero syntax errors.

====================================================
PART K
Final QA Checklist
====================================================

Verify:

✓ Font Awesome loads everywhere

✓ No SVG remains

✓ Scanner works

✓ Preview works

✓ Icons consistent

✓ Responsive verified

✓ No layout regression

✓ No console errors

✓ No PHP syntax errors

====================================================
Deliverables
====================================================

Provide a complete walkthrough.

Include:

1. Files Modified

2. Icon Audit Summary

3. Scanner Verification

4. Responsive Verification

5. Browser Verification

6. PHP Syntax Results

7. Console Verification

8. Final UI Improvements

====================================================
IMPORTANT
====================================================

This is the FINAL stabilization release.

Do NOT add features.

Do NOT modify database schema.

Do NOT modify routes unnecessarily.

Do NOT change business logic.

Only polish, stabilize, and standardize.

After BUG-004, stop and wait for approval before starting RC-017 (Budget Planner).