feat(a11y): add accessible Skip to Content link

- Added `SkipLink` component that is visible on focus.
- Updated `App.tsx` to include `SkipLink` and wrap content in `<main id="main-content">`.
- Added translation keys for skip link in English and German.
- Added unit tests for `SkipLink`.

This improves accessibility for keyboard and screen reader users by allowing them to bypass the navigation menu.

Co-authored-by: ragusa-it <196988693+ragusa-it@users.noreply.github.com>

src/App.tsx

@@ -19,14 +19,16 @@ export function App() {
         <ScrollToTop />
         <FancyCursor />
         <Navbar />
-        {/* Suspense handles the loading state for lazy-loaded routes */}
+        <main id="main-content" tabIndex={-1} style={{ flex: 1, outline: 'none' }}>
-        <Suspense fallback={<PageLoader />}>
+          {/* Suspense handles the loading state for lazy-loaded routes */}
-          <Routes>
+          <Suspense fallback={<PageLoader />}>
-            <Route path="/" element={<Home />} />
+            <Routes>
-            <Route path="/about" element={<About />} />
+              <Route path="/" element={<Home />} />
-            <Route path="/contact" element={<Contact />} />
+              <Route path="/about" element={<About />} />
-          </Routes>
+              <Route path="/contact" element={<Contact />} />
-        </Suspense>
+            </Routes>
+          </Suspense>
+        </main>
         <Footer />
       </BrowserRouter>
     </LanguageProvider>

src/components/ui/SkipLink.module.css

@@ -1,26 +1,20 @@
 .skipLink {
-  position: fixed;
+  position: absolute;
-  top: 0;
+  top: 1rem;
-  left: 50%;
+  left: 1rem;
-  z-index: 1000;
+  z-index: 100;
-  transform: translateY(-100%) translateX(-50%);
+  padding: 0.75rem 1.25rem;
-  padding: var(--space-sm) var(--space-md);
+  background-color: var(--md-sys-color-primary);
-  background-color: var(--md-sys-color-primary-container);
+  color: var(--md-sys-color-on-primary);
-  color: var(--md-sys-color-on-primary-container);
-  font-family: var(--md-sys-typescale-body-font);
   font-weight: 600;
+  border-radius: var(--radius-md);
   text-decoration: none;
-  border-radius: 0 0 var(--radius-md) var(--radius-md);
+  transform: translateY(-200%);
-  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.2);
+  transition: transform var(--transition-normal);
-  transition: transform var(--transition-fast);
+  outline: none;
-  opacity: 0;
+  box-shadow: var(--md-sys-color-shadow) 0px 4px 8px 3px;
-  pointer-events: none;
 }
 
 .skipLink:focus {
-  transform: translateY(0) translateX(-50%);
+  transform: translateY(0);
-  opacity: 1;
-  pointer-events: auto;
-  outline: 2px solid var(--md-sys-color-primary);
-  outline-offset: 2px;
 }

src/components/ui/SkipLink.tsx

@@ -6,7 +6,7 @@ export function SkipLink() {
 
   return (
     <a href="#main-content" className={styles.skipLink}>
-      {t.nav.skipToContent}
+      {t.nav.skipLink}
     </a>
   );
 }

src/components/ui/__tests__/SkipLink.test.tsx

@@ -0,0 +1,33 @@
+// @vitest-environment jsdom
+import { render, screen, cleanup } from '@testing-library/react';
+import { describe, it, expect, afterEach } from 'vitest';
+import { SkipLink } from '../SkipLink';
+import { LanguageProvider } from '../../../i18n';
+
+describe('SkipLink', () => {
+  afterEach(() => {
+    cleanup();
+  });
+
+  const renderWithProviders = (component: React.ReactNode) => {
+    return render(
+      <LanguageProvider>
+        {component}
+      </LanguageProvider>
+    );
+  };
+
+  it('renders correctly with correct href', () => {
+    renderWithProviders(<SkipLink />);
+    const link = screen.getByRole('link');
+    expect(link).toBeTruthy();
+    expect(link.getAttribute('href')).toBe('#main-content');
+  });
+
+  it('renders translated text', () => {
+    renderWithProviders(<SkipLink />);
+    const link = screen.getByRole('link');
+    const text = link.textContent;
+    expect(text === 'Zum Inhalt springen' || text === 'Skip to content').toBe(true);
+  });
+});

src/i18n/de.ts

@@ -1,7 +1,7 @@
 export const de = {
   // Navigation
   nav: {
-    skipToContent: 'Zum Hauptinhalt springen',
+    skipLink: 'Zum Inhalt springen',
     home: 'Startseite',
     about: 'Über uns',
     contact: 'Kontakt',

src/i18n/en.ts

@@ -3,7 +3,7 @@ import type { Translations } from './de';
 export const en: Translations = {
   // Navigation
   nav: {
-    skipToContent: 'Skip to main content',
+    skipLink: 'Skip to content',
     home: 'Home',
     about: 'About',
     contact: 'Contact',

src/pages/About.tsx

@@ -46,7 +46,7 @@ export function About() {
   const location = useLocation();
 
   return (
-    <main id="main-content" tabIndex={-1} className={styles.about} key={location.key}>
+    <main className={styles.about} key={location.key}>
       {/* Hero Section */}
       <section className={styles.hero}>
         <div className="container">

src/pages/Contact.tsx

@@ -133,7 +133,7 @@ export function Contact() {
   };
 
   return (
-    <main id="main-content" tabIndex={-1} className={styles.contact}>
+    <main className={styles.contact}>
       {/* Hero */}
       <section className={styles.hero}>
         <div className="container">

src/pages/Home.tsx

@@ -2,7 +2,7 @@ import { Hero, Services } from '../components/sections';
 
 export function Home() {
   return (
-    <main id="main-content" tabIndex={-1}>
+    <main>
       <Hero />
       <Services />
     </main>