Bixal / uswds-page-templates

Page templates for the U.S. Web Design System
https://bixal.github.io/uswds-page-templates/
Other
7 stars 2 forks source link

Create a standalone Figma file for USWDS page templates #30

Closed pglevy closed 3 years ago

pglevy commented 3 years ago

What it should have:

What we want to be able to do with it:

kbchumley commented 3 years ago

https://www.figma.com/file/QVPduB8h6DIENYULFVCism/USWDS-Page-Templates?node-id=5%3A0

bnaolu commented 3 years ago

Guide for publishing to the Figma community, version control, and accepting updates.

From our recent conversations with @kbchumley and through additional research, seems like we won't be able to automatically get updates from the Truss Library until further notice from Figma themselves. As Truss publishes new updates, we'll have to continue to duplicate their files for the most current version. This applies to our own community files when they get published to the Figma community.

Screen Shot 2021-07-14 at 9 13 49 AM

Publishing our local components and variations to a library

Once our local components are published, it will be usable across Bixal HCD.

NOTE: Since local components are our own, anyone in HCD Bixal using our component library will be able to manage updates as we make changes. Anyone who is 'Duplicating' our files from the Figma Community will NOT receive these updates. As stated previously, they will have to reduplicate the file.

  1. Create local components
  2. Publish local components
  3. Toggle new component library on

Screen Recording 2021-07-14 at 2 02 49 PM

Publishing files to the Figma Community

Our files can also be published to the entire Figma community.

  1. Create a file (can be a mix of libraries, wireframes, templates, etc.)
  2. Publish to the Figma Community through the 'Share' button

Screen Recording 2021-07-14 at 2 03 03 PM

Publishing new changes and viewing version history

Any changes added to the file can be published and will be made available in the current version. Past versions can be viewed or restored by clicking on the filename drop down arrow.

Screen Recording 2021-07-14 at 3 29 16 PM

Review and accept updates from libraries

Screen Shot 2021-07-14 at 3 49 12 PM

bnaolu commented 3 years ago

What we can do:

bnaolu commented 3 years ago

@pglevy, would like your review on these two pages I added to the USWDS Page Templates file in Figma:

bnaolu commented 3 years ago

Figma Community and Duplicate files

The purpose of Figma Community files

Screen shot explaining the purpose of Figma Community files

What's a Duplicate file?

Screen shot of Figma's Duplicate files

Can we add the USWDS duplicate file to our local file and will this be updated?

Yes, but we wouldn’t be able to add any of their updated duplicate file as a 'page' in our local file for future progress.

Best solution (for now)?

I think it's best to stick to what we're doing now: a single version of the USWDS components (currently 2.12) and linking our page template to this (externally). By adding any future updated duplicates from Truss will involve tedious relinking of components.

bnaolu commented 3 years ago

Finished relinking templates (except Teams page; need to fix the bug in GH) in Figma. Please take a look and review, @pglevy and @kbchumley 😊

pglevy commented 3 years ago

Working out of this file now.