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 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.
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.
- Getting Started for Designers
- Getting Started for Developers
- Confluence (for REI-internal processes and info): https://confluence.rei.com/display/TP/Cedar+Design+System
- Github repo: https://github.com/rei/rei-cedar
- Glossary of terms: https://confluence.rei.com/display/TP/Terminology
- Roadmap: https://confluence.rei.com/display/TP/Roadmap
- Slack channels
- Email firstname.lastname@example.org for any additional support or clarification on anything related to the design system
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 email@example.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 firstname.lastname@example.org to learn more about contribution opportunities.