Skip to content

XboxDevCom/agencies

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DACH Agency Directory

Eine barrierefreie und übersichtliche Tabelle von Creator-Agenturen im DACH-Raum (Deutschland, Österreich, Schweiz). Diese Anwendung bietet eine einfache und zugängliche Möglichkeit, Agenturen nach verschiedenen Kriterien zu filtern und zu sortieren.

♿ Barrierefreiheit (Accessibility)

Diese Anwendung wurde nach den WCAG 2.1 AA Standards entwickelt und bietet:

🎯 Kernfeatures für Barrierefreiheit

  • Vollständige Keyboard-Navigation - Alle Funktionen sind ohne Maus bedienbar
  • Screen Reader Unterstützung - Optimiert für NVDA, JAWS, VoiceOver und andere
  • Hoher Farbkontrast - Mindestens 4.5:1 Kontrastverhältnis für bessere Lesbarkeit
  • Responsive Design - Funktioniert auf allen Geräten und Bildschirmgrößen
  • Focus Management - Klare visuelle Fokusindikatoren
  • ARIA Landmarks - Strukturierte Navigation für assistive Technologien
  • Live Regions - Dynamische Inhaltsänderungen werden angekündigt
  • Skip Links - Schnelle Navigation zu Hauptinhalten

⌨️ Keyboard-Shortcuts

  • Tab / Shift+Tab - Navigation zwischen Elementen
  • Enter / Space - Aktivierung von Buttons und Links
  • Arrow Keys - Navigation in Tabellen und Listen
  • Escape - Schließen von Modals und Dropdowns
  • Home / End - Sprung zum ersten/letzten Element

🔧 Accessibility Testing

# Automatisierte Accessibility-Tests ausführen
npm run test:a11y

# ESLint Accessibility-Regeln prüfen
npm run lint:a11y

# Vollständiges Accessibility-Audit
npm run audit:a11y

Features

  • Übersichtliche Darstellung von Creator-Agenturen im DACH-Raum
  • Erweiterte Filterung nach:
    • Agentur-Name (Volltext-Suche)
    • Fokus-Bereich
    • Plattformen
    • Referenzen
    • Status
    • Preismodell
    • Mindest-Follower-Anzahl
  • Sortierung nach allen Spalten
  • Responsive Design für Desktop, Tablet und Mobile
  • Modal-Details für detaillierte Agentur-Informationen
  • Export-Funktionalität (geplant)

Daten

Die Agentur-Daten werden aus einer CSV-Datei geladen und enthalten Informationen zu:

  • Agentur-Name und Website
  • Fokus-Bereiche und Spezialisierungen
  • Unterstützte Social Media Plattformen
  • Bekannte Referenzen und Kunden
  • Geschäftsbedingungen
  • Follower-Reichweite
  • Status (aktiv/inaktiv)
  • Rechtsform und Standort
  • Gründungsjahr
  • Abteilungen
  • Zusätzliche Notizen

Technologien

  • React 18 mit TypeScript
  • Tailwind CSS für Styling
  • PapaParse für CSV-Verarbeitung
  • React Helmet Async für SEO
  • Axe-core für Accessibility-Testing
  • ESLint jsx-a11y für Accessibility-Linting

Installation

# Dependencies installieren
npm install

# Entwicklungsserver starten
npm start

# Für Produktion bauen
npm run build

# Tests ausführen
npm test

# Accessibility-Tests
npm run test:a11y

Entwicklung

Code-Qualität

# TypeScript-Typen prüfen
npm run type-check

# ESLint ausführen
npm run lint

# ESLint mit Accessibility-Regeln
npm run lint:a11y

Performance-Analyse

# Bundle-Größe analysieren
npm run analyze

Testing

# Unit Tests
npm test

# Test Coverage
npm run test:coverage

# Accessibility Tests
npm run test:a11y

Deployment

Die Anwendung wird automatisch auf GitHub Pages deployed: https://xboxdevcom.github.io/agencys/

Build-Prozess

  1. TypeScript Kompilierung
  2. Tailwind CSS Optimierung
  3. Bundle Minimierung
  4. Accessibility-Validierung
  5. Deployment zu GitHub Pages

Browser-Unterstützung

  • Modern Browsers: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
  • Screen Readers: NVDA, JAWS, VoiceOver, Dragon NaturallySpeaking
  • Mobile: iOS Safari, Chrome Mobile, Samsung Internet

Accessibility-Standards

Diese Anwendung erfüllt:

  • WCAG 2.1 Level A - Grundlegende Barrierefreiheit
  • WCAG 2.1 Level AA - Erweiterte Barrierefreiheit
  • Section 508 - US-Bundesstandards
  • EN 301 549 - Europäische Standards

Getestete assistive Technologien

  • NVDA (Windows)
  • JAWS (Windows)
  • VoiceOver (macOS/iOS)
  • TalkBack (Android)
  • Dragon NaturallySpeaking (Sprachsteuerung)

Beitragen

Beim Beitragen zu diesem Projekt beachte bitte:

  1. Accessibility First - Alle neuen Features müssen barrierefrei sein
  2. Testing - Führe Accessibility-Tests vor Pull Requests aus
  3. Documentation - Dokumentiere Accessibility-Features
  4. Code Review - Accessibility wird in Code Reviews geprüft

Accessibility-Checklist für Contributors

  • Keyboard-Navigation funktioniert
  • Screen Reader-Tests durchgeführt
  • Farbkontrast geprüft (min. 4.5:1)
  • ARIA-Attribute korrekt verwendet
  • Focus Management implementiert
  • Automatisierte Tests bestanden

Lizenz

MIT License - siehe LICENSE für Details.

Support

Bei Accessibility-Problemen oder Fragen:


Hinweis: Diese Anwendung wird kontinuierlich auf Barrierefreiheit getestet und verbessert. Feedback von Nutzern assistiver Technologien ist sehr willkommen!

About

DACH Agency Directory

Resources

Stars

Watchers

Forks

Packages

No packages published