Build a new component

Check that it does not already exist

Your component could already exist or be in the process of development.

Check existing components and the backlog for any research or work on a similar component.

Share your proposal

Email your initial proposal to [email protected], addressing how it is useful and unique and including any early wireframes or mockups.

This will help the Design System team support your process and connect your work with relevant teams across NSW Government by:

• Creating opportunities for continual feedback and support as you build your component.
• Connecting you with teams that can share findings and research to assist with the development of the component.
• Ensuring the Design System team can track that the component is being worked on to reduce duplication of effort.

Build the component

Our design system has been purpose-built with styles and functionality that is distinctly NSW. Following these will ensure you meet the required design standards and maintain a high level of accessibility required for all NSW digital products and services.

How to build your component:

• Ensure the component meets the contribution criteria
• Use our design system styles (colour, grid, typography etc)
• Use and modify existing components where possible (also available as a Figma UI Kit)
• Utilise existing design tokens and helper classes.
• Follow the css code style

Share progress

As you create the component, share progress and developments with the Design System team, including research, design decisions and use cases.

This may be in the form of a code snippet, screenshots, sketch/figma files or written text on your research with references. This gives the Design System team a chance to respond and connect you with community members who may have worked on a similar component.

Get ready to go live

As you finalise your component, we'll work with you to review and build it into the design system. If your contribution is successful, it will become part of a backlog of components we are developing to support teams making services across NSW.