As an Adopting Team

Adopting Cedar, Step-by-Step

The value of Cedar is realized when products ship features using parts from the system. The more Cedar is used, the better it will become, and will continue to grow and evolve with best practices and community contributions.

Teams adopt Cedar by developing a dependency on the system’s visual style and UI components, while dropping dependencies on redundant product-specific or external code for overlapping features.

Adoption Models

Adoption of Cedar will vary by product team, as defined by the stage of the product in its life cycle and availability in the roadmap.

Some teams take a ‘Big Bang’ approach to quickly replace existing visual style and UI components completely with Cedar features in a couple of successive sprints.

Other teams may take a more Incremental approach, gradually adopting features over time. For those teams, adoption can progress across the following steps:

Monitoring & Reporting

To measure business value, the Cedar team will be monitoring the adoption of Cedar components across the digital product portfolio. This may involve regular checks with individual teams every 1-2 months to review progress, address questions, share roadmaps, and look for opportunities to iteratively improve the system processes.

Planning Adoption

For initial adoption, consider beginning with work on a new feature, section or redesign. Cedar components can be added incrementally to specific features or sections of a page, until the whole application can be converted to Vue. Once familiar with the system, teams can then plan to address accrued technical and design debt (including migration of Cedar 1 components) in other product areas that are not under active development.

Resources

Contributions

The Cedar team welcomes contributions from the community. In 2018, the focus will be on establishing a workflow to accept contributions. If you are interested in being a pilot contributor, please reach out at in Slack at #cedar-design-system or email cedar@rei.com or talk to your manager. In 2019, the team aims to publish a validated contribution model for wider participation by the REI design and engineering community.

Request a Component

The Cedar team will evaluate all new requests for components, beginning with a discovery process that includes an audit of visual patterns and weighs factors such as reusability across the product ecosystem (ideally can be used by 3-5 teams), investment and maturity of the product, and team bandwidth. New feature and enhancement requests can be submitted via the Feature Request Form.

Report an Issue

The Cedar team is committed to maintaining consistent, quality components. If you encounter any defects in the Sketch UI Toolkit, Vue code, or on the documentation site, please submit a Bug Report Form and it will be added to the backlog. The team will address the bug as soon as possible, depending on the severity of the issue and sprint capacity. Please include as much relevant information as possible when submitting a bug report to help prioritize, including steps to reproduce, urgency, and impact. If you have a fix for the bug and would like to submit a PR for it, please reach out at in Slack at #cedar-design-system or email cedar@rei.com to learn more about contribution opportunities.