Flashie

Verification Checklist

Use this checklist to verify that Flashie is correctly configured, deployed, and working as expected.

Firmware & Manifest Verification

1

Navigate to each project's manifest.json URL in your browser — it should render valid JSON

2

Verify all firmware file paths in manifests are relative (e.g. firmware/firmware.bin, not /projects/...)

3

Check that every firmware file URL returns a 200 status and downloads correctly

4

Confirm that all offsets use string format with double quotes (e.g. "0x10000")

5

Verify that every manifest has at least one build entry with a valid chipFamily

GitHub Pages Deployment

1

Run npm run build — verify it completes with no errors and outputs to the out/ directory

2

Check that out/ contains all project manifest.json files in the correct paths

3

Verify that out/index.html loads correctly when opened locally

4

If using a basePath, verify that all asset URLs include the prefix

5

Confirm trailingSlash: true produces correct paths (e.g. /docs/ instead of /docs)

Browser Compatibility

1

Open the site in Google Chrome — the Flash Firmware buttons should be visible and clickable

2

Open the site in Microsoft Edge — same behavior as Chrome

3

Open the site in Firefox or Safari — verify the 'Browser not supported' message appears on flash buttons

4

Access the site via HTTPS (or localhost) — verify the HTTPS required message does not appear

5

Access the site via HTTP (non-localhost) — verify the HTTPS required message appears

Flashing Flow

1

Click a Flash Firmware button — verify the browser prompts for serial port selection

2

Connect a supported board — verify the flashing process starts and completes

3

Test with no board connected — verify a helpful error message appears

4

Test with an invalid manifest URL — verify the button is disabled with a tooltip

5

Verify that the serial port dialog can be cancelled gracefully

Responsive Design

1

Test at 1920x1080 — cards should display in 3-column grid

2

Test at 768px width — cards should display in 2-column grid

3

Test at 375px width — cards should display in single column

4

Verify the header navigation wraps correctly on small screens

5

Verify the footer columns stack vertically on mobile

Search & Filtering

1

Type a project name in the search bar — matching projects should appear

2

Type a partial match — projects containing the text should appear

3

Click a tag filter button — only projects with that tag should display

4

Click multiple tags — projects matching any tag should display

5

Click 'Clear all' — all filters should reset and show all projects

Manual Testing Required

Some checks on this page require manual verification — especially those involving browser serial port access, physical hardware, and live deployment URLs. Run through each checklist item after deploying to confirm everything works correctly in production.