UAE Design System 3.0 — Clarification on the React package (@aegov/design-system-react)

[usman7g]

Hi,

We note that the core @aegov/design-system package has been released at version 3.0 and is built on Tailwind CSS 4, while the installation documentation for @aegov/design-system-react specifies Tailwind CSS 3.4, and the React repository does not currently show any published releases.

Our questions are as follows:

1. Is the React package planned to be updated to align with Design System 3.0 and Tailwind CSS 4, and if so, is there an indicative timeline?

2. Is a React-based implementation fully supported for the purposes of the Design System compliance assessment?

3. Where the React package is not yet at parity with version 3.0, would it be acceptable to implement components in React using the core @aegov/design-system package directly, provided visual and behavioural parity with the published components and WCAG 2.2 conformance are maintained?

4. Is there any recommended guidance for teams building React or Next.js projects on the Design System?

Your confirmation will help us define the correct technical approach and ensure the delivered website meets the Design System criteria in full.

Thank you for your time, and for the continued work on the Design System.

[moiz-conceptlz]

Hello @usman7g,

Let me help you - but first clarify.

1. Design System V4.x is due for release soon.
2. Beta testing package for the new React version is possible through application.

Now to help you with the questions.

1. Is the React package planned to be updated to align with Design System 3.0 and Tailwind CSS 4 - Yes
2. Is there an indicative timeline? - Yes, aim is Oct 2026 as a public release.
3. Is a React-based implementation fully supported for the purposes of the Design System compliance assessment? - At this moment not, compliance only looks at the underlying generated HTML. However, moving forward, the use of components in React will also be required to follow the attributes defined. If anyone wants to create further components utilising base components, they are free to do so.
4. Is there any recommended guidance for teams building React or Next.js projects on the Design System? - A new documentation on use will also be released in Oct 2026. On a general note, the design system cares about the consistency in components' look, implementation of accessibility standards, speed, responsive behaviour for mobile use and a clear though process on user experience.