Access-Pro Customization Guide

SYSTEM451 โ€” How to customize your templates while keeping full WCAG 2.2 compliance.

1. Getting Started

Place all HTML files in the same folder. Open index.html in a browser โ€” all nav links will work automatically.

These templates use Tailwind CSS CDN โ€” no npm, no build step, no configuration needed.

Files included in your download:

  • โ€บindex.html โ€” Home page
  • โ€บabout.html โ€” About page
  • โ€บportfolio.html โ€” Portfolio / case studies
  • โ€บshop.html โ€” Shop / pricing page
  • โ€บservices.html โ€” Services page
  • โ€บcontact.html โ€” Contact page with validated form
  • โ€บaccessibility.html โ€” Accessibility statement
  • โ€บguide.html โ€” This customization guide

2. Changing Text

Text changes are the safest customization. Just keep these rules in mind:

โœ… Safe to change freely

All visible text content: headings, paragraphs, button labels, nav items, footer text, addresses, and contact details.

โš ๏ธ Change the text, not the tag

Heading tags (H1/H2/H3) โ€” only change the text inside them, never change the tag level or skip levels. H1 must appear exactly once per page.

โŒ Never remove

aria-label, aria-required, aria-describedby, aria-current, role attributes, and id attributes linked to ARIA. These are invisible to sighted users but critical for screen readers.

3. Changing Images

Content images (photos, products, screenshots)

Always add a descriptive alt attribute. Describe what is shown, not just the name. Example: alt="Screenshot of dashboard showing monthly revenue chart"

Decorative images (backgrounds, dividers)

Use an empty alt: alt="" โ€” this tells screen readers to ignore it.

Images of text

Avoid entirely. Use HTML text instead โ€” images of text cannot be zoomed accessibly.

Hero background images

These are decorative and use aria-hidden="true" in the HTML. Keep this attribute in place.

4. Changing Colors

Always verify contrast after any color change. Color is the highest-risk change for compliance.

Normal text (under 18pt)

โ‰ฅ 4.5 : 1 contrast ratio

Large text (โ‰ฅ 18pt or 14pt bold)

โ‰ฅ 3 : 1 contrast ratio

UI components & graphics

โ‰ฅ 3 : 1 contrast ratio

Free contrast checking tools:

5. Adding New Pages

  1. Copy an existing page (e.g. about.html) and rename it.
  2. Update the <title> tag in the <head> to reflect the new page name.
  3. Add the new page link to the buildNav section in every other page file.
  4. Update the breadcrumb text and aria-current="page" to match the new page.
  5. Ensure there is exactly one H1 on the new page.
  6. Add the new link to the footer's nav section on all pages.

6. What NOT to Do

Remove the skip link at the top of each page

Delete or override the focus ring CSS in the <style> block

Use color alone to convey information (e.g. "red = error")

Add auto-playing audio or video without user controls

Create links or buttons with no visible or aria-label text

Skip heading levels (e.g. H1 โ†’ H3, skipping H2)

Use placeholder text as the only label for form inputs

Add custom interactive elements without keyboard support and ARIA roles

7. Testing After Changes

โŒจ๏ธ Keyboard Test

Tab through every page. Every link and button must be reachable and show a visible focus indicator. Nothing should require a mouse.

๐Ÿ”Š Screen Reader Test

Use NVDA (Windows, free) or VoiceOver (Mac, built-in). Navigate each page without looking at the screen.

๐ŸŒŠ WAVE Audit

Install the WAVE browser extension. Run it on every page and aim for zero errors.

๐Ÿ” Zoom Test

Zoom to 200% in your browser. All content must remain readable and not overlap.

๐ŸŽจ Contrast Check

After any color change, paste your hex values into the WebAIM Contrast Checker.

๐Ÿ“ฑ Mobile Test

View each page on a real phone or use browser DevTools. All text must be readable, all buttons easily tappable (โ‰ฅ24px).

Skip the Learning Curve

Already have an existing website? The SYSTEM451 team will migrate your content into a fully compliant Access-Pro template โ€” branded, tested, and ready to launch. No compliance worries, no guesswork.

SYSTEM451 ยท Access-Pro Templates ยท hello@system451.com