8000 Replace Fractal as a component development and documentation tool · Issue #3263 · uswds/uswds · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

Replace Fractal as a component development and documentation tool #3263

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
thisisdano opened this issue Dec 17, 2019 · 8 comments
Closed

Replace Fractal as a component development and documentation tool #3263

thisisdano opened this issue Dec 17, 2019 · 8 comments
Assignees
@mejiaj
Labels
Context: JavaScript Issue is in JavaScript Context: Sass Issue is in Sass

Comments

@thisisdano
Copy link
Contributor

Fractal is no longer a reliable tool for developing and documenting our components. It introduces a number of vulnerabilities into our dependencies and is no longer reliably maintained. Newer tools like Storybook or PatternLab could be a better forward-looking solution. We need to understand the pros and cons of possible solutions, and how any documentation and development solution we implement could be useful to other teams, in addition to our own internal core team.
@thisisdano thisisdano added Affects: Compiling Related to compiling Sass or JavaScript needs: feedback labels Dec 17, 2019
@thisisdano thisisdano added this to the February 2020 Monthly Call milestone Dec 17, 2019
@stphnwlkr
Copy link

I like Storybook. Nice listing of a variety of tools available at https://designsystemsrepo.com/tools/. Some not appropriate for this project, but it give you a good idea of what is out there.

@DanielMiller-agile6
Copy link

I really like Storybook as well. It supports most of the popular frontend JS frameworks now. Although in my experience, not all framework support is as mature as React... things seems to be improving quickly though so I might be wrong about this now :)

There's also a @storybook/html package which helps for developers who don't use any framework, and just want to use storybook as a CSS framework development tool or for a UI pattern library.

A few months ago, the Storybook team released a "Design Systems for Developers" book online which was really helpful to me. While the title seems fairly generic, most of the book is an explanation of using Storybook for design systems and component libraries. Most of the examples in the book use React, but it could still be helpful for users of other frameworks.

@chazchumley
Copy link

Pattern Lab node version with NPM and Gulp would be great for non-REACT sites. Plus I am willing to help build that out :) It would then allow for govt sites and there heavy adoption of Drupal.

@thisisdano thisisdano added epic and removed epic labels Jan 9, 2020
@afeijoo
Copy link
Contributor
afeijoo commented Mar 20, 2020

Customer feedback: "I cannot scroll up and down on the left pane in Chrome on Windows 10, only in IE on Windows 10 (I cannot even use page up or page down) on https://components.designsystem.digital.gov/."

This was referenced Apr 2, 2020
Closed
Closed
Closed
@thisisdano thisisdano added Affects: Documentation Relates to documentation. Should this be in uswds-site? and removed topic: documentation labels Feb 25, 2021
@thisisdano thisisdano added affects: component library Context: JavaScript Issue is in JavaScript Context: Sass Issue is in Sass and removed topic: product Affects: Compiling Related to compiling Sass or JavaScript Affects: Documentation Relates to documentation. Should this be in uswds-site? labels Feb 25, 2021
@maya
Copy link
Contributor
maya commented May 6, 2021

Storybook has a twig option with storybook-twig (@mejiaj mentioned this was a reason why PL was chosen). Storybook seems to be the superior UI library tool today.

@mejiaj
Copy link
Contributor
mejiaj commented May 7, 2021

Is storybook-twig still under active development? Only release was in May 2019. But I agree, storybook is interesting and it'd be worth another look.

@maya
Copy link
Contributor
maya commented May 8, 2021

You could probably base something off of that work, and update all the dependencies and maintain it yourself. Doesn’t seem like a whole lot there. Storybook is very well maintained.

@mejiaj
Copy link
Contributor
mejiaj commented Apr 16, 2022

Completed with final phase of migration #4511.

@mejiaj mejiaj closed this as completed Apr 16, 2022
@thisisdano thisisdano removed this from the 2021: Library migration milestone May 9, 2022
@dhcole dhcole mentioned this issue Jun 22, 2023
Merged
@namanaman namanaman mentioned this issue Jun 22, 2023
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@mejiaj mejiaj

Labels
Context: JavaScript Issue is in JavaScript Context: Sass Issue is in Sass
Projects
USWDS Core Project Data
Archived in project
Milestone
No milestone
Development

No branches or pull requests
9 participants
@afeijoo @chazchumley @stphnwlkr @mejiaj @maya @thisisdano @DanielMiller-agile6 @jAigret-Bix @brunerae
0