Garden React Components

🌱 Garden is a design system for Zendesk

Garden React provides consistent behavior for Garden components. React components are maintained following a multi-package approach where components are packaged and published individually, but combined under this single repository. Components rely on Garden CSS for styling.

Installation

See the individual package README for the React component you would like to install.

Package	Version	Dependencies
@zendeskgarden/react-autocomplete
@zendeskgarden/react-avatars
@zendeskgarden/react-breadcrumbs
@zendeskgarden/react-buttons
@zendeskgarden/react-chrome
@zendeskgarden/react-dropdowns
@zendeskgarden/react-forms
@zendeskgarden/react-grid
@zendeskgarden/react-loaders
@zendeskgarden/react-modals
@zendeskgarden/react-notifications
@zendeskgarden/react-pagination
@zendeskgarden/react-ranges
@zendeskgarden/react-selection
@zendeskgarden/react-tabs
@zendeskgarden/react-tables
@zendeskgarden/react-tags
@zendeskgarden/react-theming
@zendeskgarden/react-tooltips
@zendeskgarden/react-typography
@zendeskgarden/react-utilities

Usage

Our packages are easily consumable with create-react-app and standard webpack configs. All packages follow a similar installation process. Below is an example of consuming our react-buttons package.

Install dependencies

# Install garden package
npm install @zendeskgarden/react-buttons

# Install peer dependencies
npm install styled-components @zendeskgarden/react-theming prop-types

Include global styling and ThemeProvider

import React, { Component } from 'react';
import { render } from 'react-dom';

/** Globally include scoped button styling */
import '@zendeskgarden/react-buttons/dist/styles.css';

/** Include a ThemeProvider at the root of your app */
import { ThemeProvider } from '@zendeskgarden/react-theming';

/** Consume throughout app */
import { Button } from '@zendeskgarden/react-buttons';

class App extends Component {
  render() {
    return (
      <ThemeProvider>
        <Button>Example Garden Button</Button>
      </ThemeProvider>
    );
  }
}

render(<App />, document.getElementById('root'));

Try out Garden React components in a mock product environment.

Contribution

Thanks for your interest in Garden! Community involvement helps make our design system fresh and tasty for everyone.

Got issues with what you find here? Please feel free to create an issue.

If you'd like to take a crack at making some changes, please follow our contributing documentation for details needed to submit a PR.

Community behavior is benevolently ruled by a code of conduct. Please participate accordingly.

License

Copyright 2019 Zendesk

Licensed under the Apache License, Version 2.0