From 54ef384b53cfeaa1ca00794c74eb791ee32b547e Mon Sep 17 00:00:00 2001
From: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
Date: Fri, 16 Jan 2026 20:46:23 +0530
Subject: [PATCH 1/4] fix(quickstart): resolve WCAG accessibility violations

Signed-off-by: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
---
 .../components/QuickstartContent/QuickstartItem.tsx  | 12 ++++++------
 .../quickstart/src/components/QuickstartFooter.tsx   |  6 +++++-
 .../plugins/quickstart/src/translations/de.ts        |  1 +
 .../plugins/quickstart/src/translations/es.ts        |  1 +
 .../plugins/quickstart/src/translations/fr.ts        |  1 +
 .../plugins/quickstart/src/translations/it.ts        |  1 +
 .../plugins/quickstart/src/translations/ja.ts        |  1 +
 .../plugins/quickstart/src/translations/ref.ts       |  1 +
 8 files changed, 17 insertions(+), 7 deletions(-)

diff --git a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.tsx b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.tsx
index bbb031625e..4e37350f13 100644
--- a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.tsx
+++ b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.tsx
@@ -67,7 +67,10 @@ export const QuickstartItem = ({
   }, [stepCompleted, setProgress]);
 
   return (
-    <Box sx={{ marginBottom: theme => `${theme.spacing(0.2)}` }}>
+    <Box
+      component="li"
+      sx={{ marginBottom: theme => `${theme.spacing(0.2)}`, listStyle: 'none' }}
+    >
       <ListItem
         key={itemKey}
         onClick={handleOpen}
@@ -122,11 +125,8 @@ export const QuickstartItem = ({
           }}
         />
         <IconButton
-          aria-label={
-            open
-              ? t('item.collapseButtonAriaLabel')
-              : t('item.expandButtonAriaLabel')
-          }
+          aria-hidden="true"
+          tabIndex={-1}
           sx={{
             ...(open
               ? { color: theme => theme.palette.text.primary }
diff --git a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartFooter.tsx b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartFooter.tsx
index 24d0e94839..c9d6a69a26 100644
--- a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartFooter.tsx
+++ b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartFooter.tsx
@@ -33,7 +33,11 @@ export const QuickstartFooter = ({
 
   return (
     <Box>
-      <LinearProgress variant="determinate" value={progress} />
+      <LinearProgress
+        variant="determinate"
+        value={progress}
+        aria-label={t('footer.progressBarLabel')}
+      />
       <Box
         sx={{
           display: 'flex',
diff --git a/workspaces/quickstart/plugins/quickstart/src/translations/de.ts b/workspaces/quickstart/plugins/quickstart/src/translations/de.ts
index d75a580e58..9af775e552 100644
--- a/workspaces/quickstart/plugins/quickstart/src/translations/de.ts
+++ b/workspaces/quickstart/plugins/quickstart/src/translations/de.ts
@@ -61,6 +61,7 @@ const quickstartTranslationDe = createTranslationMessages({
     'footer.progress': '{{progress}}% Fortschritt',
     'footer.notStarted': 'Nicht begonnen',
     'footer.hide': 'Ausblenden',
+    'footer.progressBarLabel': 'Schnellstart-Fortschritt',
     'content.emptyState.title':
       'Schnellstart-Inhalte sind für Ihre Rolle nicht verfügbar.',
     'item.expandAriaLabel': '{{title}} Details erweitern',
diff --git a/workspaces/quickstart/plugins/quickstart/src/translations/es.ts b/workspaces/quickstart/plugins/quickstart/src/translations/es.ts
index d9a54a1091..12c650c6a3 100644
--- a/workspaces/quickstart/plugins/quickstart/src/translations/es.ts
+++ b/workspaces/quickstart/plugins/quickstart/src/translations/es.ts
@@ -61,6 +61,7 @@ const quickstartTranslationEs = createTranslationMessages({
     'footer.progress': '{{progress}}% de progreso',
     'footer.notStarted': 'No iniciado',
     'footer.hide': 'Ocultar',
+    'footer.progressBarLabel': 'Progreso de inicio rápido',
     'content.emptyState.title':
       'El contenido de inicio rápido no está disponible para tu rol.',
     'item.expandAriaLabel': 'Expandir detalles de {{title}}',
diff --git a/workspaces/quickstart/plugins/quickstart/src/translations/fr.ts b/workspaces/quickstart/plugins/quickstart/src/translations/fr.ts
index 0942a73495..6242268a64 100644
--- a/workspaces/quickstart/plugins/quickstart/src/translations/fr.ts
+++ b/workspaces/quickstart/plugins/quickstart/src/translations/fr.ts
@@ -66,6 +66,7 @@ const quickstartTranslationFr = createTranslationMessages({
     'footer.progress': '{{progress}}% de progrès',
     'footer.notStarted': 'Non démarré',
     'footer.hide': 'Cacher',
+    'footer.progressBarLabel': 'Progression du démarrage rapide',
     'content.emptyState.title':
       "Le contenu de démarrage rapide n'est pas disponible pour votre rôle.",
     'item.expandAriaLabel': 'Développer les détails de {{title}}',
diff --git a/workspaces/quickstart/plugins/quickstart/src/translations/it.ts b/workspaces/quickstart/plugins/quickstart/src/translations/it.ts
index e26448e4e6..6fa474be43 100644
--- a/workspaces/quickstart/plugins/quickstart/src/translations/it.ts
+++ b/workspaces/quickstart/plugins/quickstart/src/translations/it.ts
@@ -68,6 +68,7 @@ const quickstartTranslationIt = createTranslationMessages({
     'footer.progress': '{{progress}}% di avanzamento',
     'footer.notStarted': 'Non iniziato',
     'footer.hide': 'Nascondi',
+    'footer.progressBarLabel': "Avanzamento dell'avvio rapido",
     'content.emptyState.title':
       'Contenuto di avvio rapido non disponibile per il ruolo utente.',
     'item.expandAriaLabel': 'Espandi i dettagli di {{title}}',
diff --git a/workspaces/quickstart/plugins/quickstart/src/translations/ja.ts b/workspaces/quickstart/plugins/quickstart/src/translations/ja.ts
index a581cf5d05..fcf42c31ac 100644
--- a/workspaces/quickstart/plugins/quickstart/src/translations/ja.ts
+++ b/workspaces/quickstart/plugins/quickstart/src/translations/ja.ts
@@ -66,6 +66,7 @@ const quickstartTranslationJa = createTranslationMessages({
     'footer.progress': '進捗 {{progress}}%',
     'footer.notStarted': '開始されていません',
     'footer.hide': '非表示',
+    'footer.progressBarLabel': 'クイックスタートの進捗',
     'content.emptyState.title':
       '現在のロールではクイックスタートコンテンツを利用できません。',
     'item.expandAriaLabel': '{{title}} の詳細を展開',
diff --git a/workspaces/quickstart/plugins/quickstart/src/translations/ref.ts b/workspaces/quickstart/plugins/quickstart/src/translations/ref.ts
index ff7f7d1c84..3de0f00e75 100644
--- a/workspaces/quickstart/plugins/quickstart/src/translations/ref.ts
+++ b/workspaces/quickstart/plugins/quickstart/src/translations/ref.ts
@@ -86,6 +86,7 @@ export const quickstartMessages = {
     progress: '{{progress}}% progress',
     notStarted: 'Not started',
     hide: 'Hide',
+    progressBarLabel: 'Quickstart progress',
   },
   content: {
     emptyState: {

From 18d7531be09f5be65b54f619b437ea823c4799c6 Mon Sep 17 00:00:00 2001
From: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
Date: Fri, 16 Jan 2026 20:53:00 +0530
Subject: [PATCH 2/4] adding changeset

Signed-off-by: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
---
 workspaces/quickstart/.changeset/legal-times-remain.md | 9 +++++++++
 1 file changed, 9 insertions(+)
 create mode 100644 workspaces/quickstart/.changeset/legal-times-remain.md

diff --git a/workspaces/quickstart/.changeset/legal-times-remain.md b/workspaces/quickstart/.changeset/legal-times-remain.md
new file mode 100644
index 0000000000..ec2ce32680
--- /dev/null
+++ b/workspaces/quickstart/.changeset/legal-times-remain.md
@@ -0,0 +1,9 @@
+---
+'@red-hat-developer-hub/backstage-plugin-quickstart': patch
+---
+
+Fixed WCAG 2.1 AA accessibility violations:
+
+- Added accessible name to progress bar
+- Fixed invalid list structure (ul containing div elements)
+- Resolved nested interactive controls issue

From e826cdd75531d08e18f238f505c2b5d7637f4023 Mon Sep 17 00:00:00 2001
From: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
Date: Fri, 16 Jan 2026 20:54:43 +0530
Subject: [PATCH 3/4] updating the api report

Signed-off-by: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
---
 workspaces/quickstart/plugins/quickstart/report-alpha.api.md | 1 +
 workspaces/quickstart/plugins/quickstart/report.api.md       | 1 +
 2 files changed, 2 insertions(+)

diff --git a/workspaces/quickstart/plugins/quickstart/report-alpha.api.md b/workspaces/quickstart/plugins/quickstart/report-alpha.api.md
index a10a0017ab..8fb4da97de 100644
--- a/workspaces/quickstart/plugins/quickstart/report-alpha.api.md
+++ b/workspaces/quickstart/plugins/quickstart/report-alpha.api.md
@@ -17,6 +17,7 @@ export const quickstartTranslationRef: TranslationRef<
     readonly 'footer.progress': string;
     readonly 'footer.hide': string;
     readonly 'footer.notStarted': string;
+    readonly 'footer.progressBarLabel': string;
     readonly 'header.title': string;
     readonly 'header.subtitle': string;
     readonly 'content.emptyState.title': string;
diff --git a/workspaces/quickstart/plugins/quickstart/report.api.md b/workspaces/quickstart/plugins/quickstart/report.api.md
index a19fdb202d..0925aaab16 100644
--- a/workspaces/quickstart/plugins/quickstart/report.api.md
+++ b/workspaces/quickstart/plugins/quickstart/report.api.md
@@ -103,6 +103,7 @@ export const quickstartTranslationRef: TranslationRef<
     readonly 'footer.progress': string;
     readonly 'footer.hide': string;
     readonly 'footer.notStarted': string;
+    readonly 'footer.progressBarLabel': string;
     readonly 'header.title': string;
     readonly 'header.subtitle': string;
     readonly 'content.emptyState.title': string;

From 65f47b4102f4039320870728a40dd4892d7dffa2 Mon Sep 17 00:00:00 2001
From: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
Date: Fri, 16 Jan 2026 21:26:06 +0530
Subject: [PATCH 4/4] updating tests

Signed-off-by: its-mitesh-kumar <itsmiteshkumar98@gmail.com>
---
 .../plugins/quickstart/src/components/Quickstart.test.tsx     | 4 ++--
 .../components/QuickstartContent/QuickstartContent.test.tsx   | 4 ++--
 .../src/components/QuickstartContent/QuickstartItem.test.tsx  | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/workspaces/quickstart/plugins/quickstart/src/components/Quickstart.test.tsx b/workspaces/quickstart/plugins/quickstart/src/components/Quickstart.test.tsx
index 24aee88563..fd2a97e4e4 100644
--- a/workspaces/quickstart/plugins/quickstart/src/components/Quickstart.test.tsx
+++ b/workspaces/quickstart/plugins/quickstart/src/components/Quickstart.test.tsx
@@ -103,7 +103,7 @@ describe('Quickstart', () => {
 
       // Complete first admin item
       const expandButtons = screen.getAllByRole('button', {
-        name: /expand item/i,
+        name: /expand.*details/i,
       });
       fireEvent.click(expandButtons[0]);
 
@@ -131,7 +131,7 @@ describe('Quickstart', () => {
 
       // Complete first developer item
       const expandButtons = screen.getAllByRole('button', {
-        name: /expand item/i,
+        name: /expand.*details/i,
       });
       fireEvent.click(expandButtons[0]);
 
diff --git a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartContent.test.tsx b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartContent.test.tsx
index b0b26c4c1d..94097c956c 100644
--- a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartContent.test.tsx
+++ b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartContent.test.tsx
@@ -117,10 +117,10 @@ describe('QuickstartContent', () => {
     );
 
     const expandIcon1 = screen.getAllByRole('button', {
-      name: /expand item/i,
+      name: /expand.*details/i,
     })[0];
     const expandIcon2 = screen.getAllByRole('button', {
-      name: /expand item/i,
+      name: /expand.*details/i,
     })[1];
 
     fireEvent.click(expandIcon1);
diff --git a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.test.tsx b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.test.tsx
index f2bdfd65ec..c96b41513e 100644
--- a/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.test.tsx
+++ b/workspaces/quickstart/plugins/quickstart/src/components/QuickstartContent/QuickstartItem.test.tsx
@@ -77,10 +77,10 @@ describe('QuickstartItem)', () => {
     ).toBeInTheDocument();
   });
 
-  it('calls handleOpen when expand/collapse icon is clicked', async () => {
+  it('calls handleOpen when expand/collapse item is clicked', async () => {
     await renderItem(false);
     const toggleBtn = screen.getByRole('button', {
-      name: /expand item/i,
+      name: /expand.*details/i,
     });
     fireEvent.click(toggleBtn);
     expect(mockHandleOpen).toHaveBeenCalled();