User Interface Guidelines?

S1mon

It would be great if Onshape would publish a set of User Interface Guidelines like other mature platforms. I find myself often thinking I should try to emulate first party features with things that I'm developing, but then I wonder how much of some of them are legacy results of adding functionality and not wanting to break things.

For example: "Keep tool bodies" in a bunch of features. Would this have really been worded and defaulted this way if it was there from day 1?

S1mon

Somewhat related…

Is there a standard set of guidelines for custom feature .SVG Icons? There seems to be some variation between the first party icons and what we can do with custom ones, especially when it comes to dark mode.

Is this AI analysis of the tokens below correct?

—

For the small 20x20 Onshape-style feature icon:

• stroke: #333333
• stroke width: 1 px
• line join: miter
• line cap: square

Gray fills:

• dark gray: #999999
• light gray: #D7D7D7
• white: #FFFFFF

That maps cleanly to the Onshape tokens:

• outline: var(--os-icon-outline-primary--static, #333333)
• secondary fill: var(--os-icon-fill-secondary--static, #999999)
• quaternary fill: var(--os-icon-fill-quaternary--static, #D7D7D7)
• primary fill: var(--os-icon-fill-primary--static, #FFFFFF)

Practical advice in Inkscape:

• work on a 20 x 20 canvas
• keep all strokes centered
• avoid fractional stroke widths
• prefer flat polygonal fills over gradients
• don’t use opacity effects or blur
• if two filled regions meet, let the stroke define the seam rather than adding extra gap lines

—

I think there's some variety in stroke width. Certainly in custom FS icons. Any comments?