okok Issue Type Test Matrix

This page provides links to test pages for all issue types detected by okok.now monitoring service, including both active detection and future planned checks.

Quick Stats:

Total Issue Types with Detection: 38
Future Detection (Planned): 7 checks
SEO & Metadata: 9 issues
Open Graph: 3 issues
Accessibility: 2 issues
Technical: 4 issues
Links & Navigation: 4 issues
Configuration: 2 issues
International SEO (Hreflang): 11 issues
Performance: 1 issue

📊 SEO & Metadata Issues (9)

Issue Type	Severity	Test Page
`missing_title`	Warning	Visit Page
`missing_description`	Warning	Visit Page
`missing_canonical`	Warning	Visit Page
`canonical_relative_url`	Warning	Visit Page
`missing_h1`	Warning	Visit Page
`multiple_h1`	Warning	Visit Page
`noindex_page`	Critical / Warning	Visit Page
`robots_blocked`	Critical / Warning	Visit Page
`not_in_sitemap`	Warning	Visit Page

📱 Open Graph / Social Media Issues (3)

Issue Type	Severity	Test Page
`missing_og_title`	Warning	Visit Page (tests all 3)
`missing_og_description`	Warning
`missing_og_image`	Warning

♿ Accessibility Issues (2)

Issue Type	Severity	Test Page
`images_without_alt`	Warning	Visit Page
`poor_accessibility`	Warning	Visit Page

🔧 Technical / Availability Issues (4)

Issue Type	Severity	Test Page
`page_error`	Critical / Warning	Visit Page
`crawl_failed`	Warning	Visit Page API endpoint (204) - valid 2xx but no content
`sitemap_unavailable_url`	Critical / Warning	Visit Page (404) Listed in sitemap.xml but doesn't exist
`api_error_500`	Critical	Visit API Endpoint API route that returns 500 error

🔗 Link & Navigation Issues (4)

Issue Type	Severity	Test Page
`dead_link_internal`	Warning	Visit Page (tests both)
`dead_link_external`	Warning	Visit Page (tests both)
`redirect_loop`	Warning	Visit Page A Redirects to Page B, which redirects back to Page A
`orphaned_page`	Warning	In sitemap but has no internal links

🧪 Regression Tests

Test Case	Expected Behavior	Test Page
Non-HTTP(S) Protocol Links	Should NOT be crawled	Visit Page (mailto, tel, javascript, etc.) Issue #53: Prevents protocol links from being crawled as relative URLs
robots.txt Compliance	Internal: setting-dependent (respectRobotsTxt). External: not applicable — all external links are validated.	Dead Links page Tests internal robots.txt crawl rules (respectRobotsTxt=true)

⚙️ Configuration Issues (2)

Issue Type	Severity	Notes
`sitemap_error`	Warning	Not actively triggered - sitemap.xml is valid Check sitemap.xml \| robots.txt
`sitemap_cross_domain_url`	Warning	Cross-domain URLs in sitemap.xml Sitemap includes 3 URLs from different domains (example.com, staging subdomain, google.com)

🌍 International SEO / Hreflang Issues (11)

Issue Type	Severity	Test Page
`hreflang_invalid`	Warning	Invalid language/region codes (en-UK, eu, US-en)
`hreflang_relative_url`	Warning	Relative URLs instead of absolute
`hreflang_missing_reciprocal`	Warning	Missing bidirectional links (shoes product cluster)
`hreflang_missing_self_reference`	Warning	Page doesn't reference itself
`hreflang_canonical_conflict`	Warning	Target's canonical conflicts with hreflang
`hreflang_target_non_200`	Warning	Target returns 404/redirect (non-200 status)
`hreflang_target_noindex`	Warning	Target has noindex directive
`hreflang_target_robots_blocked`	Warning	Target blocked by robots.txt
`hreflang_incomplete_cluster`	Warning	Not all pages list all cluster members
`hreflang_wrong_page_mapping`	Warning	Incorrect page-to-page mapping (shoes→homepage)

⚡ Performance Issues (1)

Issue Type	Threshold	Test Page
`slow_page`	CWV thresholds	LCP \| CLS \| TBT

🔮 Future Detection - Planned Checks (7)

Note: The following checks are defined in the checklist but detection logic has not yet been implemented. Test pages are provided to support future development.

Check / Issue Type	Category	Test Page
`hreflang`	International	Correct (EN) \| Correct (FR) \| Missing
`locale`	International	Invalid Locale
`mobile-friendly` (viewport)	UX	Missing Viewport
`no-console-errors`	Technical	Console Errors
`asset-caching`	Performance	Cache Tests
`favicon`	UX	Favicon present (app/icon.svg) - site-wide check
`no-dev-remnants`	Technical	No test page needed - detects localhost URLs in content

📝 Testing Notes

All pages are intentionally designed with specific issues for testing
Some issues (like page_error) may only be detected during automated crawling
External link checking requires the checkBrokenLinks option to be enabled
Performance metrics are measured using Core Web Vitals during crawl
The homepage (/) is a properly configured baseline page for comparison

🚀 How to Test

Start the mock app: turbo dev --filter=mock
Access at: http://localhost:3030
Configure your crawler to monitor http://localhost:3030
Run a crawl and verify all expected issues are detected