Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

Version: 1.0.0
Last Updated: 2026-02-09
Status: Active Purpose: Document in-scope routes and patterns for accessibility audits (e.g. axe-core, jest-axe, manual a11y checks).

​
Hub Pages (In Scope)

Tabbed hub pages are in scope for accessibility audits. These include:
ModuleRouteTabs
HR Recruiting/hr/atsDashboard, Postings, Applications, Candidates, Interviews, Offers
HR Credentialing/hr/credentialingDashboard, Report, Analytics, Renewals, My Credentials
HR Workforce Analytics/hr/analyticsDashboard, Trends, Retention Risk, Cost Analysis, Reports
HR Clinical Oversight/hr/oversightRelationships, Sessions, Compliance, Reports
When running axe or similar tools, include these routes (with at least one ?tab= variant per hub) to verify tab panels, focus management, and keyboard navigation. See UI/UX Standards § Tabbed Hub Accessibility Checklist.

​
Running Audits

​
Manual Audits

  1. Open the target hub route in Chrome DevTools (e.g. /hr/ats?tab=applications).
  2. Run Lighthouse → Accessibility audit and verify score ≥ 90.
  3. Alternatively, install the axe DevTools browser extension and run a scan on each hub route.
  4. Verify keyboard navigation: Tab through all triggers, confirm focus ring visibility, confirm Enter/Space activates tabs.

​
Automated Audits (Optional)

​
jest-axe (Unit/Integration)

Create __tests__/accessibility/hub-pages.test.tsx: 
import { render } from '@testing-library/react';
import { axe, toHaveNoViolations } from 'jest-axe';

expect.extend(toHaveNoViolations);

// Wrap component in required providers (router, query client, etc.)
import { TestProviders } from '@/test-utils/providers';

describe('Hub Page Accessibility', () => {
  it('CredentialingHubPage has no a11y violations', async () => {
    const { default: CredentialingHubPage } = await import(
      '@/cores/hr/pages/CredentialingHubPage'
    );

    const { container } = render(
      <TestProviders>
        <CredentialingHubPage />
      </TestProviders>
    );

    const results = await axe(container);
    expect(results).toHaveNoViolations();
  });
});

​
Playwright-axe (E2E)

Create e2e/accessibility/hub-pages.spec.ts: 
import AxeBuilder from '@axe-core/playwright';
import { expect, test } from '@playwright/test';

const hubRoutes = [
  { route: '/hr/ats?tab=dashboard', name: 'ATS Hub' },
  { route: '/hr/credentialing?tab=dashboard', name: 'Credentialing Hub' },
  { route: '/hr/analytics?tab=dashboard', name: 'Workforce Analytics Hub' },
  { route: '/hr/oversight?tab=relationships', name: 'Oversight Hub' },
];

for (const { route, name } of hubRoutes) {
  test(`${name} (${route}) has no a11y violations`, async ({ page }) => {
    await page.goto(route);
    await page.waitForLoadState('networkidle');

    const results = await new AxeBuilder({ page }).analyze();

    expect(results.violations).toEqual([]);
  });
}