feat(a11y): add Skip to Main Content link

- Added `SkipLink` component to `src/components/ui/SkipLink.tsx`
- Added translation keys to `src/i18n`
- Added `<SkipLink />` to `App.tsx`
- Added `id="main-content"` and `tabIndex={-1}` to page main containers
- Verified accessibility via Playwright test

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

src/App.tsx

@@ -3,7 +3,7 @@ import { BrowserRouter, Routes, Route } from 'react-router-dom';
 import { LanguageProvider } from './i18n';
 import { Navbar, Footer, FancyCursor, ScrollToTop } from './components/layout';
 import { Home } from './pages/Home';
-import { PageLoader } from './components/ui';
+import { PageLoader, SkipLink } from './components/ui';
 import './styles/global.css';
 
 // Lazy load pages to reduce initial bundle size.
@@ -15,6 +15,7 @@ export function App() {
   return (
     <LanguageProvider>
       <BrowserRouter>
+        <SkipLink />
         <ScrollToTop />
         <FancyCursor />
         <Navbar />

src/components/effects/GradientBlinds.tsx

@@ -65,8 +65,7 @@ const GradientBlinds: React.FC<GradientBlindsProps> = ({
   const rendererRef = useRef<Renderer | null>(null);
   const mouseTargetRef = useRef<[number, number]>([0, 0]);
   // Optimization: store raw pointer position (viewport coords) to decouple event handling from calculation
-  // Changed to a stable object to avoid GC pressure in high-frequency event handlers
-  const pointerPosRef = useRef<{ x: number; y: number; active: boolean }>({ x: 0, y: 0, active: false });
+  const pointerPosRef = useRef<{ x: number; y: number } | null>(null);
   const isMobileRef = useRef<boolean>(false);
   const lastTimeRef = useRef<number>(0);
   const firstResizeRef = useRef<boolean>(true);
@@ -305,8 +304,7 @@ void main() {
         const cx = gl.drawingBufferWidth / 2;
         const cy = gl.drawingBufferHeight / 2;
         uniforms.iMouse.value = [cx, cy];
-        mouseTargetRef.current[0] = cx;
-        mouseTargetRef.current[1] = cy;
+        mouseTargetRef.current = [cx, cy];
       }
     };
 
@@ -334,13 +332,10 @@ void main() {
           x = (e.clientX - rect.left) * scale;
           y = (rect.height - (e.clientY - rect.top)) * scale;
         }
-        mouseTargetRef.current[0] = x;
-        mouseTargetRef.current[1] = y;
-        pointerPosRef.current.active = false; // Ensure loop doesn't override
+        mouseTargetRef.current = [x, y];
+        pointerPosRef.current = null; // Ensure loop doesn't override
       } else {
-        pointerPosRef.current.x = e.clientX;
-        pointerPosRef.current.y = e.clientY;
-        pointerPosRef.current.active = true;
+        pointerPosRef.current = { x: e.clientX, y: e.clientY };
       }
     };
 
@@ -349,7 +344,7 @@ void main() {
       uniforms.iTime.value = t * 0.001;
 
       // Update target based on pointer position and scroll offset
-      if (pointerPosRef.current.active) {
+      if (pointerPosRef.current) {
         const scale = (renderer as unknown as { dpr?: number }).dpr || 1;
         let x, y;
 
@@ -366,8 +361,7 @@ void main() {
            x = (pointerPosRef.current.x - rect.left) * scale;
            y = (rect.height - (pointerPosRef.current.y - rect.top)) * scale;
         }
-        mouseTargetRef.current[0] = x;
-        mouseTargetRef.current[1] = y;
+        mouseTargetRef.current = [x, y];
       }
 
       if (mouseDampening > 0) {
@@ -382,13 +376,8 @@ void main() {
         cur[0] += (target[0] - cur[0]) * factor;
         cur[1] += (target[1] - cur[1]) * factor;
       } else {
-        if (pointerPosRef.current.active || isMobileRef.current) {
-          // In no-dampening mode, update values directly.
-          // We copy values instead of assigning the reference to avoid aliasing issues
-          // (where cur and target become the same array) if dampening is enabled later
-          // without re-creating uniforms (though currently effect deps handle that).
-          uniforms.iMouse.value[0] = mouseTargetRef.current[0];
-          uniforms.iMouse.value[1] = mouseTargetRef.current[1];
+        if (pointerPosRef.current || isMobileRef.current) {
+          uniforms.iMouse.value = mouseTargetRef.current;
         }
         lastTimeRef.current = t;
       }

src/components/ui/SkipLink.module.css

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

src/components/ui/SkipLink.tsx

@@ -0,0 +1,12 @@
+import { useTranslation } from '../../i18n';
+import styles from './SkipLink.module.css';
+
+export function SkipLink() {
+  const { t } = useTranslation();
+
+  return (
+    <a href="#main-content" className={styles.skipLink}>
+      {t.nav.skipToContent}
+    </a>
+  );
+}

src/components/ui/index.ts

@@ -2,3 +2,4 @@ export { Button } from './Button';
 export { Card } from './Card';
 export { Input, Textarea } from './Input';
 export { PageLoader } from './PageLoader';
+export { SkipLink } from './SkipLink';

src/i18n/de.ts

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

src/i18n/en.ts

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

src/pages/About.tsx

@@ -46,7 +46,7 @@ export function About() {
   const location = useLocation();
 
   return (
-    <main className={styles.about} key={location.key}>
+    <main id="main-content" tabIndex={-1} 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 className={styles.contact}>
+    <main id="main-content" tabIndex={-1} 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>
+    <main id="main-content" tabIndex={-1}>
       <Hero />
       <Services />
     </main>