For Developers

Using Canvas

Welcome to Workday Canvas! If you’re just starting out developing with Canvas, follow the guide below to get up and running.

The primary way you will interact with Canvas will be with our Canvas Kit React library. Canvas Kit provides a set of components and primitives that can be used to implement user experiences consistent with the rest of Workday.

Canvas Kit

Installation

To get started using Canvas Kit React first add or install the module to your existing React project.

> yarn add @workday/canvas-kit-react

Usage

import React from 'react';
import {PrimaryButton} from '@workday/canvas-kit-react/button';
import {HStack} from '@workday/canvas-kit-react/layout';
import {
plusIcon,
relatedActionsVerticalIcon,
caretDownIcon,
} from '@workday/canvas-system-icons-web';
export default () => (
<HStack spacing="s" padding="s">
<PrimaryButton>Primary</PrimaryButton>
<PrimaryButton icon={plusIcon} iconPosition="start">
Primary
</PrimaryButton>
<PrimaryButton icon={caretDownIcon} iconPosition="end">
Primary
</PrimaryButton>
<PrimaryButton icon={relatedActionsVerticalIcon} />
</HStack>
);

For more information on how to use Canvas Kit components, check out their documentation in the Components section.

Resources

For more documentation, helpful links and other developer resources, check out the Resources page.

Reporting a Bug

If you spot a bug, inconsistency, or typo, please open a bug issue. Better yet, submit a pull request to addresses it.

Feature Requests

If you have an idea, we would love to hear about it. The best way to suggest a feature is to open a feature issue. The Canvas Kit core team will take a look and discuss it with you.

Questions

If you have a question, we are here to help! Submit a questions/help ticket or start a new discussion to be connected to one of our team members.

Alternatively, reach out to the Canvas Kit core team on the #canvas-kit channel on Slack.

Contributing

Want to contribute to Canvas Kit? Please read our contributing guidelines to find out more and how to get started.

Versioning

Canvas Kit follows semantic versioning and is enforced automatically by conventional commits (see "Commit Message Format").

Can't Find What You Need?

Check out our FAQ section which may help you find the information you're looking for.

FAQ Section